Skip to main content

Python libraries to assist with writing Linux Ops scripts.

Project description

.. image:: https://img.shields.io/badge/Supported%20by-Clockwork-ffcc00.svg
:alt: badge: Supported by Clockwork
:align: right
:target: https://www.clockwork.com/
OpScripts
=========

.. image:: https://img.shields.io/pypi/v/OpScripts.svg
:alt: badge: Python Package Index version
:align: right
:target: https://pypi.python.org/pypi/OpScripts
.. image:: https://img.shields.io/github/tag/ClockworkNet/OpScripts.svg
:alt: badge: GitHub most recent tag
:align: right
:target: https://github.com/ClockworkNet/OpScripts/tags
Python libraries to assist with writing Linux Ops scripts.


Python Compatibility
====================

This library currently requires compatibility with:


.. image:: https://img.shields.io/pypi/pyversions/OpScripts.svg
:alt: badge: Python Package Index supported Python versions
:align: right
:target: https://pypi.python.org/pypi/OpScripts
- 2.6
- 2.7
- 3.4

.. image:: https://img.shields.io/travis/ClockworkNet/OpScripts/master.svg
:alt: badge: Travis CI master branch status
:align: right
:target: https://travis-ci.org/ClockworkNet/OpScripts
However, additional versions are tested automatically.



API Versioning
==============

Each module is versioned so that they can undergo significant changes without
impacting the function and stability of the scripts that use them.

For example::

from opscripts.config import v6 as ops_config
from opscripts.logging import v2 as ops_logging
from opscripts.utils import v8 as ops_utils

For a more in-depth examples, see the:

- `<example.py>`_
- `<example_notify_email.py>`_
- `<example_yaml.py>`_


Dependencies
============

- ``opscripts.config``

- `ConfigArgParse`_
- `PyYAML`_

- ``opscripts.yaml``

- `ordereddict`_ (only required by Python 2.6)
- `PyYAML`_

- Unit Tests

- `mock`_ (only required by Python < 3.3)
- `pytest`_
- `pytest-catchlog`_
- `pytest-colordots`_
- `pytest-flakes`_
- `pytest-localserver`_
- `pytest-pep8`_
- `pytest-pythonpath`_

.. _`ConfigArgParse`: https://github.com/bw2/ConfigArgParse
.. _`PyYAML`: http://pyyaml.org/wiki/PyYAML
.. _`ordereddict`: https://pypi.python.org/pypi/ordereddict/1.1
.. _`mock`: https://pypi.python.org/pypi/mock
.. _`pytest`: http://pytest.org/latest/
.. _`pytest-catchlog`: https://pypi.python.org/pypi/pytest-catchlog
.. _`pytest-colordots`: https://github.com/svenstaro/pytest-colordots
.. _`pytest-flakes`: https://pypi.python.org/pypi/pytest-flakes
.. _`pytest-localserver`: https://pypi.python.org/pypi/pytest-localserver
.. _`pytest-pep8`: http://pypi.python.org/pypi/pytest-pep8
.. _`pytest-pythonpath`: https://pypi.python.org/pypi/pytest-pythonpath


Testing Quick Start
===================

1. Change directory into repository (into same directory as where this README
resides).
2. Install virtual environment::

mkvirtualenv -a . -r tests/requirements.txt opscripts_test

a. If installing requirements errors, update `pip`::

pip install --upgrade pip

b. Install requirements::

pip install -r tests/requirements.txt

3. Run pytest::

py.test

To test against alternate Python versions, it may be useful to create virtual
environments with an interpreter other than the one with which ``virtualenv``
was installed, e.g. for non-default python3::

mkvirtualenv -a . -p $(which python3) -r tests/requirements.txt opscripts_test3


License
=======

.. image:: https://img.shields.io/github/license/ClockworkNet/OpScripts.svg
:alt: badge: GitHub license (MIT)
:align: right
:target: `MIT License`_
- `<LICENSE>`_ (`MIT License`_)

.. _`MIT License`: http://www.opensource.org/licenses/MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

OpScripts-1.6.7.tar.gz (15.4 kB view details)

Uploaded Source

File details

Details for the file OpScripts-1.6.7.tar.gz.

File metadata

  • Download URL: OpScripts-1.6.7.tar.gz
  • Upload date:
  • Size: 15.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for OpScripts-1.6.7.tar.gz
Algorithm Hash digest
SHA256 04f41d3b169a5eb00bec7f84d34a5c751aa7237a7a4efa689b821d8eae4f335b
MD5 125e1265f6b9a76ab68bca0282982ae5
BLAKE2b-256 db4c1533d6a9dfba3c9770d74111809560caab504a4e31782434ec021e61a136

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page