Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Helps to benchmark code for Autodesk Maya

Project Description

Revl is a Python library that helps to benchmark code for Autodesk Maya.

Upon writing a piece of code for Maya, it might be interesting to know how it performs under different conditions, such as within scenes that are large or small, that define a deep DAG hiearchy or a flat one, that use many node types or only a few, and so on.

Following sets of user-provided commands, Revl can pseudo-randomly generate Maya scenes with different properties against which the behaviour of a piece of code can be observed.

The random nature of the process can also help revealing potential bugs by exposing edge cases that were not thought of, thus making it also a good tool for unit testing. See Wikipedia’s Fuzzing page.

Note that Revl does not provide any sort of profiling tool to measure performances. The built-in timeit module as well as other open-source packages can be used for this purpose.

Features

  • generates scenes by running commands a given total number of times.
  • fine control over the probability distribution for each command.
  • scene generations are reproducible using a fixed seed.
  • extensible with custom commands.
  • allows for fuzz testing.
  • fast (using Maya’s API, not the command layer).

Usage

>>> import revl
>>> commands = [
...     (4.0, revl.createTransform,),
...     (1.0, revl.createPrimitive, (), {'parent': True}),
... ]
>>> count = 100
>>> revl.run(commands, count, seed=1.23)

In this example, Revl invokes a total of 100 evaluations inequally shared between the two distinct commands provided, leading to create approximatively 80% of transforms, and 20% of primitives (plus their associated transforms). Also, the primitive type is picked randomly, and each primitive’s transform is randomly parented under another transform from the scene, possibly creating a scene with a deep DAG hierarchy.

See the Tutorial section from the documentation for more detailed examples and explanations on how to use Revl.

Documentation

Read the documentation online at revl.readthedocs.io or check its source in the doc directory.

Out There

Projects using Revl include:

Author

Christopher Crouzet <christophercrouzet.com>

Release History

Release History

This version
History Node

0.2.0

History Node

0.1.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
revl-0.2.0-py2.py3-none-any.whl (11.4 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Jan 18, 2017
revl-0.2.0.tar.gz (20.1 kB) Copy SHA256 Checksum SHA256 Source Jan 18, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting