Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

ResourceSync source simulator

Project description

ResourceSync Simulator

Build status Test coverage

The ResourceSync Simulator simulates a ResourceSync Source, which is a server that hosts resources subject to synchronization.

Any ResourceSync-compliant client can be used to synchronize a Destination with the simulated Source. This version of the simulator is written against v1.0 of the ResourceSync specification and has been tested with v1.0.9 of our own ResourceSync client and library reference implementation.

Installation

This simulator is designed to run under Python 3. Check with

python --version

Automatic installation

pip install resync-simulator

rsync-simulator is listed in PyPI and can be installed with pip or easy_install. Either installation method should also dependencies if they are not already on your system.

Manual installation from github

Install the resync library code and the Tornado web server (you might need to use sudo depending on you local setup)

pip install resync tornado

Get the ResourceSync Simulator from Github

git clone git://github.com/resync/resync-simulator.git

Quick Start

Run the source simulator (with the default configuration in ./config/default.yaml

./resync-simulator

Access from a web browser as http://localhost:8888/

Terminate the source simulator with CTRL-C

How to define parameterized use cases

Parameterized Use Cases can be defined by creating a YAML configuration file (e.g., simulation1.yaml and defining a set of parameters

source:
    name: ResourceSync Simulator with 1000 resources
    number_of_resources: 1000
    change_delay: 2
    event_types: [create, update, delete]
    average_payload: 1000
    max_events: -1
    stats_interval: 10

Additional resource_list_builder and change memory implementations can be attached for simulation purposes. For instance, the following configuration attaches a change memory implemented by the DynamicChangeList class

resource_list_builder:
    class: DynamicResourceListBuilder
    uri_path: resourcelist.xml

changememory:
    class: DynamicChangeList
    uri_path: changelist.xml
    max_changes: 1000

See the examples in the ./config directory for further details.

See also

Author and Contributors

Author: Bernhard Haslhofer

Contributors: Simeon Warner

Project details


Download files

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

Files for resync-simulator, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size resync_simulator-1.1.0-py3-none-any.whl (17.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size resync-simulator-1.1.0.tar.gz (14.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page