Metadata-Version: 2.1
Name: hvac
Version: 0.7.2
Summary: HashiCorp Vault API client
Home-page: https://github.com/hvac/hvac
Author: Ian Unruh <ianunruh@gmail.com>, Jeffrey Hogan <jeff.hogan1@gmail.com>
Author-email: admin@python-hvac.org
License: UNKNOWN
Description: # hvac
        
        ![Header image](https://raw.githubusercontent.com/hvac/hvac/master/docs/_static/hvac_logo_800px.png)
        
        [HashiCorp](https://hashicorp.com/) [Vault](https://www.vaultproject.io) API client for Python 2.7/3.x
        
        [![Travis CI](https://travis-ci.org/hvac/hvac.svg?branch=master)](https://travis-ci.org/hvac/hvac)
        [![codecov](https://codecov.io/gh/hvac/hvac/branch/master/graph/badge.svg)](https://codecov.io/gh/hvac/hvac)
        [![Documentation Status](https://readthedocs.org/projects/hvac/badge/)](https://hvac.readthedocs.io/en/latest/?badge=latest)
        [![PyPI version](https://badge.fury.io/py/hvac.svg)](https://badge.fury.io/py/hvac)
        [![Twitter - @python_hvac](https://img.shields.io/twitter/follow/python_hvac.svg?label=Twitter%20-%20@python_hvac&style=social?style=plastic)](https://twitter.com/python_hvac)
        
        Tested against the latest release, HEAD ref, and 3 previous major versions (counting back from the latest release) of Vault. 
        Currently supports Vault v0.9.6 or later.
        
        ## Documentation
        
        Documentation for this module is hosted on [readthedocs.io](https://hvac.readthedocs.io/en/latest/).
        
        ## Getting started
        
        ### Installation
        
        ```bash
        pip install hvac
        ```
        or
        ```bash
        pip install "hvac[parser]"
        ```
        if you would like to be able to return parsed HCL data as a Python dict for methods that support it.
        
        ### Initialize the client
        
        ```python
        import os
        
        import hvac
        
        # Using plaintext
        client = hvac.Client()
        client = hvac.Client(url='http://localhost:8200')
        client = hvac.Client(url='http://localhost:8200', token=os.environ['VAULT_TOKEN'])
        
        # Using TLS
        client = hvac.Client(url='https://localhost:8200')
        
        # Using TLS with client-side certificate authentication
        client = hvac.Client(url='https://localhost:8200', cert=('path/to/cert.pem', 'path/to/key.pem'))
        
        # Using Namespace
        client = hvac.Client(url='http://localhost:8200', token=os.environ['VAULT_TOKEN'], namespace=os.environ['VAULT_NAMESPACE'])
        
        ```
        
        ### Read and write to secret backends
        
        ```python
        client.write('secret/foo', baz='bar', lease='1h')
        
        print(client.read('secret/foo'))
        
        client.delete('secret/foo')
        ```
        
        ### Authenticate using token auth backend
        
        ```python
        # Token
        client.token = 'MY_TOKEN'
        assert client.is_authenticated() # => True
        ```
        
Keywords: hashicorp,vault
Platform: UNKNOWN
Classifier: License :: OSI Approved :: Apache Software License
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.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Description-Content-Type: text/markdown
Provides-Extra: parser
