pyinfra 0.11.dev3__py3-none-any.whl → 3.5.1__py3-none-any.whl

pyinfra/modules/util/files.py

@@ -1,52 +0,0 @@
-def ensure_mode_int(mode):
-    # Already an int (/None)?
-    if isinstance(mode, int) or mode is None:
-        return mode
-
-    try:
-        # Try making an int ('700' -> 700)
-        return int(mode)
-
-    except (TypeError, ValueError):
-        pass
-
-    # Return as-is (ie +x which we don't need to normalise, it always gets run)
-    return mode
-
-
-def sed_replace(filename, line, replace, flags=None):
-    flags = ''.join(flags) if flags else ''
-
-    line = line.replace('/', r'\/')
-    replace = replace.replace('/', r'\/')
-
-    return 'sed -i="" "s/{0}/{1}/{2}" {3}'.format(
-        line, replace, flags, filename,
-    )
-
-
-def chmod(target, mode, recursive=False):
-    return 'chmod {0}{1} {2}'.format(('-R ' if recursive else ''), mode, target)
-
-
-def chown(target, user, group=None, recursive=False, dereference=True):
-    command = 'chown'
-    user_group = None
-
-    if user and group:
-        user_group = '{0}:{1}'.format(user, group)
-
-    elif user:
-        user_group = user
-
-    elif group:
-        command = 'chgrp'
-        user_group = group
-
-    return '{0}{1}{2} {3} {4}'.format(
-        command,
-        ' -R' if recursive else '',
-        ' -h' if not dereference else '',
-        user_group,
-        target,
-    )

pyinfra/modules/util/packaging.py

@@ -1,118 +0,0 @@
-
-
-def ensure_packages(
-    packages, current_packages, present,
-    install_command, uninstall_command,
-    latest=False, upgrade_command=None,
-    version_join=None, lower=True,
-):
-    '''
-    Handles this common scenario:
-
-    + We have a list of packages(/versions) to ensure
-    + We have a map of existing package -> versions
-    + We have the common command bits (install, uninstall, version "joiner")
-    + Outputs commands to ensure our desired packages/versions
-    + Optionally upgrades packages w/o specified version when present
-
-    Args:
-        packages (list): list of packages or package/versions
-        current_packages (fact): fact returning dict of package names -> version
-        present (bool): whether packages should exist or not
-        install_command (str): command to prefix to list of packages to install
-        uninstall_command (str): as above for uninstalling packages
-        latest (bool): whether to upgrade installed packages when present
-        upgrade_command (str): as above for upgrading
-        version_join (str): the package manager specific "joiner", ie ``=`` for \
-            ``<apt_pkg>=<version>``
-        lower (bool): whether to lowercase package names
-    '''
-
-    if packages is None:
-        return
-
-    # Accept a single package as string
-    if isinstance(packages, str):
-        packages = [packages]
-
-    # Lowercase packaging?
-    if lower:
-        packages = [
-            package.lower()
-            for package in packages
-        ]
-
-    # Version support?
-    if version_join:
-        # Split where versions present
-        packages = [
-            package.rsplit(version_join, 1)
-            for package in packages
-        ]
-
-        # Covert to either string or list
-        packages = [
-            package[0] if len(package) == 1
-            else package
-            for package in packages
-        ]
-
-    # Diff the ensured packages against the remote state/fact
-    diff_packages = []
-
-    # Packages to upgrade? (install only)
-    upgrade_packages = []
-
-    # Installing?
-    if present is True:
-        for package in packages:
-            # Tuple/version, check not in existing OR incorrect version
-            if isinstance(package, list) and (
-                package[0] not in current_packages
-                or package[1] not in current_packages[package[0]]
-            ):
-                diff_packages.append(package)
-
-            # String version, just check if not existing
-            if isinstance(package, str) and package not in current_packages:
-                diff_packages.append(package)
-
-            # Present packages w/o version spec ified - for upgrade if latest
-            if isinstance(package, str) and package in current_packages:
-                upgrade_packages.append(package)
-
-    # Uninstalling?
-    else:
-        for package in packages:
-            # Tuple/version, heck existing AND correct version
-            if isinstance(package, list) and (
-                package[0] in current_packages
-                and package[1] in current_packages[package[0]]
-            ):
-                diff_packages.append(package)
-
-            # String version, just check if existing
-            if isinstance(package, str) and package in current_packages:
-                diff_packages.append(package)
-
-    # Convert packages back to string(/version)
-    diff_packages = [
-        version_join.join(package)
-        if isinstance(package, list)
-        else package
-        for package in diff_packages
-    ]
-
-    if diff_packages:
-        command = install_command if present else uninstall_command
-
-        yield '{0} {1}'.format(
-            command,
-            ' '.join(diff_packages),
-        )
-
-    if latest and upgrade_command and upgrade_packages:
-        yield '{0} {1}'.format(
-            upgrade_command,
-            ' '.join(upgrade_packages),
-        )

pyinfra/modules/vzctl.py

@@ -1,133 +0,0 @@
-'''
-Manage OpenVZ containers with ``vzctl``.
-'''
-
-from pyinfra.api import operation, OperationError
-
-
-@operation
-def start(state, host, ctid, force=False):
-    '''
-    Start OpenVZ containers.
-
-    + ctid: CTID of the container to start
-    + force: whether to force container start
-    '''
-
-    args = ['{0}'.format(ctid)]
-
-    if force:
-        args.append('--force')
-
-    yield 'vzctl start {0}'.format(' '.join(args))
-
-
-@operation
-def stop(state, host, ctid):
-    '''
-    Stop OpenVZ containers.
-
-    + ctid: CTID of the container to stop
-    '''
-
-    args = ['{0}'.format(ctid)]
-
-    yield 'vzctl stop {0}'.format(' '.join(args))
-
-
-@operation
-def restart(state, host, ctid, force=False):
-    '''
-    Restart OpenVZ containers.
-
-    + ctid: CTID of the container to restart
-    + force: whether to force container start
-    '''
-
-    yield stop(state, host, ctid)
-    yield start(state, host, ctid, force=force)
-
-
-@operation
-def mount(state, host, ctid):
-    '''
-    Mount OpenVZ container filesystems.
-
-    + ctid: CTID of the container to mount
-    '''
-
-    yield 'vzctl mount {0}'.format(ctid)
-
-
-@operation
-def unmount(state, host, ctid):
-    '''
-    Unmount OpenVZ container filesystems.
-
-    + ctid: CTID of the container to unmount
-    '''
-
-    yield 'vzctl umount {0}'.format(ctid)
-
-
-@operation
-def delete(state, host, ctid):
-    '''
-    Delete OpenVZ containers.
-
-    + ctid: CTID of the container to delete
-    '''
-
-    yield 'vzctl delete {0}'.format(ctid)
-
-
-@operation
-def create(state, host, ctid, template=None):
-    '''
-    Create OpenVZ containers.
-
-    + ctid: CTID of the container to create
-    '''
-
-    # Check we don't already have a container with this CTID
-    current_containers = host.fact.openvz_containers
-    if ctid in current_containers:
-        raise OperationError(
-            'An OpenVZ container with CTID {0} already exists'.format(ctid),
-        )
-
-    args = ['{0}'.format(ctid)]
-
-    if template:
-        args.append('--ostemplate {0}'.format(template))
-
-    yield 'vzctl create {0}'.format(' '.join(args))
-
-
-@operation
-def set(state, host, ctid, save=True, **settings):
-    '''
-    Set OpenVZ container details.
-
-    + ctid: CTID of the container to set
-    + save: whether to save the changes
-    + settings: settings/arguments to apply to the container
-
-    Settings/arguments:
-        these are mapped directly to ``vztctl`` arguments, eg
-        ``hostname='my-host.net'`` becomes ``--hostname my-host.net``.
-    '''
-
-    args = ['{0}'.format(ctid)]
-
-    if save:
-        args.append('--save')
-
-    for key, value in settings.items():
-        # Handle list values (eg --nameserver X --nameserver X)
-        if isinstance(value, list):
-            args.extend('--{0} {1}'.format(key, v) for v in value)
-        else:
-            args.append('--{0} {1}'.format(key, value))
-
-    yield 'vzctl set {0}'.format(' '.join(args))

pyinfra/modules/yum.py

@@ -1,171 +0,0 @@
-'''
-Manage yum packages and repositories. Note that yum package names are case-sensitive.
-'''
-
-from io import StringIO
-from urllib.parse import urlparse
-
-from pyinfra.api import operation
-
-from . import files
-from .util.packaging import ensure_packages
-
-
-@operation
-def key(state, host, key):
-    '''
-    Add yum gpg keys with ``rpm``.
-
-    + key: filename or URL
-
-    Note:
-        always returns one command, not state checking
-    '''
-
-    yield 'rpm --import {0}'.format(key)
-
-
-@operation
-def repo(
-    state, host, name, baseurl,
-    present=True, description=None, enabled=True, gpgcheck=True, gpgkey=None,
-):
-    '''
-    Add/remove/update yum repositories.
-
-    + name: filename for the repo (in ``/etc/yum/repos.d/``)
-    + baseurl: the baseurl of the repo
-    + present: whether the ``.repo`` file should be present
-    + description: optional verbose description
-    + gpgcheck: whether set ``gpgcheck=1``
-    + gpgkey: the URL to the gpg key for this repo
-    '''
-
-    # Description defaults to name
-    description = description or name
-
-    filename = '/etc/yum.repos.d/{0}.repo'.format(name)
-
-    # If we don't want the repo, just remove any existing file
-    if not present:
-        yield files.file(state, host, filename, present=False)
-        return
-
-    # Build the repo file from string
-    repo_lines = [
-        '[{0}]'.format(name),
-        'name={0}'.format(description),
-        'baseurl={0}'.format(baseurl),
-        'enabled={0}'.format(1 if enabled else 0),
-        'gpgcheck={0}'.format(1 if gpgcheck else 0),
-    ]
-
-    if gpgkey:
-        repo_lines.append('gpgkey={0}'.format(gpgkey))
-
-    repo_lines.append('')
-    repo = '\n'.join(repo_lines)
-    repo = StringIO(repo)
-
-    # Ensure this is the file on the server
-    yield files.put(state, host, repo, filename)
-
-
-@operation
-def rpm(state, host, source, present=True):
-    '''
-    Add/remove ``.rpm`` file packages.
-
-    + source: filename or URL of the ``.rpm`` package
-    + present: whether ore not the package should exist on the system
-
-    URL sources with ``present=False``:
-        If the ``.rpm`` file isn't downloaded, pyinfra can't remove any existing
-        package as the file won't exist until mid-deploy.
-    '''
-
-    # If source is a url
-    if urlparse(source).scheme:
-        # Generate a temp filename (with .rpm extension to please yum)
-        temp_filename = '{0}.rpm'.format(state.get_temp_filename(source))
-
-        # Ensure it's downloaded
-        yield files.download(state, host, source, temp_filename)
-
-        # Override the source with the downloaded file
-        source = temp_filename
-
-    # Check for file .rpm information
-    info = host.fact.rpm_package(source)
-    exists = False
-
-    # We have info!
-    if info:
-        current_packages = host.fact.rpm_packages
-
-        if (
-            info['name'] in current_packages
-            and info['version'] in current_packages[info['name']]
-        ):
-            exists = True
-
-    # Package does not exist and we want?
-    if present and not exists:
-        # If we had info, always install
-        if info:
-            yield 'rpm -U {0}'.format(source)
-
-        # This happens if we download the package mid-deploy, so we have no info
-        # but also don't know if it's installed. So check at runtime, otherwise
-        # the install will fail.
-        else:
-            yield 'rpm -qa | grep `rpm -qp {0}` || rpm -U {0}'.format(source)
-
-    # Package exists but we don't want?
-    if exists and not present:
-        yield 'yum remove -y {0}'.format(info['name'])
-
-
-@operation
-def update(state, host):
-    '''
-    Updates all yum packages.
-    '''
-
-    yield 'yum update -y'
-
-_update = update  # noqa: E305 (for use below where update is a kwarg)
-
-
-@operation
-def packages(
-    state, host, packages=None,
-    present=True, latest=False, update=False, clean=False,
-):
-    '''
-    Install/remove/update yum packages & updates.
-
-    + packages: list of packages to ensure
-    + present: whether the packages should be installed
-    + latest: whether to upgrade packages without a specified version
-    + update: run yum update
-    + clean: run yum clean
-
-    Versions:
-        Package versions can be pinned like yum: ``<pkg>-<version>``
-    '''
-
-    if clean:
-        yield 'yum clean all'
-
-    if update:
-        yield _update(state, host)
-
-    yield ensure_packages(
-        packages, host.fact.rpm_packages, present,
-        install_command='yum install -y',
-        uninstall_command='yum remove -y',
-        upgrade_command='yum update -y',
-        version_join='-',
-        latest=latest,
-    )

pyinfra/pseudo_modules.py

@@ -1,64 +0,0 @@
-'''
-These three pseudo modules (state, inventory, host) are used throughout pyinfra
-and provide the magic that means "from pyinfra import host" inside a deploy
-file always represents the *current* host being executed, ie these modules are
-dynamic and change during execution of pyinfra.
-
-Although CLI only when in use, these are bundled into the main pyinfra package
-as they are utilised throughout (to determine the current state/host when
-executing in CLI mode).
-'''
-
-import sys
-
-import pyinfra
-
-
-class PseudoModule(object):
-    _module = None
-
-    def __getattr__(self, key):
-        return getattr(self._module, key)
-
-    def __setattr__(self, key, value):
-        if key == '_module':
-            return object.__setattr__(self, key, value)
-
-        setattr(self._module, key, value)
-
-    def __getitem__(self, key):
-        return self._module[key]
-
-    def __iter__(self):
-        return iter(self._module)
-
-    def __len__(self):
-        return len(self._module)
-
-    def __eq__(self, other):
-        return self._module == other
-
-    def set(self, module):
-        self._module = module
-
-    def reset(self):
-        self._module = None
-
-    def isset(self):
-        return self._module is not None
-
-
-# The current deploy state
-sys.modules['pyinfra.pseudo_state'] = sys.modules['pyinfra.state'] = \
-    pyinfra.pseudo_state = pyinfra.state = \
-    PseudoModule()
-
-# The current deploy inventory
-sys.modules['pyinfra.pseudo_inventory'] = sys.modules['pyinfra.inventory'] = \
-    pyinfra.pseudo_inventory = pyinfra.inventory = \
-    PseudoModule()
-
-# The current target host
-sys.modules['pyinfra.pseudo_host'] = sys.modules['pyinfra.host'] = \
-    pyinfra.pseudo_host = pyinfra.host = \
-    PseudoModule()

pyinfra-0.11.dev3.dist-info/METADATA

@@ -1,135 +0,0 @@
-Metadata-Version: 2.1
-Name: pyinfra
-Version: 0.11.dev3
-Summary: pyinfra automates/provisions/manages/deploys infrastructure.
-Home-page: http://github.com/Fizzadar/pyinfra
-Author: Nick / Fizzadar
-Author-email: pointlessrambler@gmail.com
-License: MIT
-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 :: 2
-Classifier: Programming Language :: Python :: 3
-Classifier: Topic :: System :: Systems Administration
-Classifier: Topic :: System :: Installation/Setup
-Classifier: Topic :: Utilities
-Description-Content-Type: text/markdown
-Requires-Dist: gevent (!=1.5a1,<2,>1)
-Requires-Dist: paramiko (<3,>1)
-Requires-Dist: click (>2)
-Requires-Dist: colorama (<1)
-Requires-Dist: jinja2 (<3,>2)
-Requires-Dist: python-dateutil (<3,>2)
-Requires-Dist: setuptools
-Requires-Dist: configparser
-Provides-Extra: dev
-Requires-Dist: pytest (==4.6.6) ; extra == 'dev'
-Requires-Dist: pytest-cov (==2.8.1) ; extra == 'dev'
-Requires-Dist: jsontest (==1.4) ; extra == 'dev'
-Requires-Dist: coverage (==4.5.4) ; extra == 'dev'
-Requires-Dist: mock (==3.0.5) ; extra == 'dev'
-Requires-Dist: codecov (==2.0.15) ; extra == 'dev'
-Requires-Dist: flake8 ; extra == 'dev'
-Requires-Dist: flake8-commas ; extra == 'dev'
-Requires-Dist: flake8-quotes ; extra == 'dev'
-Requires-Dist: flake8-import-order ; extra == 'dev'
-Requires-Dist: sphinx (==2.2.1) ; extra == 'dev'
-Requires-Dist: sphinx-autobuild (==0.7.1) ; extra == 'dev'
-Requires-Dist: guzzle-sphinx-theme (==0.7.11) ; extra == 'dev'
-Requires-Dist: recommonmark (==0.5.0) ; extra == 'dev'
-Requires-Dist: wheel ; extra == 'dev'
-Requires-Dist: twine (==3.1.0) ; extra == 'dev'
-Requires-Dist: ipdb (==0.10.3) ; extra == 'dev'
-Requires-Dist: ipdbplugin (==1.4.5) ; extra == 'dev'
-Provides-Extra: docs
-Requires-Dist: sphinx (==2.2.1) ; extra == 'docs'
-Requires-Dist: sphinx-autobuild (==0.7.1) ; extra == 'docs'
-Requires-Dist: guzzle-sphinx-theme (==0.7.11) ; extra == 'docs'
-Requires-Dist: recommonmark (==0.5.0) ; extra == 'docs'
-Provides-Extra: test
-Requires-Dist: pytest (==4.6.6) ; extra == 'test'
-Requires-Dist: pytest-cov (==2.8.1) ; extra == 'test'
-Requires-Dist: jsontest (==1.4) ; extra == 'test'
-Requires-Dist: coverage (==4.5.4) ; extra == 'test'
-Requires-Dist: mock (==3.0.5) ; extra == 'test'
-Requires-Dist: codecov (==2.0.15) ; extra == 'test'
-Requires-Dist: flake8 ; extra == 'test'
-Requires-Dist: flake8-commas ; extra == 'test'
-Requires-Dist: flake8-quotes ; extra == 'test'
-Requires-Dist: flake8-import-order ; extra == 'test'
-
-<h1>
-    <a href="https://pyinfra.com">
-        <img src="https://raw.githubusercontent.com/Fizzadar/pyinfra/master/docs/static/logo_full.png" height="48px" />
-    </a>
-</h1>
-
-[![PyPI version](https://img.shields.io/pypi/v/pyinfra?color=blue)](https://pypi.python.org/pypi/pyinfra)
-[![Docs status](https://img.shields.io/readthedocs/pyinfra)](https://pyinfra.readthedocs.io)
-[![Travis.CI status](https://img.shields.io/travis/Fizzadar/pyinfra/master)](https://travis-ci.org/Fizzadar/pyinfra)
-[![Codecov Coverage](https://img.shields.io/codecov/c/gh/Fizzadar/pyinfra)](https://codecov.io/github/Fizzadar/pyinfra)
-[![MIT Licensed](https://img.shields.io/pypi/l/pyinfra)](https://github.com/Fizzadar/pyinfra/blob/develop/LICENSE.md)
-
-pyinfra automates/provisions/manages/deploys infrastructure super fast at massive scale. It can be used for ad-hoc command execution, service deployment, configuration management and more. Core design features include:
-
-+ 🚀 **Super fast** execution over thousands of targets with predictable performance.
-+ 🚨 **Instant debugging** with stdout + stderr output on error, and `-v` to print it always.
-+ 💻 **Agentless execution** by speaking native SSH/Docker/subprocess depending on the target.
-+ ❗️ **Two stage process** that enables `--dry` runs before making any changes.
-+ 📦 **Extendable** with _any_ Python package as configured & written in standard Python.
-+ 🔌 **Integrated** with Docker, Vagrant & Ansible out of the box.
-
-When you run pyinfra you'll see something like ([non animated version](https://raw.githubusercontent.com/Fizzadar/pyinfra/master/docs/static/example_deploy.png)):
-
-<img width="100%" src="https://raw.githubusercontent.com/Fizzadar/pyinfra/master/docs/static/example_deploy.gif" />
-
-## Quickstart
-
-pyinfra can be installed via pip:
-
-```sh
-pip install pyinfra
-```
-
-Now you can execute commands & operations over SSH:
-
-```sh
-# Execute an abitrary shell command
-pyinfra my-server.net exec -- echo "hello world"
-
-# Install iftop apt package if not present
-pyinfra my-server.net apt.packages iftop sudo=true
-```
-
-These can then be saved to a _deploy file_, let's call it `deploy.py`:
-
-```py
-from pyinfra.modules import apt
-
-apt.packages(
-    {'Install iftop'},
-    'iftop',
-    sudo=True,
-)
-```
-
-And executed with:
-
-```sh
-pyinfra my-server.net deploy.py
-```
-
-## [Documentation](https://pyinfra.readthedocs.io)
-
-+ [Getting started](https://pyinfra.readthedocs.io/page/getting_started.html)
-+ [Writing deploys](https://pyinfra.readthedocs.io/page/deploys.html)
-+ [Using the CLI](https://pyinfra.readthedocs.io/page/cli.html)
-+ [Connectors](https://pyinfra.readthedocs.io/page/connectors.html)
-
-