work towards an additional arguments callback

Author: siywilliams

FluentCommandLineParser.Tests/FluentCommandLineParser/when_setting_up_a_new_option/with_a_long_name/with_a_long_name.cs

@@ -41,6 +41,7 @@ public class with_a_long_name : SettingUpALongOptionTestContext
 			It should_have_the_given_long_name = () => option.LongName.ShouldMatch(valid_long_name);
 			It should_not_be_a_required_option = () => option.IsRequired.ShouldBeFalse();
 			It should_have_no_callback = () => option.HasCallback.ShouldBeFalse();
+			It should_have_no_additional_args_callback = () => option.HasAdditionalArgumentsCallback.ShouldBeFalse();
 			It should_have_no_description = () => option.Description.ShouldBeNull();
 			It should_have_no_default_value = () => option.HasDefault.ShouldBeFalse();
 		}

FluentCommandLineParser.Tests/FluentCommandLineParser/when_setting_up_a_new_option/with_a_long_name/with_a_long_name_that_is_empty.cs

@@ -41,6 +41,7 @@ public class with_a_long_name_that_is_empty : SettingUpALongOptionTestContext
 			It should_have_the_given_long_name = () => option.LongName.ShouldMatch(valid_long_name_that_is_empty);
 			It should_not_be_a_required_option = () => option.IsRequired.ShouldBeFalse();
 			It should_have_no_callback = () => option.HasCallback.ShouldBeFalse();
+			It should_have_no_additional_args_callback = () => option.HasAdditionalArgumentsCallback.ShouldBeFalse();
 			It should_have_no_description = () => option.Description.ShouldBeNull();
 			It should_have_no_default_value = () => option.HasDefault.ShouldBeFalse();
 		}

FluentCommandLineParser.Tests/FluentCommandLineParser/when_setting_up_a_new_option/with_a_long_name/with_a_long_name_that_is_valid.cs

@@ -41,6 +41,7 @@ public class with_a_long_name_that_is_valid : SettingUpALongOptionTestContext
 			It should_have_the_given_long_name = () => option.LongName.ShouldBeNull();
 			It should_not_be_a_required_option = () => option.IsRequired.ShouldBeFalse();
 			It should_have_no_callback = () => option.HasCallback.ShouldBeFalse();
+			It should_have_no_additional_args_callback = () => option.HasAdditionalArgumentsCallback.ShouldBeFalse();
 			It should_have_no_description = () => option.Description.ShouldBeNull();
 			It should_have_no_default_value = () => option.HasDefault.ShouldBeFalse();
 		}

FluentCommandLineParser.Tests/FluentCommandLineParser/when_setting_up_a_new_option/with_a_short_name/with_a_short_name.cs

@@ -41,6 +41,7 @@ public class with_a_short_name : SettingUpAShortOptionTestContext
 			It should_have_no_long_name = () => option.HasLongName.ShouldBeFalse();
 			It should_not_be_a_required_option = () => option.IsRequired.ShouldBeFalse();
 			It should_have_no_callback = () => option.HasCallback.ShouldBeFalse();
+			It should_have_no_additional_args_callback = () => option.HasAdditionalArgumentsCallback.ShouldBeFalse();
 			It should_have_no_description = () => option.Description.ShouldBeNull();
 			It should_have_no_default_value = () => option.HasDefault.ShouldBeFalse();
 		}

FluentCommandLineParser/ICommandLineOptionFluent.cs

@@ -23,6 +23,7 @@
 #endregion
 
 using System;
+using System.Collections.Generic;
 
 namespace Fclp
 {
@@ -47,6 +48,7 @@ public interface ICommandLineOptionFluent<T>
 		/// <summary>
 		/// Specifies the method to invoke when the <see cref="ICommandLineOptionFluent{T}"/>. 
 		/// is parsed. If a callback is not required either do not call it, or specify <c>null</c>.
+		/// Do no use this if you are using the Fluent Command Line Builder.
 		/// </summary>
 		/// <param name="callback">The return callback to execute with the parsed value of the Option.</param>
 		/// <returns>A <see cref="ICommandLineOptionFluent{T}"/>.</returns>
@@ -58,5 +60,13 @@ public interface ICommandLineOptionFluent<T>
 		/// <param name="value">The value to use.</param>
 		/// <returns>A <see cref="ICommandLineOptionFluent{T}"/>.</returns>
 		ICommandLineOptionFluent<T> SetDefault(T value);
+
+		/// <summary>
+		/// Specified the method to invoke with any addition arguments parsed with the Option.
+		/// If additional arguments are not required either do not call it, or specify <c>null</c>.
+		/// </summary>
+		/// <param name="callback">The return callback to execute with the parsed addition arguments found for this Option.</param>
+		/// <returns>A <see cref="ICommandLineOptionFluent{T}"/>.</returns>
+		ICommandLineOptionFluent<T> AdditionalArgumentsCallback(Action<IEnumerable<string>> callback);
 	}
 }

FluentCommandLineParser/Internals/CommandLineOption.cs

@@ -23,6 +23,7 @@
 #endregion
 
 using System;
+using System.Collections.Generic;
 using System.Linq;
 using Fclp.Internals.Extensions;
 using Fclp.Internals.Parsing;
@@ -72,6 +73,8 @@ public CommandLineOption(string shortName, string longName, ICommandLineOptionPa
 
 		internal Action<T> ReturnCallback { get; set; }
 
+		internal Action<IEnumerable<string>> ReturnAdditionalArgumentsCallback { get; set; }
+
 		internal T Default { get; set; }
 
 		/// <summary>
@@ -124,13 +127,21 @@ public bool HasShortName
 		}
 
 		/// <summary>
-		/// Gets whether this <see cred="ICommandLineOption"/> has a callback setup.
+		/// Gets whether this <see cref="ICommandLineOption"/> has a callback setup.
 		/// </summary>
 		public bool HasCallback
 		{
 			get { return this.ReturnCallback != null; }
 		}
 
+		/// <summary>
+		/// Gets whether this <see cref="ICommandLineOption"/> has an additional arguments callback setup.
+		/// </summary>
+		public bool HasAdditionalArgumentsCallback
+		{
+			get { return this.ReturnAdditionalArgumentsCallback != null; }
+		}
+
 		#endregion Properties
 
 		#region Methods
@@ -173,7 +184,7 @@ public ICommandLineOptionFluent<T> WithDescription(string description)
 		}
 
 		/// <summary>
-		/// Declares that this <see cref="ICommandLineOptionFluent{T}"/> is required and a value must be specified to fulfill it.
+		/// Declares that this <see cref="ICommandLineOptionFluent{T}"/> is required and a value must be specified to fulfil it.
 		/// </summary>
 		/// <returns>A <see cref="ICommandLineOptionFluent{T}"/>.</returns>
 		public ICommandLineOptionFluent<T> Required()
@@ -206,6 +217,18 @@ public ICommandLineOptionFluent<T> SetDefault(T value)
 			return this;
 		}
 
+		/// <summary>
+		/// Specified the method to invoke with any addition arguments parsed with the Option.
+		/// If additional arguments are not required either do not call it, or specify <c>null</c>.
+		/// </summary>
+		/// <param name="callback">The return callback to execute with the parsed addition arguments found for this Option.</param>
+		/// <returns>A <see cref="ICommandLineOptionFluent{T}"/>.</returns>
+		public ICommandLineOptionFluent<T> AdditionalArgumentsCallback(Action<IEnumerable<string>> callback)
+		{
+			this.ReturnAdditionalArgumentsCallback = callback;
+			return this;
+		}
+
 		#endregion Methods
 	}
 }

FluentCommandLineParser/Internals/ICommandLineOption.cs

@@ -78,6 +78,11 @@ public interface ICommandLineOption
 		/// </summary>
 		bool HasCallback { get; }
 
+		/// <summary>
+		/// Gets whether this <see cref="ICommandLineOption"/> has an additional arguments callback setup.
+		/// </summary>
+		bool HasAdditionalArgumentsCallback { get; }
+
 		/// <summary>
 		/// Gets whether this <see cref="ICommandLineOption"/> has a default value setup.
 		/// </summary>