// Copyright (c) 2012, the Dart 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.
import 'package:args/args.dart';
import 'package:test/test.dart';
import 'test_utils.dart';
void main() {
group('ArgParser.addFlag()', () {
test('throws ArgumentError if the flag already exists', () {
var parser = ArgParser();
parser.addFlag('foo');
throwsIllegalArg(() => parser.addFlag('foo'));
});
test('throws ArgumentError if the option already exists', () {
var parser = ArgParser();
parser.addOption('foo');
throwsIllegalArg(() => parser.addFlag('foo'));
});
test('throws ArgumentError if the abbreviation exists', () {
var parser = ArgParser();
parser.addFlag('foo', abbr: 'f');
throwsIllegalArg(() => parser.addFlag('flummox', abbr: 'f'));
});
test(
'throws ArgumentError if the abbreviation is longer '
'than one character', () {
var parser = ArgParser();
throwsIllegalArg(() => parser.addFlag('flummox', abbr: 'flu'));
});
test('throws ArgumentError if a flag name is invalid', () {
var parser = ArgParser();
for (var name in _invalidOptions) {
var reason = '${Error.safeToString(name)} is not valid';
throwsIllegalArg(() => parser.addFlag(name), reason: reason);
}
});
test('accepts valid flag names', () {
var parser = ArgParser();
for (var name in _validOptions) {
var reason = '${Error.safeToString(name)} is valid';
expect(() => parser.addFlag(name), returnsNormally, reason: reason);
}
});
});
group('ArgParser.addOption()', () {
test('throws ArgumentError if the flag already exists', () {
var parser = ArgParser();
parser.addFlag('foo');
throwsIllegalArg(() => parser.addOption('foo'));
});
test('throws ArgumentError if the option already exists', () {
var parser = ArgParser();
parser.addOption('foo');
throwsIllegalArg(() => parser.addOption('foo'));
});
test('throws ArgumentError if the abbreviation exists', () {
var parser = ArgParser();
parser.addFlag('foo', abbr: 'f');
throwsIllegalArg(() => parser.addOption('flummox', abbr: 'f'));
});
test(
'throws ArgumentError if the abbreviation is longer '
'than one character', () {
var parser = ArgParser();
throwsIllegalArg(() => parser.addOption('flummox', abbr: 'flu'));
});
test('throws ArgumentError if the abbreviation is empty', () {
var parser = ArgParser();
throwsIllegalArg(() => parser.addOption('flummox', abbr: ''));
});
test('throws ArgumentError if the abbreviation is an invalid value', () {
var parser = ArgParser();
for (var name in _invalidOptions) {
throwsIllegalArg(() => parser.addOption('flummox', abbr: name));
}
});
test('throws ArgumentError if the abbreviation is a dash', () {
var parser = ArgParser();
throwsIllegalArg(() => parser.addOption('flummox', abbr: '-'));
});
test('allows explict null value for "abbr"', () {
var parser = ArgParser();
expect(() => parser.addOption('flummox', abbr: null), returnsNormally);
});
test('throws ArgumentError if an option name is invalid', () {
var parser = ArgParser();
for (var name in _invalidOptions) {
var reason = '${Error.safeToString(name)} is not valid';
throwsIllegalArg(() => parser.addOption(name), reason: reason);
}
});
test('accepts valid option names', () {
var parser = ArgParser();
for (var name in _validOptions) {
var reason = '${Error.safeToString(name)} is valid';
expect(() => parser.addOption(name), returnsNormally, reason: reason);
}
});
});
group('ArgParser.getDefault()', () {
test('returns the default value for an option', () {
var parser = ArgParser();
parser.addOption('mode', defaultsTo: 'debug');
expect(parser.defaultFor('mode'), 'debug');
});
test('throws if the option is unknown', () {
var parser = ArgParser();
parser.addOption('mode', defaultsTo: 'debug');
throwsIllegalArg(() => parser.defaultFor('undefined'));
});
});
group('ArgParser.commands', () {
test('returns an empty map if there are no commands', () {
var parser = ArgParser();
expect(parser.commands, isEmpty);
});
test('returns the commands that were added', () {
var parser = ArgParser();
parser.addCommand('hide');
parser.addCommand('seek');
expect(parser.commands, hasLength(2));
expect(parser.commands['hide'], isNotNull);
expect(parser.commands['seek'], isNotNull);
});
test('iterates over the commands in the order they were added', () {
var parser = ArgParser();
parser.addCommand('a');
parser.addCommand('d');
parser.addCommand('b');
parser.addCommand('c');
expect(parser.commands.keys, equals(['a', 'd', 'b', 'c']));
});
});
group('ArgParser.options', () {
test('returns an empty map if there are no options', () {
var parser = ArgParser();
expect(parser.options, isEmpty);
});
test('returns the options that were added', () {
var parser = ArgParser();
parser.addFlag('hide');
parser.addOption('seek');
expect(parser.options, hasLength(2));
expect(parser.options['hide'], isNotNull);
expect(parser.options['seek'], isNotNull);
});
test('iterates over the options in the order they were added', () {
var parser = ArgParser();
parser.addFlag('a');
parser.addOption('d');
parser.addFlag('b');
parser.addOption('c');
expect(parser.options.keys, equals(['a', 'd', 'b', 'c']));
});
});
group('ArgParser.findByNameOrAlias', () {
test('returns null if there is no match', () {
var parser = ArgParser();
expect(parser.findByNameOrAlias('a'), isNull);
});
test('can find options by alias', () {
var parser = ArgParser()..addOption('a', aliases: ['b']);
expect(parser.findByNameOrAlias('b'),
isA