UltraMapper.CommandLine

Ultramapper.commandline

Un analyseur de ligne de commande prenant en charge les appels de méthode directe prenant en entrée un nombre illimité de paramètres de type primitif et complexe

Qu'est-ce que Ultramapper.Commandline?

Ultramapper.Commandline est un analyseur de ligne de commande .NET: un outil qui analyse (analyser et interpréter) votre texte de commande et la carte (trasform) en objets fortement typés .

Ultramapper.comandline simplifie considérablement votre code:

• Les appels de méthodes vous permet de vous débarrasser de tous les «drapeaux de ligne de commande» et de tout le code nécessaire pour les gérer
• Le support de type complexe vous permet d'organiser logiquement les paramètres dans les classes

Ultramapper.Commandline est alimenté par Ultramapper, un puissant mappeur .net!

Fonctionnalités changeantes!

• Appels de méthode directe prenant en charge un nombre illimité de paramètres d'entrée
• Les types complexes prennent en charge les propriétés et les méthodes
• Nidification . Les types complexes peuvent définir en interne d'autres membres de type complexe récursivement.
• L'héritage de type est entièrement pris en charge.
• Les collections (iEnumerable <>, liste <>, tableaux) des types primitifs et complexes prennent en charge
• Un simple JSON comme la syntaxe soutenant tout cela!
• Générateur d'aide automatique

Prendre l'exemple

Ok, cela aura une certaine complexité, mais je veux vous impressionner!

L'exemple suivant montre comment appeler la méthode AddTodatabase à partir de Commandline, passant en entrée une représentation de chaîne du client de type complexe bien structuré, que la méthode addtodatabase prend en entrée.

 class Program
{
    static void Main ( string [ ] args )
    {
        //--add ("John Smith" 26 account=(number=AC2903X balance=3500.00 creditcards=[(CRD01 1000.00) (CRD02 2000.00)]))
        CommandLine . Instance . Parse < CommandLineSupportedCommands > ( args ) ;
    }

    public class CommandLineSupportedCommands
    {
        [ Option ( Name = "add" , HelpText = "Adds new customer to db" ) ]
        public void AddToDatabase ( CustomerInfo customer )
        {
            Assert . IsTrue ( customer . Name == "John Smith" ) ;
            Assert . IsTrue ( customer . Age == 26 ) ;
            Assert . IsTrue ( customer . Account . AccountNumber == "AC2903X" ) ;
            Assert . IsTrue ( customer . Account . Balance == 3500 ) ;
            Assert . IsTrue ( customer . Account . CreditCards [ 0 ] . CardNumber == "CRD01" ) ;
            Assert . IsTrue ( customer . Account . CreditCards [ 0 ] . MonthlyLimit == 1000 ) ;
            Assert . IsTrue ( customer . Account . CreditCards [ 1 ] . CardNumber == "CRD02" ) ;
            Assert . IsTrue ( customer . Account . CreditCards [ 1 ] . MonthlyLimit == 2000 ) ;

            Console . WriteLine ( "New customer inserted!" ) ;
        }
    }

    public class CustomerInfo
    {
        public class BankAccountInfo
        {
            public class CreditCardInfo
            {
                public string CardNumber { get ; set ; }
                public double MonthlyLimit { get ; set ; }
            }

            [ Option ( Name = "number" ) ]
            public string AccountNumber { get ; set ; }
            public double Balance { get ; set ; }

            public List < CreditCardInfo > CreditCards { get ; set ; }
        }

        public string Name { get ; set ; }
        public int Age { get ; set ; }

        public BankAccountInfo Account { get ; set ; }
    }
}

L'exemple ci-dessus montre quelques fonctionnalités de base pour commencer:

• Comment analyser les arguments:

   T parsedArgs = CommandLine . Instance . Parse < T > ( args ) ;

  La ligne de code ci-dessus fait tout le travail.
  L'argument générique t est votre «classe de commandes» .
  Dans votre «classe de commandes», vous définissez toutes les opérations que vous souhaitez prendre en charge au niveau de la ligne de commande .

• La syntaxe de base:

  • Utilisation - Double tirets pour appeler une méthode ou définir une propriété définie dans votre «classe de commandes»
  • Utiliser () supports ronds pour fournir des valeurs à un type complexe
  • Utilisez [] les crochets pour fournir des valeurs à une collection
  • Les paramètres peuvent être attribués de manière anonyme ou en spécifiant explicitement leurs noms (params nommés)

  Ce n'est pas tout ce que vous devez savoir sur la syntaxe
  En savoir plus sur la syntaxe ici

• L'attribut d'option:

  • Vous permet de remplacer le nom d'un membre pour faciliter la référence à partir de la ligne de commande
  • Vous permet de marquer un membre comme facultatif
  • Vous permet de fournir une description d'aide qui sera utilisée par la commande d'aide automatique .

  Ce n'est pas tout ce que vous devez savoir sur l'attribut d'option
  En savoir plus sur l'attribut d'option ici

Il y a quelques autres choses et quelques remarques que vous devriez savoir sur Ultramapper.Commandline
Consultez le wiki pour plus d'informations

Tous les commentaires sont les bienvenus