******************************
* Bundle command lines e.g. *
******************************


[ Adding a new bundle ]

    Adding/importing bundle
    ----------

    To add a new bundle or to import an existing one, use the following command line.

    $ gina bundle:add <bundle_name> @<project_name>
    Or
    $ gina bundle:add <bundle_name> @<project_name> --start-port-from<port_number>


    Adding multiple
    ----------
    $ gina bundle:add <bundle_name_1> <bundle_name_2> <bundle_name_3> @<project_name>



[ Removing an existing bundle ]

    $ gina bundle:remove <bundle_name> @<project_name>



[ Listing all bundles inside your project ]

    $ gina bundle:list @<project_name>

    or to list all projects bundles

    $ gina bundle:list


[ Starting a bundle ]

    $ gina bundle:start <bundle_name> @<project_name>

    or to start more than one at once under the same project

    $ gina bundle:start <bundle_name_1> <bundle_name_2> @<project_name>

    [ Starting a bundle in debug mode ]

    $ gina bundle:start <bundle_name> @<project_name> --debug-brk=5656 --max-old-space-size=2048

    [ Starting a bundle pinned to a specific installed gina version ]

    $ gina bundle:start <bundle_name> @<project_name> --gina-version=0.1.8

    The declared version is validated against the tracked versions in ~/.gina/main.json.
    You can also pin a version statically in your project's manifest.json:

        "bundles": {
            "<bundle_name>": {
                "gina_version": "0.1.8",
                ...
            }
        }

    The CLI flag takes priority over the manifest.json declaration.
    The socket server keeps running its own version; only the spawned bundle process
    uses the declared version.


[ Stopping a bundle ]

    $ gina bundle:stop <bundle_name> @<project_name>


[ Stopping all your project bundles ]

    $ gina bundle:stop @<project_name>


[ Restarting a bundle ]

    $ gina bundle:restart <bundle_name> @<project_name>


[ Restarting all your project bundles ]

    $ gina bundle:restart @<project_name>


[ Generating OpenAPI spec ]

    Generate an OpenAPI 3.1.0 specification from routing.json for a bundle.
    The spec is written to <bundle>/config/openapi.json by default.

    $ gina bundle:openapi <bundle_name> @<project_name>

    Generate specs for all bundles in a project
    ----------
    $ gina bundle:openapi @<project_name>

    Write to a custom output path
    ----------
    $ gina bundle:openapi <bundle_name> @<project_name> --output=/path/to/spec.json

    Alias
    ----------
    $ gina bundle:oas <bundle_name> @<project_name>