Metadata-Version: 2.1
Name: apigeecli
Version: 0.40.0
Summary: Apigee Management API command-line interface with multi-factor authentication
Home-page: https://github.com/mdelotavo/apigee-cli
Author: Matthew Delotavo
Author-email: matthew.t.delotavo@gmail.com
License: Apache license 2.0
Project-URL: Documentation, https://mdelotavo.github.io/apigee-cli/index.html
Description: ==========
        apigee-cli
        ==========
        
        |License|
        
        .. code-block:: text
        
            Usage: apigee [OPTIONS] COMMAND [ARGS]...
        
              Welcome to the Apigee Management API command-line interface!
        
              Docs:    https://mdelotavo.github.io/apigee-cli/
              PyPI:    https://pypi.org/project/apigeecli/
              GitHub:  https://github.com/mdelotavo/apigee-cli
        
            Options:
              -V, --version  Show the version and exit.
              -h, --help     Show this message and exit.
        
            Commands:
              apiproducts    API products enable you to bundle and distribute your APIs...
              apis           The proxy APIs let you perform operations on API proxies,...
              apps           Management APIs available for working with developer apps.
              auth           Custom authorization commands.
              caches         A lightweight persistence store that can be used by...
              configure      Configure Apigee Edge credentials.
              deployments    API proxies that are actively deployed in environments on...
              developers     Developers implement client/consumer apps and must be...
              keyvaluemaps   Key/value maps at the environment scope can be accessed by...
              maskconfigs    Specify data that will be filtered out of trace sessions.
              permissions    Permissions for roles in an organization on Apigee Edge.
              targetservers  TargetServers are used to decouple TargetEndpoint...
              userroles      Roles for users in an organization on Apigee Edge.
        
        
        ------------
        Installation
        ------------
        
        The easiest way to install apigee-cli is to use `pip`_ in a ``virtualenv``::
        
            $ pip install apigeecli
        
        or, if you are not installing in a ``virtualenv``, to install globally::
        
            $ sudo pip install apigeecli
        
        or for your user::
        
            $ pip install --user apigeecli
        
        If you have the apigee-cli installed and want to upgrade to the latest version
        you can run::
        
            $ pip install --upgrade apigeecli
        
        ---------------
        Getting Started
        ---------------
        
        Before using apigee-cli, you need to tell it about your Apigee Edge credentials.  You
        can do this in three ways:
        
        * Environment variables
        * Config file
        * Command-line arguments
        
        The quickest way to get started is to run the ``apigee configure`` command::
        
            $ apigee configure
            Apigee username (email) []: my_email
            Apigee password []: my_pass
            Apigee MFA key (optional) []: my_key
            Default Apigee organization (recommended) []: my_org
            Default team/resource prefix (optional) []: team_prefix
        
        
        To use environment variables, do the following::
        
            $ export APIGEE_USERNAME=<my_email>
            $ export APIGEE_PASSWORD=<my_pass>
            $ export APIGEE_MFA_SECRET=<my_key>
            $ export APIGEE_ORG=<my_org>
            $ export APIGEE_CLI_PREFIX=<my_prefix>
        
        
        To use the configuration file, create an INI formatted file like this::
        
            [default]
            username = my_email
            org = my_org
            mfa_secret = my_key
            prefix = my_prefix
            password = my_pass
        
            [produser]
            org = my_org
            username = my_email
            password = my_pass
            mfa_secret = my_key
        
        and place it in ``~/.apigee/credentials``.
        
        As you can see, you can have multiple ``profiles`` defined in the configuration file. You can then specify which
        profile to use by using the ``-P/--profile`` option. If no profile is specified
        the ``default`` profile is used.
        
        ------------	
        Getting Help	
        ------------	
        
        * `The Apigee Management API command-line interface documentation`_	
        * `Apigee Product Documentation`_	
        * `GitHub`_	
        
        
        
        .. |Upload Python Package badge| image:: https://github.com/mdelotavo/apigee-cli/workflows/Upload%20Python%20Package/badge.svg
            :target: https://github.com/mdelotavo/apigee-cli/actions?query=workflow%3A%22Upload+Python+Package%22
        .. |Python package badge| image:: https://github.com/mdelotavo/apigee-cli/workflows/Python%20package/badge.svg
            :target: https://github.com/mdelotavo/apigee-cli/actions?query=workflow%3A%22Python+package%22
        .. |Code style: black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
            :target: https://github.com/psf/black
        .. |PyPI| image:: https://img.shields.io/pypi/v/apigeecli
            :target: https://pypi.org/project/apigeecli/
        .. |License| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg
            :target: https://opensource.org/licenses/Apache-2.0
        .. _`Apigee Product Documentation`: https://apidocs.apigee.com/management/apis
        .. _`Permissions reference`: https://docs.apigee.com/api-platform/system-administration/permissions
        .. _`Add permissions to testing role`: https://docs.apigee.com/api-platform/system-administration/managing-roles-api#addpermissionstotestingrole
        .. _pip: http://www.pip-installer.org/en/latest/
        .. _`Universal Command Line Interface for Amazon Web Services`: https://github.com/aws/aws-cli
        .. _`The Apigee Management API command-line interface documentation`: https://mdelotavo.github.io/apigee-cli/index.html
        .. _`GitHub`: https://github.com/mdelotavo/apigee-cli
        .. _`Python Package Index (PyPI)`: https://pypi.org/project/apigeecli/
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
