packages
========

Documentation for the ``packages`` command and its subcommands.


.. raw:: html

    <!-- spacer -->

.. dropdown:: ``packages`` — Manage sima-cli package registry (list, inspect, clean, etc.)
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] COMMAND [ARGS]...
        
          Manage sima-cli package registry (list, inspect, clean, etc.)
        
        Options:
          --help  Show this message and exit.
        
        Commands:
          build  Build package metadata.json from an artifacts folder.
          list   List all packages in the local registry.
          show   Show metadata or post-install instructions for a package.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] COMMAND [ARGS]...


.. dropdown:: ``packages build`` — Build package metadata.json from an artifacts folder.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] ARTIFACTS\_FOLDER
        
          Build package metadata.json from an artifacts folder.
        
        Options:
          --name TEXT            Package name. Defaults to gh:<org>/<repo> for GitHub
                                 repos.
          --version TEXT         Package version. Defaults to exact git tag or short
                                 commit hash.
          --description TEXT     Package description. Defaults to the GitHub repo
                                 description when available.
          --install-script TEXT  Install script file inside ARTIFACTS\_FOLDER, or a
                                 single-line shell command.  [required]
          --selectables TEXT     Optional resources in 'name1:file1;name2:file2'
                                 format.
          --exclude TEXT         Exclude artifact files whose relative path or
                                 filename contains this text. May be repeated.
          --variant TEXT         Optional metadata variant name. Writes
                                 metadata-<variant>.json instead of metadata.json.
          --help                 Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] ARTIFACTS_FOLDER


.. dropdown:: ``packages list`` — List all packages in the local registry.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS]
        
          List all packages in the local registry.
        
        Options:
          --help  Show this message and exit.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS]


.. dropdown:: ``packages show`` — Show metadata or post-install instructions for a package.
    :animate: fade-in
    :color: secondary
    :open:

    **Full Help:**

    .. code-block:: text

        Usage:  [OPTIONS] PACKAGE
        
          Show metadata or post-install instructions for a package.
        
        Options:
          -v, --version TEXT  Specify a version when multiple matches exist. If
                              omitted, the latest match is shown.
          --help              Show this message and exit.
        
          PACKAGE supports partial and case-insensitive matching. If multiple matches
          are found, a summary table of all matching packages will be shown.

    **Usage:**

    .. code-block:: bash

        Usage:  [OPTIONS] PACKAGE


Options
-------

No options available.