Metadata-Version: 2.1
Name: pyinfra
Version: 2.2
Summary: pyinfra automates/provisions/manages/deploys infrastructure.
Home-page: https://pyinfra.com
Author: Nick / Fizzadar
Author-email: pointlessrambler@gmail.com
License: MIT
Project-URL: Documentation, https://docs.pyinfra.com
Project-URL: GitHub, https://github.com/Fizzadar/pyinfra
Description: <p align="center">
            <a href="https://pyinfra.com">
                <img src="https://pyinfra.com/static/logo_readme.png" alt="pyinfra" />
            </a>
        </p>
        
        <p align="center">
            <em>pyinfra automates infrastructure super fast at massive scale</em>
        </p>
        
        <p align="center">
            <a href="https://pypi.python.org/pypi/pyinfra"><img alt="PyPI version" src="https://img.shields.io/pypi/v/pyinfra?color=blue"></a>
            <a href="https://pepy.tech/project/pyinfra"><img alt="PyPi downloads" src="https://pepy.tech/badge/pyinfra"></a>
            <a href="https://docs.pyinfra.com"><img alt="Docs status" src="https://img.shields.io/github/workflow/status/Fizzadar/pyinfra/Generate%20&amp;%20Deploy%20Docs/master?label=docs"></a>
            <a href="https://github.com/Fizzadar/pyinfra/actions?query=workflow%3A%22Execute+tests%22"><img alt="Execute tests status" src="https://img.shields.io/github/workflow/status/Fizzadar/pyinfra/Execute%20tests/master?label=tests"></a>
            <a href="https://codecov.io/github/Fizzadar/pyinfra"><img alt="Codecov Coverage" src="https://img.shields.io/codecov/c/gh/Fizzadar/pyinfra"></a>
            <a href="https://github.com/Fizzadar/pyinfra/blob/2.x/LICENSE.md"><img alt="MIT Licensed" src="https://img.shields.io/pypi/l/pyinfra"></a>
        </p>
        
        ---
        
        <p align="center">
            <a href="https://docs.pyinfra.com"><strong>Documentation</strong></a> &bull;
            <a href="https://docs.pyinfra.com/page/getting-started.html"><strong>Getting Started</strong></a> &bull;
            <a href="https://docs.pyinfra.com/page/examples.html"><strong>Examples</strong></a> &bull;
            <a href="https://docs.pyinfra.com/page/support.html"><strong>Help & Support</strong></a> &bull;
            <a href="https://docs.pyinfra.com/page/contributing.html"><strong>Contributing</strong></a>
        </p>
        
        ---
        
        pyinfra automates/provisions/manages/deploys infrastructure. It can be used for ad-hoc command execution, service deployment, configuration management and more. Design features include:
        
        + 🚀 **Super fast** execution over thousands of hosts with predictable performance.
        + 🚨 **Instant debugging** with stdout & stderr output on error or as required (`-v`|`-vv`|`-vvv`).
        + 📦 **Extendable** with _any_ Python package as configured & written in standard Python.
        + 💻 **Agentless execution** against SSH/Docker/subprocess/winrm hosts.
        + ❗️ **Two stage process** that enables `--dry` runs before executing any changes.
        + 🔌 **Integrated** with Docker, Vagrant/Mech & Ansible out of the box.
        
        When you run pyinfra you'll see something like ([non animated version](https://pyinfra.com/static/example_deploy.png)):
        
        <img width="100%" src="https://pyinfra.com/static/example_deploy.gif" />
        
        ## Quickstart
        
        Install pyinfra with [`pipx`](https://pipxproject.github.io/pipx/) (recommended) or `pip`:
        
        ```
        pipx install pyinfra
        ```
        
        Now you can execute commands on hosts via SSH:
        
        ```sh
        pyinfra my-server.net exec -- echo "hello world"
        ```
        
        Or execute in Docker, on the local machine, and other [connectors](https://docs.pyinfra.com/page/connectors.html):
        
        ```sh
        pyinfra @docker/ubuntu exec -- echo "Hello world"
        pyinfra @local exec -- echo "Hello world"
        ```
        
        As well as executing commands you can define state using [operations](https://docs.pyinfra.com/page/operations.html):
        
        ```sh
        # Install iftop apt package if not present
        pyinfra @docker/ubuntu apt.packages iftop update=true _sudo=true
        ```
        
        Which can then be saved as a Python file like `deploy.py`:
        
        
        ```py
        from pyinfra.operations import apt
        
        apt.packages(
            name="Ensure iftop is installed",
            packages=['iftop'],
            update=True,
            _sudo=True,
        )
        ```
        
        The hosts can also be saved in a file, for example `inventory.py`:
        
        ```py
        targets = ["@docker/ubuntu", "my-test-server.net"]
        ```
        
        
        And executed together:
        
        ```sh
        pyinfra inventory.py deploy.py
        ```
        
        Now you know the building blocks of pyinfra! By combining inventory, operations and Python code you can deploy anything.
        
        See the more detailed [getting started](https://docs.pyinfra.com/page/getting-started.html) or [using operations](https://docs.pyinfra.com/page/using-operations.html) guides. See how to use [inventory & data](https://docs.pyinfra.com/page/inventory-data.html), [global arguments](https://docs.pyinfra.com/page/arguments.html) and [the CLI](https://docs.pyinfra.com/page/cli.html) or check out the [documented examples](https://docs.pyinfra.com/page/examples.html).
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: System :: Installation/Setup
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
Provides-Extra: test
Provides-Extra: docs
Provides-Extra: dev
Provides-Extra: ansible
