Metadata-Version: 2.1
Name: omni-api
Version: 0.5.0
Summary: Omni API Client
Home-page: http://omni-api.hive.pt
Author: Hive Solutions Lda.
Author-email: development@hive.pt
License: Apache License, Version 2.0
Description: # [Omni API](http://omni-api.hive.pt)
        
        Simple REST API wrapper for the Omni infra-structure.
        
        ## Configuration
        
        | Name                  | Type  | Description                                                                                                              |
        | --------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------ |
        | **OMNI_BASE_URL**     | `str` | The base URL that is going to be used for API connections (defaults to `http://localhost:8080/mvc/`).                    |
        | **OMNI_OPEN_URL**     | `str` | The open URL for the Omni connection (defaults to `OMNI_BASE_URL`).                                                      |
        | **OMNI_PREFIX**       | `str` | The default prefix to be used for API requests (defaults to `adm/`).                                                     |
        | **OMNI_ID**           | `str` | The client id to be used for API connections (defaults to `None`).                                                       |
        | **OMNI_SECRET**       | `str` | The secret key to be used for API connections (defaults to `None`).                                                      |
        | **OMNI_REDIRECT_URL** | `str` | The URL to be used for redirection OAuth based workflow (defaults to `base,base.user,base.admin,foundation.store.list`). |
        | **OMNI_USERNAME**     | `str` | The username to be used on direct workflow (defaults to `None`).                                                         |
        | **OMNI_PASSWORD**     | `str` | The password to be used on direct workflow (defaults to `None`).                                                         |
        
        ## Usage
        
        Typical usage of the Omni client implies the providing of the username and the
        password inside the target omni instance (Direct Mode).
        
        ```python
        api = omni.Api(
            base_url = "http://frontdoorhq.com",
            username = "YOUR_USERNAME",
            password = "YOUR_PASSWORD"
        )
        ```
        
        Alternatively it's possible to use the api throught an OAuth base approach using
        the provided client id and secret values.
        
        ```python
        api = omni.Api(
            base_url = "http://frontdoorhq.com",
            client_id = "YOUR_OAUTH_ID",
            client_secret = "YOUR_OAUTH_SECRET"
        )
        ```
        
        For these type of handling the `OAuthAccessError` exception must be handled and then
        the user must be redirect to the url provided by `api.oauth_autorize` method call.
        
        Running then the `api.oauth_access` call with the returned `code` from the server side
        that should be used to redeem the `access_token` required for session authentication.
        
        ## Examples
        
        Examples are located [here](src/examples).
        
        ## License
        
        Omni API is currently licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/).
        
        ## Build Automation
        
        [![Build Status](https://app.travis-ci.com/hivesolutions/omni-api.svg?branch=master)](https://travis-ci.com/github/hivesolutions/omni-api)
        [![Build Status GitHub](https://github.com/hivesolutions/omni-api/workflows/Main%20Workflow/badge.svg)](https://github.com/hivesolutions/omni-api/actions)
        [![Coverage Status](https://coveralls.io/repos/hivesolutions/omni-api/badge.svg?branch=master)](https://coveralls.io/r/hivesolutions/omni-api?branch=master)
        [![PyPi Status](https://img.shields.io/pypi/v/omni-api.svg)](https://pypi.python.org/pypi/omni-api)
        [![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://www.apache.org/licenses/)
        
Keywords: omni api
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.0
Classifier: Programming Language :: Python :: 3.1
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
