Metadata-Version: 2.0
Name: okchef
Version: 1.2.5
Summary: python client library for Chef Server
Home-page: https://github.com/samstav/okchef
Author: Sam Stavinoha
Author-email: samuel.stavinoha@rackspace.com
License: Apache License, Version 2.0
Keywords: chef requests client api requests-chef 7311f24a
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Requires-Dist: requests (>=2.7.0)
Requires-Dist: requests-chef (>=0.1.6)
Requires-Dist: six (>=1.9.0)

okchef
======

| |latest|  |Circle CI|  |Coverage Status|  |Requirements Status|

|

.. code:: python


    import chef

    client = chef.ChefClient('https://api.opscode.com')
    # not to be confused with chef-client, the agent :)
    client.authenticate('chef-user', '~/chef-user.pem')
    response = client.get('/users/chef-user')
    response.json()
    ...
    {'display_name': 'chef-user',
     'email': 'chef-user@example.com',
     'first_name': 'Chef',
     'last_name': 'User',
     'middle_name': '',
     'public_key': '-----BEGIN PUBLIC KEY-----\nMIIBIj...IDAQAB\n-----END PUBLIC KEY-----\n',
     'username': 'chef-user'}

Authentication & Authorization
------------------------------

``okchef`` uses the auth handler from the ``requests-chef`` library at
https://github.com/samstav/requests-chef

Install
-------

Before installing ``okchef``, see the current installation instructions
for ``requests-chef``: https://github.com/samstav/requests-chef#install

If you don't feel like reading those, you can use
``--process-dependency-links`` (for now)

::

    $ pip install -U --process-dependency-links okchef

Preferably, you've read the install for ``requests-chef``, so this will
work:

::

    # -U ensures you get the latest version
    $ pip install -U okchef

.. |latest| image:: https://img.shields.io/pypi/v/okchef.svg
   :target: https://pypi.python.org/pypi/okchef
.. |Circle CI| image:: https://circleci.com/gh/samstav/okchef/tree/master.svg?style=shield
   :target: https://circleci.com/gh/samstav/okchef
.. |Coverage Status| image:: https://coveralls.io/repos/samstav/okchef/badge.svg?branch=master
   :target: https://coveralls.io/r/samstav/okchef?branch=master
.. |Requirements Status| image:: https://requires.io/github/samstav/okchef/requirements.svg?branch=master
   :target: https://requires.io/github/samstav/okchef/requirements/?branch=master


