Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Quick and easy server mocking.

Project description

Quick and easy server mocking.

Installation

Via github:

~$ git clone http://github.com/bprinty/faux.git
~$ cd faux
~$ python setup.py install

Via pip:

~$ pip install faux

Documentation

Documentation for the package can be found here.

Usage

The faux provides utilities for mocking responses from external services during testing. With faux, you can easily serve a directory structure mocking url endpoints for an externally managed service and use that server for testing.

High-Level

For instance, if you have a directory structure that looks like the following:

├── _uuid
├── file
└── query/
    ├── data
    └── arg=test

With the following as contents of the files in that directory structure:

# _uuid
{
    "status": "ok",
    "city": "{{city}}"
}

# file
{
    "status": "ok",
    "month": "{{month}}",
}

# query/arg=test
{
    "status": "ok",
    "arg": "test",
    "digit": {{random_digit}}
}

# query/data
{
    "status": "ok",
    "data": "test"
}

Endpoints mirroring that file structure will be available:

>>> import requests
>>> r = requests.get('http://localhost:1234/4db5fd8c-8aa6-4c29-b979-dab3ce71e64e')
>>> print(r.json())
{
    "status": "ok",
    "city": "Sacramento",
}

>>> r = requests.get('http://localhost:1234/file')
>>> print(r.json())
{
    "status": "ok",
    "month": "05"
}

>>> r = requests.get('http://localhost:1234/query?arg=test')
>>> print(r.json())
{
    "status": "ok",
    "arg": "test",
    "digit": 4
}

>>> r = requests.get('http://localhost:1234/query/data')
>>> print(r.json())
{
    "status": "ok",
    "data": "test"
}

It’s also worth noting (alluded to above) that you can mock arbitrary data in your responses using methods from the faker library. Items like {{city}} and {{month}} above were automatically and randomly filled without outputs from a faker.Faker() object during the request.

One other special file above is the _uuid file, which will return data from the _uuid file whenever a uuid is included as part of the request.

Starting a Server

For the previous example, you can start the server on a specific port using:

.. code-block:: bash
~$ faux serve -P 1234 /path/to/directory

Using Within Tests

One of the most common paradigms for using this software is to mock a service during testing. To do so with this module, you can easily set up a py.test fixture that will run throughout your test session:

import unittest
import pytest

RESOURCES = '/path/to/testing/resources'

@pytest.fixture(scope='session')
def server():
    """
    Set up mock server for testing request caching.
    """
    from faux import Server
    app = Server(__name__, cache=RESOURCES)
    with app.run(port=1234):
        yield
    return

Once you’ve defined the fixture, you can use it on a test class or function like so:

# test function
@pytest.mark.usefixtures("server")
def test_function():
    return


# test class
@pytest.mark.usefixtures("server")
class TestClass(unittest.TestCase):
    def test_method():
        return

With the code above, the server you’re mocking will run throughout your testing session and will gracefully exit when the test session stops.

Other Functionality

To see other functionality provided by the library, please see the documentation.

Questions/Feedback

File an issue in the GitHub issue tracker.

Project details


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
faux-0.0.7-py2.py3-none-any.whl (10.6 kB) Copy SHA256 hash SHA256 Wheel py2.py3
faux-0.0.7.tar.gz (21.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page