#region License
//
// Copyright 2015-2013 Giacomo Stelluti Scala
//
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.
#endregion
#region Using Directives
using System;
using CommandLine.Extensions;
using CommandLine.Infrastructure;
#endregion
namespace CommandLine
{
///
/// Provides base properties for creating an attribute, used to define rules for command line parsing.
///
public abstract class BaseOptionAttribute : Attribute
{
internal const string DefaultMutuallyExclusiveSet = "Default";
private char? _shortName;
private object _defaultValue;
private string _metaValue;
private bool _hasMetaValue;
private string _mutuallyExclusiveSet;
///
/// Initializes a new instance of the class.
///
protected BaseOptionAttribute()
{
}
///
/// Initializes a new instance of the class.
/// Validating and .
///
/// Short name of the option.
/// Long name of the option.
protected BaseOptionAttribute(char shortName, string longName)
{
_shortName = shortName;
if (_shortName.Value.IsWhiteSpace() || _shortName.Value.IsLineTerminator())
{
throw new ArgumentException(SR.ArgumentException_NoWhiteSpaceOrLineTerminatorInShortName, "shortName");
}
UniqueName = new string(shortName, 1);
LongName = longName;
}
///
/// Initializes a new instance of the class. Validating
/// and . This constructor accepts a as short name.
///
/// Short name of the option.
/// Long name of the option.
protected BaseOptionAttribute(char? shortName, string longName)
{
_shortName = shortName;
if (_shortName != null)
{
if (_shortName.Value.IsWhiteSpace() || _shortName.Value.IsLineTerminator())
{
throw new ArgumentException(SR.ArgumentException_NoWhiteSpaceOrLineTerminatorInShortName, "shortName");
}
UniqueName = new string(_shortName.Value, 1);
}
LongName = longName;
if (UniqueName != null)
{
return;
}
if (LongName == null)
{
throw new ArgumentNullException("longName", SR.ArgumentNullException_LongNameCannotBeNullWhenShortNameIsUndefined);
}
UniqueName = LongName;
}
///
/// Gets a short name of this command line option. You can use only one character.
///
public virtual char? ShortName
{
get { return _shortName; }
internal set { _shortName = value; }
}
///
/// Gets long name of this command line option. This name is usually a single english word.
///
public string LongName
{
get; internal set;
}
///
/// Gets or sets the option's mutually exclusive set.
///
public string MutuallyExclusiveSet
{
get
{
return _mutuallyExclusiveSet;
}
set
{
_mutuallyExclusiveSet = string.IsNullOrEmpty(value) ? DefaultMutuallyExclusiveSet : value;
}
}
///
/// Gets or sets a value indicating whether a command line option is required.
///
public virtual bool Required
{
get; set;
}
///
/// Gets or sets mapped property default value.
///
public virtual object DefaultValue
{
get
{
return _defaultValue;
}
set
{
_defaultValue = value;
HasDefaultValue = true;
}
}
///
/// Gets or sets mapped property meta value.
///
public virtual string MetaValue
{
get
{
return _metaValue;
}
set
{
_metaValue = value;
_hasMetaValue = !string.IsNullOrEmpty(_metaValue);
}
}
///
/// Gets or sets a short description of this command line option. Usually a sentence summary.
///
public string HelpText
{
get; set;
}
internal string UniqueName
{
get;
private set;
}
internal bool HasShortName
{
get { return _shortName != null; }
}
internal bool HasLongName
{
get { return !string.IsNullOrEmpty(LongName); }
}
internal bool HasDefaultValue
{
get; private set;
}
internal bool HasMetaValue
{
get { return _hasMetaValue; }
}
internal bool AutoLongName
{
get; set;
}
}
}