Metadata-Version: 2.1
Name: podman
Version: 1.6.0
Summary: A library to interact with a Podman server
Home-page: https://github.com/containers/python-podman
Author: Jhon Honce
Author-email: jhonce@redhat.com
License: Apache Software License
Project-URL: Bug Tracker, https://github.com/containers/python-podman/issues
Project-URL: Source Code, https://github.com/containers/python-podman
Description: # podman - pythonic library for working with varlink interface to Podman
        
        [![Build Status](https://travis-ci.org/containers/python-podman.svg?branch=master)](https://travis-ci.org/containers/python-podman)
        ![PyPI](https://img.shields.io/pypi/v/podman.svg)
        ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/podman.svg)
        ![PyPI - Status](https://img.shields.io/pypi/status/podman.svg)
        
        ## Status: Active Development
        
        See [libpod](https://github.com/containers/python-podman)
        
        ## Overview
        
        Python podman library.
        
        Provide a stable API to call into.
        
        ## Releases
        
        ### Requirements
        
        * Python 3.5+
        * OpenSSH 6.7+
        * Python dependencies in requirements.txt
        
        ### Install
        
        #### From pypi
        
        Install `python-podman` to the standard location for third-party
        Python modules:
        
        ```sh
        python3 -m pip install podman
        ```
        
        To use this method on Unix/Linux system you need to have permission to write
        to the standard third-party module directory.
        
        Else, you can install the latest version of python-podman published on
        pypi to the Python user install directory for your platform.
        Typically ~/.local/. ([See the Python documentation for site.USER_BASE for full
        details.](https://pip.pypa.io/en/stable/user_guide/#user-installs))
        You can install like this by using the `--user` option:
        
        ```sh
        python3 -m pip install --user podman
        ```
        
        This method can be useful in many situations, for example,
        on a Unix system you might not have permission to write to the
        standard third-party module directory. Or you might wish to try out a module
        before making it a standard part of your local Python installation.
        This is especially true when upgrading a distribution already present: you want
        to make sure your existing base of scripts still works with the new version
        before actually upgrading.
        
        For further reading about how python installation works [you can read
        this documentation](https://docs.python.org/3/install/index.html#how-installation-works).
        
        #### By building from source
        
        To build the podman egg and install as user:
        
        ```sh
        cd ~/python-podman
        python3 setup.py clean -a && python3 setup.py sdist bdist
        python3 setup.py install --user
        ```
        
        ## Code snippets/examples:
        
        ### Show images in storage
        
        ```python
        import podman
        
        with podman.Client() as client:
          list(map(print, client.images.list()))
        ```
        
        ### Show containers created since midnight
        
        ```python
        from datetime import datetime, time, timezone
        
        import podman
        
        midnight = datetime.combine(datetime.today(), time.min, tzinfo=timezone.utc)
        
        with podman.Client() as client:
            for c in client.containers.list():
                created_at = podman.datetime_parse(c.createdat)
        
                if created_at > midnight:
                    print('Container {}: image: {} created at: {}'.format(
                        c.id[:12], c.image[:32], podman.datetime_format(created_at)))
        ```
        
        CHANGES
        =======
        
        1.6.0
        -----
        
        * Update code and tests for changes in API
        * Update code and tests for changes in API
        * Introduce mocked unit tests
        * Refactor for changes in containers API
        * ModuleNotFoundError: No module named 'pbr'
        * Improve testing
        * Apply pep8 and clean code
        * remove redundant license file
        * How to install from pypi
        
        0.0.3
        -----
        
        * API version retrieval
        * Fix pypi deployment by using documentation at markdown format
        * Introduce python 3.7 support
        
        v0.12.0
        -------
        
        * More packaging
        
        v0.0.2
        ------
        
        * Fix up pushing to pypi
        
        v0.0.1
        ------
        
        * Pull image function throws KeyError for id
        * Secure Travis
        * Introduce travis-ci and autodeployments on tags
        * Improve packaging by using PBR
        * Add base requirements to README.md
        * Remove pypodman to python-pypodman repo
        * Update module to align with varlink API changes
        * Use GetVersion instead of Ping, as recommended
        * Improve README
        * pypodman: add options to handle ssh host keys
        * Update README.md
        * add missing bits
        * Initial copy from containers/libpod
        * Initial commit
        
        Anders F Björklund <anders.f.bjorklund@gmail.com>
        Brent Baude <bbaude@redhat.com>
        Daniel J Walsh <dwalsh@redhat.com>
        Dhanisha Phadate <phadate.d@husky.neu.edu>
        Hervé Beraud <hberaud@redhat.com>
        Jhon Honce <jhonce@redhat.com>
        Jhon Honce <jwhonce@gmail.com>
        vmulaje <vmulaje@redhat.com>
        
        
Keywords: varlink,libpod,podman
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Software Development
Description-Content-Type: text/markdown
Provides-Extra: test
Provides-Extra: devel
