File: README.rst

package info (click to toggle)
systemfixtures 0.6.7-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 332 kB
  • sloc: python: 841; makefile: 221; sh: 2
file content (59 lines) | stat: -rw-r--r-- 1,782 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
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.