Add mDNS client

.cirrus.yml

@@ -10,8 +10,12 @@ task:
     - git fetch origin master
   activate_script: pub global activate flutter_plugin_tools
   matrix:
+    - name: analyze
+      script: ./script/incremental_build.sh analyze
     - name: publishable
       script: ./script/check_publish.sh
+      depends_on:
+        - analyze
     - name: test+format
       install_script:
         - wget -O - https://apt.llvm.org/llvm-snapshot.gpg.key | sudo apt-key add -
@@ -20,8 +24,8 @@ task:
         - sudo apt-get install -y --allow-unauthenticated clang-format-5.0
       format_script: ./script/incremental_build.sh format --travis --clang-format=clang-format-5.0
       test_script: ./script/incremental_build.sh test
-    - name: analyze
-      script: ./script/incremental_build.sh analyze
+      depends_on:
+        - analyze
     - name: build-apks+java-test
       env:
         matrix:
@@ -30,6 +34,8 @@ task:
       script:
         - ./script/incremental_build.sh build-examples --apk
         - ./script/incremental_build.sh java-test  # must come after apk build
+      depends_on:
+        - analyze
 
 task:
   use_compute_credits: $CIRRUS_USER_COLLABORATOR == 'true'

.gitignore

@@ -3,6 +3,8 @@
 .idea
 .packages
 .pub/
+.dart_tool/
+
 pubspec.lock
 
 Podfile.lock

packages/multicast_dns/CHANGELOG.md

@@ -0,0 +1,5 @@
+## 0.1.0
+
+* Initial Open Source release.
+* Migrates the dartino-sdk's mDNS client to Dart 2.0 and Flutter's analysis rules
+* Breaks from original Dartino code, as it does not use native libraries for macOS and overhauls the `ResourceRecord` class.

packages/multicast_dns/LICENSE

@@ -0,0 +1,27 @@
+Copyright 2019 The Flutter Authors. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+    * Redistributions of source code must retain the above copyright
+      notice, this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above
+      copyright notice, this list of conditions and the following
+      disclaimer in the documentation and/or other materials provided
+      with the distribution.
+    * Neither the name of Google Inc. nor the names of its
+      contributors may be used to endorse or promote products derived
+      from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

packages/multicast_dns/README.md

@@ -0,0 +1,21 @@
+# Multicast DNS package
+
+[![pub package](https://img.shields.io/pub/v/multicast_dns.svg)](
+https://pub.dartlang.org/packages/multicast_dns)
+
+A Dart package to do service discovery over multicast DNS (mDNS), Bonjour, and Avahi.
+
+## Usage
+To use this package, add `multicast_dns` as a
+[dependency in your pubspec.yaml file](https://flutter.io/platform-plugins/).
+
+## Example
+
+Import the library via
+``` dart
+import 'package:multicast_dns/mdns_client.dart';
+```
+
+Then use the `MDnsClient` Dart class in your code. To see how this is done,
+check out the [example app](example/main.dart) or the sample implementations in
+the [bin](bin/) directory.

packages/multicast_dns/example/main.dart

@@ -0,0 +1,37 @@
+// Copyright 2018, the Flutter project authors. Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+// Example script to illustrate how to use the mdns package to discover the port
+// of a Dart observatory over mDNS.
+
+import 'package:multicast_dns/multicast_dns.dart';
+
+void main() async {
+  // Parse the command line arguments.
+
+  const String name = '_dartobservatory._tcp.local';
+  final MDnsClient client = MDnsClient();
+  // Start the client with default options.
+  await client.start();
+
+  // Get the PTR recod for the service.
+  await for (PtrResourceRecord ptr in client
+      .lookup<PtrResourceRecord>(ResourceRecordQuery.serverPointer(name))) {
+    // Use the domainName from the PTR record to get the SRV record,
+    // which will have the port and local hostname.
+    // Note that duplicate messages may come through, especially if any
+    // other mDNS queries are running elsewhere on the machine.
+    await for (SrvResourceRecord srv in client.lookup<SrvResourceRecord>(
+        ResourceRecordQuery.service(ptr.domainName))) {
+      // Domain name will be something like "[email protected]._dartobservatory._tcp.local"
+      final String bundleId =
+          ptr.domainName; //.substring(0, ptr.domainName.indexOf('@'));
+      print('Dart observatory instance found at '
+          '${srv.target}:${srv.port} for "$bundleId".');
+    }
+  }
+  client.stop();
+
+  print('Done.');
+}

packages/multicast_dns/example/mdns-resolve.dart

@@ -0,0 +1,34 @@
+// Copyright (c) 2015, the Dartino project authors. Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+// Example script to illustrate how to use the mdns package to lookup names
+// on the local network.
+
+import 'package:multicast_dns/multicast_dns.dart';
+
+void main(List<String> args) async {
+  if (args.length != 1) {
+    print('''
+Please provide an address as argument.
+
+For example:
+  dart mdns-resolve.dart dartino.local''');
+    return;
+  }
+
+  final String name = args[0];
+
+  final MDnsClient client = MDnsClient();
+  await client.start();
+  await for (IPAddressResourceRecord record in client
+      .lookup<IPAddressResourceRecord>(ResourceRecordQuery.addressIPv4(name))) {
+    print('Found address (${record.address}).');
+  }
+
+  await for (IPAddressResourceRecord record in client
+      .lookup<IPAddressResourceRecord>(ResourceRecordQuery.addressIPv6(name))) {
+    print('Found address (${record.address}).');
+  }
+  client.stop();
+}

packages/multicast_dns/example/mdns-sd.dart

@@ -0,0 +1,61 @@
+// Copyright (c) 2015, the Dartino project authors. Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+// Example script to illustrate how to use the mdns package to discover services
+// on the local network.
+
+import 'package:multicast_dns/multicast_dns.dart';
+
+void main(List<String> args) async {
+  if (args.isEmpty) {
+    print('''
+Please provide the name of a service as argument.
+
+For example:
+  dart mdns-sd.dart [--verbose] _workstation._tcp.local''');
+    return;
+  }
+
+  final bool verbose = args.contains('--verbose') || args.contains('-v');
+  final String name = args.last;
+  final MDnsClient client = MDnsClient();
+  await client.start();
+
+  await for (PtrResourceRecord ptr in client
+      .lookup<PtrResourceRecord>(ResourceRecordQuery.serverPointer(name))) {
+    if (verbose) {
+      print(ptr);
+    }
+    await for (SrvResourceRecord srv in client.lookup<SrvResourceRecord>(
+        ResourceRecordQuery.service(ptr.domainName))) {
+      if (verbose) {
+        print(srv);
+      }
+      if (verbose) {
+        await client
+            .lookup<TxtResourceRecord>(ResourceRecordQuery.text(ptr.domainName))
+            .forEach(print);
+      }
+      await for (IPAddressResourceRecord ip
+          in client.lookup<IPAddressResourceRecord>(
+              ResourceRecordQuery.addressIPv4(srv.target))) {
+        if (verbose) {
+          print(ip);
+        }
+        print('Service instance found at '
+            '${srv.target}:${srv.port} with ${ip.address}.');
+      }
+      await for (IPAddressResourceRecord ip
+          in client.lookup<IPAddressResourceRecord>(
+              ResourceRecordQuery.addressIPv6(srv.target))) {
+        if (verbose) {
+          print(ip);
+        }
+        print('Service instance found at '
+            '${srv.target}:${srv.port} with ${ip.address}.');
+      }
+    }
+  }
+  client.stop();
+}