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.7 of our own ResourceSync client and library reference implementation.
This simulator is designed to run under Python 2.7, 3.4, 3.5 and 3.6. Check with:
python --version
Automatic installation:
easy_install resync-simulator
rsync-simulator
is listed in PyPI and can be installed with pip
or easy_install
. Doing an easy_install
should also install the dependencies resync
and tornado
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
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:
CTRL-C
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
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.
Author: Bernhard Haslhofer
Contributors: Simeon Warner