Metadata-Version: 2.1
Name: billomat
Version: 0.1.32
Summary: billomat.com API client
Home-page: http://jensnistler.de/
Author: Jens Nistler
Author-email: opensource@jensnistler.de
License: MIT
Download-URL: http://github.com/lociii/billomat
Description: [![Travis CI build status](https://travis-ci.org/lociii/billomat.svg)](https://travis-ci.org/lociii/billomat)
        
        Deprecation notice
        ==================
        
        This library is unmaintained!
        My employer stopped using billomat services. Therefore no fix or update will be done on this project anymore.
        If you're interested in taking over maintenance, let me know.
        
        Python client for the [billomat.com](http://www.billomat.com) [API](http://www.billomat.com/en/api/)
        =====================================================================================================
        
        The syntax of the client is inspired by the great [Django ORM](https://docs.djangoproject.com/en/dev/topics/db/queries/).
        
        Example usage
        --------------
        
        ```python
        from billomat import models
        from billomat.base import Client
        
        Client.api_name = 'apiname'
        Client.api_key = 'apikey'
        
        # set optional app-id and -secret
        Client.app_id = 'app_id'
        Client.app_secret = 'app_secret'
        
        articles = models.Article.objects.all()
        for article in articles:
            print unicode(article.title)
        articles = articles.filter(title='Awesome')
        for article in articles:
            print unicode(article.title)
        
        article = models.Article.objects.get(article_number=2)
        article.title = u'This is an awesome article'
        article.save()
        
        article = models.Article.objects.create(
            title=u'This is an awesome article',
        )
        article.delete()
        ```
        
        Django support
        ---------------
        Automatic client configuration by django config is supported
        
        ```python
        BILLOMAT_API_NAME = 'aaa'
        BILLOMAT_API_KEY = 'bbb'
        BILLOMAT_APP_ID = 'ccc'
        BILLOMAT_APP_SECRET = 'ddd'
        ```
        
        The client sends 3 django signals:
        
        - billomatclient_request, send before the request
        - billomatclient_response, send after the request containing the response
        - billomatclient_error, send after a request error containing the exception
        
        Each signal sends a request_id which is a unique identifier (uuid4) for each request to track the status along the signal flow.
        
        License
        --------
        [MIT](https://github.com/lociii/billomat/blob/master/LICENSE.md)
        
Keywords: billomat,api,client
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development
Description-Content-Type: text/markdown
