NAME

       plainbox-startprovider - create a new plainbox provider

SYNOPSIS

          plainbox startprovider [-h] [--empty] name

DESCRIPTION

       Creates a new provider from a built-in skeleton.

       The name of the provider must follow the pattern ``YYYY.example.org:name`` where ``YYYY`` is a four-digit
       year  when  the author of the provider owned the domain (here, ``example.org``) and ``name`` is arbitrary
       identifier that is managed by the owner of that domain. The identifier should be  constrained  to  ASCII,
       digits and the dash character.

       This  naming  scheme  allows  anyone  that ever owned a domain name to come up with non-clashing provider
       identifiers. Those identifiers are going to be used in fully qualified names of various objects.

       This command creates a new skeleton test provider for PlainBox. The generated content should be edited to
       fit a particular purpose.

OPTIONS

       Positional arguments:

       provider name, eg: YYYY.example.org:some-name

       Optional arguments:

       --empty
              create an empty provider

ABOUT NAMING PROVIDERS

       Plainbox tries to be intuitive where possible but provider names keep  causing  issues  and  make  people
       struggle  with  coming  up  with  correct  and  good  names.   See plainbox-provider-names for a detailed
       discussion of provider names.

AUTHOR

       Zygmunt Krynicki & Checkbox Contributors

COPYRIGHT

       2012-2014 Canonical Ltd

0.25                                            January 05, 2016                       PLAINBOX-STARTPROVIDER(1)