Metadata-Version: 2.1
Name: systemfixtures
Version: 0.6.7
Summary: Test fixtures for providing fake versions of various system resources (processes, users, groups, etc.)
Home-page: https://github.com/testing-cabal/systemfixtures
Author: Free Ekanayaka
Author-email: free@ekanayaka.io
License: MIT
Platform: POSIX
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
License-File: LICENSE
License-File: AUTHORS
Requires-Dist: pbr
Requires-Dist: six
Requires-Dist: fixtures
Requires-Dist: testtools
Requires-Dist: requests-mock
Requires-Dist: fakesleep
Requires-Dist: subprocess32; python_version < "3.5"
Provides-Extra: test
Requires-Dist: coverage>=4.2; extra == "test"
Requires-Dist: sphinx; extra == "test"

System fixtures
===============

.. image:: https://img.shields.io/pypi/v/systemfixtures.svg
    :target: https://pypi.python.org/pypi/systemfixtures
    :alt: Latest Version

.. image:: https://travis-ci.org/testing-cabal/systemfixtures.svg?branch=master
    :target: https://travis-ci.org/testing-cabal/systemfixtures
    :alt: Build Status

.. image:: https://coveralls.io/repos/github/testing-cabal/systemfixtures/badge.svg?branch=master
    :target: https://coveralls.io/github/testing-cabal/systemfixtures?branch=master
    :alt: Coverage

.. image:: https://readthedocs.org/projects/systemfixtures/badge/?version=latest
    :target: http://systemfixtures.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

A collection of Python fixtures_ to fake out  various system resources (processes,
users, groups, etc.).

.. _fixtures: https://github.com/testing-cabal/fixtures

Each fake resource typically behaves as an "overlay" on the real resource, in
that it can be programmed with fake behavior for a set of inputs, but falls
back to the real behavior for the rest.

.. code:: python

   >>> import pwd

   >>> from systemfixtures import FakeUsers

   >>> users = FakeUsers()
   >>> users.setUp()

   >>> pwd.getpwnam("foo")
   Traceback (most recent call last):
   ...
   KeyError: 'getpwnam(): name not found: foo'

   >>> users.add("foo", 123)
   >>> info = pwd.getpwnam("foo")
   >>> info.pw_uid
   123
   >>> users.cleanUp()

Support and Documentation
-------------------------

See the `online documentation <http://systemfixtures.readthedocs.io/>`_ for
a complete reference.

Developing and Contributing
---------------------------

See the `GitHub project <https://github.com/testing-cabal/systemfixtures>`_. Bugs
can be filed in the issues tracker.

