first commit

Author: Arxing

.gitignore

@@ -0,0 +1,14 @@
+# Files and directories created by pub
+.dart_tool/
+.packages
+# Remove the following pattern if you wish to check in your lock file
+pubspec.lock
+
+# Conventional directory for build outputs
+build/
+
+# Directory created by dartdoc
+doc/api/
+
+**.iml
+.idea/

CHANGELOG.md

@@ -0,0 +1,3 @@
+## 1.0.0
+
+- Initial version, created by Stagehand

LICENSE

@@ -0,0 +1,26 @@
+Copyright 2014, the Dart project 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.

README.md

@@ -0,0 +1,24 @@
+XArgs is a simple library to resolve command arguments
+
+## Usage
+
+A simple usage example:
+
+```dart
+import 'package:xargs/xargs.dart';
+
+main() {
+  String command = '1 2 3 4 -mode run --enable -who John Denis Peter';
+  List<String> argArray = command.split(RegExp('\\s+'));
+  XArgs xArgs = XArgs.of(argArray);
+  print(xArgs); // ["1","2","3","4",{"key":"mode","values":["run"]},{"key":"enable","values":[]},{"key":"who","values":["John","Denis","Peter"]}]
+  print(xArgs.valuesNoKey()); // [1, 2, 3, 4]
+  print(xArgs.valueNoKeyAt(0)); // 1
+  print(xArgs['mode']); // run
+  print(xArgs.hasKey('enable')); // true
+  print(xArgs['who']); // John
+  print(xArgs.firstValue('who')); // John
+  print(xArgs.values('who')); // [John, Denis, Peter]
+}
+
+```

analysis_options.yaml

@@ -0,0 +1,14 @@
+# Defines a default set of lint rules enforced for
+# projects at Google. For details and rationale,
+# see https://github.com/dart-lang/pedantic#enabled-lints.
+include: package:pedantic/analysis_options.yaml
+
+# For lint rules and documentation, see http://dart-lang.github.io/linter/lints.
+# Uncomment to specify additional rules.
+# linter:
+#   rules:
+#     - camel_case_types
+
+analyzer:
+#   exclude:
+#     - path/to/excluded/files/**

example/xargs_example.dart

@@ -0,0 +1,15 @@
+import 'package:xargs/xargs.dart';
+
+main() {
+  String command = '1 2 3 4 -mode run --enable -who John Denis Peter';
+  List<String> argArray = command.split(RegExp('\\s+'));
+  XArgs xArgs = XArgs.of(argArray);
+  print(xArgs); // ["1","2","3","4",{"key":"mode","values":["run"]},{"key":"enable","values":[]},{"key":"who","values":["John","Denis","Peter"]}]
+  print(xArgs.valuesNoKey()); // [1, 2, 3, 4]
+  print(xArgs.valueNoKeyAt(0)); // 1
+  print(xArgs['mode']); // run
+  print(xArgs.hasKey('enable')); // true
+  print(xArgs['who']); // John
+  print(xArgs.firstValue('who')); // John
+  print(xArgs.values('who')); // [John, Denis, Peter]
+}

lib/src/xargs_core.dart

@@ -0,0 +1,81 @@
+import 'dart:convert';
+
+RegExp _regExp = RegExp('^(-{1,2})(.+)\$');
+
+class XArgs {
+  List<_XArg> _args = [];
+
+  XArgs._();
+
+  XArgs.of(List<String> argArray) {
+    _args.clear();
+    for (var value in argArray) {
+      if (_regExp.hasMatch(value)) break;
+      _args.add(_XArg.ofSingleValue(value));
+    }
+
+    _XArg target;
+    for (var value in argArray) {
+      if (_regExp.hasMatch(value)) {
+        target = _XArg._();
+        target.key = (_regExp.allMatches(value).toList()[0]).group(2);
+        _args.add(target);
+      } else {
+        target?.values?.add(value);
+      }
+    }
+  }
+
+  bool hasKey(String key) => _args.any((arg) => arg.key == key);
+
+  List<String> values(String key) {
+    var found = _args.where((arg) => arg.key == key);
+    return found.isNotEmpty ? found.first.values : [];
+  }
+
+  List<String> valuesNoKey() {
+    return _args.where((arg) => arg.key.isEmpty).map((arg) => arg.values.single).toList();
+  }
+
+  String valueNoKeyAt(int index) {
+    var values = valuesNoKey();
+    return values.isEmpty || index > values.length ? null : values[index];
+  }
+
+  String firstValue(String key) {
+    var found = values(key);
+    return found.isNotEmpty ? found.first : null;
+  }
+
+  String operator [](String key) {
+    return firstValue(key);
+  }
+
+  @override
+  String toString() {
+    return jsonEncode(_args.map((o) => o.isSingleValue ? o.values.single : {'key': o.key, 'values': o.values}).toList());
+  }
+}
+
+class _XArg {
+  String key;
+  List<String> values = [];
+  bool get isSingleValue => values.isNotEmpty && key.isEmpty && values.length == 1;
+
+  _XArg._();
+
+  _XArg.ofKeyValues(List<String> elements) {
+    key = _regExp.allMatches(elements[0]).toList()[0].group(2);
+    values = elements.skip(1).toList();
+  }
+
+  _XArg.ofSingleValue(String value) {
+    key = '';
+    values.add(value);
+  }
+
+  @override
+  String toString() {
+    return 'Arg{key: $key, values: $values}';
+  }
+}

lib/xargs.dart

@@ -0,0 +1,3 @@
+library xargs;
+
+export 'src/xargs_core.dart';

pubspec.yaml

@@ -0,0 +1,15 @@
+name: xargs
+description: XArgs is a simple library to resolve command arguments
+version: 1.0.0
+homepage: https://github.com/Arxing/dart-xargs
+author: Arxing <[email protected]>
+
+environment:
+  sdk: '>=2.4.0 <3.0.0'
+
+#dependencies:
+#  path: ^1.6.0
+
+dev_dependencies:
+  pedantic: ^1.7.0
+  test: ^1.6.0

test/xargs_test.dart

@@ -0,0 +1,4 @@
+
+void main() {
+
+}