:options:
  verbose:
    :type: bool
    :summary: Displays extra runtime information.
    :global: true
    :short_aliases:
      - v
  help:
    :type: bool
    :summary: Displays this help.
    :global: true
    :short_aliases:
      - h
  version:
    :type: bool
    :summary: Displays program version.
    :short_aliases:
      - V
    :long_aliases:
      - program-version
  simulate:
    :type: bool
    :global: true
    :summary: Will not perform actual actions
  debug:
    :type: bool
    :summary: Debug mode
    :global: true
  debug-on-stderr:
    :type: bool
    :global: true
    :summary: Sends debugging to SDTERR
    :long_aliases:
      - debug-on-err
    :dependencies:
      - debug
    :incompatibilities:
      - log-file
  log-level:
    :global: true
    :dependencies:
      - debug
    :type: integer
    :summary: Defines the level of logging (0 to 5)
  log-file:
    :global: true
    :dependencies:
      - debug
    :incompatibilities:
      - debug-on-stderr
    :type: string
    :summary: Specifies a file to log into
  truncate-log-file:
    :global: true
    :dependencies:
      - log-file
    :type: bool
    :summary: Truncates the log file (appends by default)
  project-path:
    :global: true
    :type: string
    :summary: Specifies a startup path to use instead of '.'
  auto:
    :global: true
    :type: bool
    :summary: Bypasses command-line confirmations to the user

:banner: |
  This is power_stencil. A powerful templating engine.

:subcommands:
  init:
    :banner: |
      Initializes a PowerStencil repository.

      Usage:
        init [project_path] [options]

      Default is initializing the PowerStencil repository in current directory. If
      specified, will initialize a repository in project_path (global option
      project_path can be used too).
    :options:
      force:
        :type: bool
        :summary: Forces creation in an already existing directory.
        :short_aliases:
          - f
  info:
    :banner: |
      Generic information about the repository.

      Usage:
        info [options]

      Displays information about the repository.
  new-plugin:
    :banner: |
      Generates the skeleton for a plugin.

      Usage:
        new-plugin [options]

      Generates a fully working although useless plugin skeleton.
  get:
    :banner: |
      Query entities from repository.

      Usage:

        get [entity_type[/ ]entity_name] [options]

      Retrieves entities from the repostory. You can have multiple
      criteria passed on the command line. either of the form
      "type/name" or two consecutive parameters "type name". If in
      "regexp" mode then each criterion is considered as a regular
      expression (be careful, not a file pattern alike)
    :options:
      regexp: &REGEXPOPT
        :type: bool
        :summary: Parameters are considered as regular expressions.
        :short_aliases:
          - r
        :long_aliases:
          - regular-expression
      names-only:
        :type: bool
        :summary: Only returns the name of the entities found.
      compiled: &COMPILEDOPT
        :type: bool
        :summary: Entities as used by susbstitution engine.
      scenario: &SCENARIOOPT
        :type: string
        :summary: Applies overrides defined for this scenario.
        :dependencies:
          - compiled
      raw:
        :type: bool
        :summary: Displays entities as they are stored
      graph:
        :type: bool
        :summary: Displays the query result as a graph.
        :short_aliases:
          - g
  shell:
    :banner: |
      Opens a shell to interact with entities.

      Usage:
        shell [options]

      Opens a Ruby "pry" shell with all entities loaded. You can modify
      create, delete any entity from there.
    :options:
      compiled:
        <<: *COMPILEDOPT
      scenario:
        <<: *SCENARIOOPT
  check:
    :banner: |
      Check repository entities consistency.

      Usage:

        check [entity_type[[/ ]entity_name]] [options]

      Check entities consistency. By default will check all entities.
    :options:
      regexp:
        <<: *REGEXPOPT
  create:
    :banner: |
      Creates entities in the repository.

      Usage:

        create entity_type[/ ]entity_name [options]

      Creates repository entities. Both type and name have to be provided
    :options:
      property:
        :type: array
        :summary: Specifiies a first-level property for the entity
        :short_aliases:
          - p
      edit:
        :type: bool
        :summary: Edits the newly created entity.
        :short_aliases:
          - e
        :long_aliases:
          - edit-after-create
      editor:
        :type: string
        :summary: Specifies an editor to use.
        :dependencies:
          - edit
      user:
        :type: bool
        :summary: Stores the entities as local user entities, ie non-versioned
        :long_aliases:
          - user-storage
          - non-versioned
        :short_aliases:
          - u
  edit:
    :banner: |
      Edit entities from repository.

      Usage:

        edit [object_type[[/ ]object_name]] [options]

      Edits repository entities. Parameters are used the same way as in 'get'.
    :options:
      regexp: *REGEXPOPT
      editor:
        :type: string
        :summary: Specifies an editor to use.
        :short_aliases:
          - e
  delete:
    :banner: |
      Delete entities from repository.

      Usage:

        delete [object_type[[/ ]object_name]] [options]

      Deletes repository entities. Parameters are used the same way as in 'get'.
    :options:
      regexp: *REGEXPOPT
      delete-files:
        :type: bool
        :summary: Will also remove files related to the entity.
  build:
    :banner: |
      Builds entities.

      Usage:

        build [entity_type[[/ ]entity_name]]+ [options]

      Builds repository entities. Parameters are used the same way as in 'get'.
    :options:
      regexp: *REGEXPOPT
      supported-builds:
        :type: bool
        :summary: Displays the list of supported builds
        :short_aliases:
          - s
        :long_aliases:
          - list
      fail-on-error:
        :type: bool
        :summary: Fails at the first failure
      parallelized:
        :type: bool
        :summary: Parallelizes builds if possible