Metadata-Version: 2.1
Name: st2client
Version: 3.8.0
Summary: Python client library and CLI for the StackStorm (st2) event-driven automation platform.
Home-page: https://stackstorm.com/
Author: StackStorm
Author-email: info@stackstorm.com
License: UNKNOWN
Project-URL: Pack Exchange, https://exchange.stackstorm.org
Project-URL: Repository, https://github.com/StackStorm/st2
Project-URL: Documentation, https://docs.stackstorm.com
Project-URL: Community, https://stackstorm.com/community-signup
Project-URL: Questions, https://forum.stackstorm.com/
Project-URL: Donate, https://funding.communitybridge.org/projects/stackstorm
Project-URL: News/Blog, https://stackstorm.com/blog
Project-URL: Security, https://docs.stackstorm.com/latest/security.html
Project-URL: Bug Reports, https://github.com/StackStorm/st2/issues
Description: StackStorm CLI and Python Client
        ================================
        
        Install stable / production version from Python Package Index (PyPi)
        --------------------------------------------------------------------
        
        .. sourcecode:: bash
        
            pip install st2client
        
        Install latest development version from Source
        ----------------------------------------------
        
        Git clone StackStorm/st2 repo locally, change directory to st2client, then
        run "python setup.py install" or install it directly using pip from git:
        
        
        .. sourcecode:: bash
        
            pip install "git+https://github.com/stackstorm/st2.git#egg=st2client&subdirectory=st2client"
        
        Endpoint Configuration
        ----------------------
        
        By default, both the python client and the CLI will retrieve endpoint
        configuration from the environment. If no configuration is provided, the
        client will assume localhost and default ports.
        
        -  ``ST2_BASE_URL`` - Base URL for the StackStorm API server endpoints (i.e.
           http://127.0.0.1). If only the base URL is provided, the client will
           assume default ports for the API servers are used. If any of the API
           server URL is provided, it will override the base URL and default
           port.
        - ``ST2_AUTH_URL`` - URL to the auth API endpoint used for authentication.
        -  ``ST2_API_URL`` - Endpoint for the Action REST API (i.e.
           https://example.com/api) for managing actions, executions, triggers,
           rules and other resources.
        - ``ST2_STREAM_URL`` - URL to the stream API endpoind uses for event-stream data.
        
        The default endpoint configuration can be explicitly specified at the
        StackStorm CLI and the python client. For StackStorm CLI, the endpoints are provided
        via optional parameters (i.e. ``--url`` for base URL, ``--auth-url``, ``--api-url`` and
        ``--stream-url``).
        
        For the python client, the endpoints are provided via the Client init as kwargs (i.e.
        ``base_url``, ``auth_url``, ``api_url``, ``stream_url``).
        
        CLI
        ---
        
        CLI is developed using standard python argparse and uses well known
        pattern for commands and subcommands. In general, trigger, rule, action,
        and key are commands and list, get, create, update, and delete are
        subcommands. The command run and execution are special cases and do not
        have the same set of subcommands. Please use the CLI help option for
        more detail description.
        
        -h or --help option is used to display usage information.
        
        .. sourcecode:: bash
        
            st2 -h
            st2 action -h
            st2 action create -h
            st2 run -h
            st2 run <action-ref> -h
        
        ``-j`` or ``--json`` option will format output as JSON.
        
        ::
        
            st2 rule get <rule-name> -j
        
        ``-y`` or ``--yaml`` option will format output as YAML.
        
        ::
        
            st2 rule get <rule-name> -j
        
        
        ``-a`` or ``--attr`` option allows user to specify which attributes to display
        and in which order.
        
        ::
        
            st2 rule get <rule-name> -a name description
            st2 execution list --attr id action.ref status start_timestamp
        
        ``-w`` or ``--width`` option lets user specify the width of table columns. If
        only 1 value is provided, all table columns will have the same width. By
        default, the width is 28.
        
        ::
        
            st2 rule list -a name description -w 50
            st2 rule list -a name description -w 25 50
        
        Python Client
        -------------
        
        ::
        
            >>> from st2client.client import Client
            >>> from st2client import models
            >>> client = Client(base_url='http://127.0.0.1')
            >>> rules = client.rules.get_all()
            >>> executions = client.executions.get_all()
            >>> key_value_pair = client.keys.update(models.KeyValuePair(name='k1', value='v1'))
        
        The models Trigger, Rule, Action, Execution, and KeyValuePair are
        defined under st2client.models. Please refer to the respective README
        section for these models for their schema.
        
        The resource managers for the models are instantiated under the client
        as **triggers**, **rules**, **actions**, **executions**, and **keys**.
        The operations get\_all, get\_by\_name, get\_by\_id, create, update, and
        delete are generally implemented for these resource managers.
        
        -  ``get_all`` returns a list of resource instances.
        -  ``get_by_name`` and ``get_by_id`` takes name and id respectively
           and returns the matching resource instance.
        -  ``create`` takes a resource instance as input and creates the
           instance, throwing unique constraint error if name already exists
        -  ``update`` takes a resource instance as input and updates the
           instance matching by name
        -  ``delete`` takes a resource instance as input and deletes the
           instance matching by name
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/x-rst
