.. _ref_commands_init:

init
====

Initialise a rockcraft project by creating a minimalist,
yet functional, rockcraft.yaml file in the current directory.


Usage
-----

:command:`rockcraft init [options]`


Options
-------

``--name``
   The name of the rock; defaults to the directory name.
``--profile``
   Use the specified project profile (defaults to 'simple').

Global options
--------------

``-h`` or ``--help``
   Show this help message and exit.
``-q`` or ``--quiet``
   Only show warnings and errors, not progress.
``-v`` or ``--verbose``
   Show debug information and be more verbose.
``--verbosity``
   Set the verbosity level to 'quiet', 'brief', 'verbose', 'debug' or 'trace'.
``-V`` or ``--version``
   Show the application version and exit.