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!
Project Description

Overview

This add-on for Zope and Plone aims to provide user-friendly automatically generated documentation about workflow definitions.

Currently the following Zope3-style views for Products.DCWorkflow.interfaces.IDCWorkflowDefinition are provided:

  • @@wf-graph: Render an image representing the workflow’s states and transitions as a graph.
  • @@wf-doc: Render an HTML page describing the workflow. This includes the graph mentioned above.
  • @@wf-doc-user-friendly: Same as @@wf-doc but hides some roles and permissions and the “acquire” column.
  • @@wf-validate: Validate the workflow according to a set of general rules.

Requirements

  • Tested with Plone 4.3.x. However only Zope 2 is required (hopefuly).
  • Graphviz. More precisely: there must be an executable called dot in the system path and the user running Zope must have execute permission on it.
  • Other requirements are pure Python packages registered on PyPI and distutils should handle them without problems.

Warning

It was not tested on Windows. I suspect it won’t work because of the name of the executable, i.e dot != dot.exe.

Installation

This package is easy_install’able. Just make it available in your Zope Instance and don’t forget to load its ZCMLs. If you don’t have any idea of what I’m talking about please refer to Installing an Add-on Product.

Usage

Just use the provided views on an workflow definition. Examples (type these URLs in your browser):

You can pass the following parameters to @@wf-graph in the query string: hide_roles and hide_permissions. These are lists of things to hide in the output, separated by “.”. Example:

There’s also the hide_acquire parameter, which hides the “acquired” column.

To-do

  • Render an HTML image map, so the user can click on a state or transition and see its description.
  • Test and adapt for Windows.
  • Make the location of the dot executable configurable.
  • Write automatic tests.

Credits

  • Author: Rafael Oliveira <rafaelbco@gmail.com>
  • The idea of using Zope3-style views to render information about workflow definitions and to do sanity check on workflows was inspired by Martin Aspeli’s collective.wtf.

Contribute and report bugs

Help is welcome. Contact the author or file a ticket at the Issue tracker.

Thanks

  • To lucmult, for reporting the bug #2 (the one fixed in 0.0.3).

History

1.0.0 (2015-08-27)

  • Plone 4.3.x compatibility.
  • Workflow validation (@@wf-validate view and correspondent function).

0.0.4 (2011-06-13)

  • Implemented i18n.
  • Added z3c.autoinclude.plugin entry point.
  • Now @@wf-doc uses main_template.
  • Added @@wf-doc-user-friendly.

0.0.3 (22-november-2009)

  • Corrected packaging error: README.txt was not included in the released tarball :-(.

0.0.2 (22-november-2009)

  • Added “acquired” column to @@wf-doc.

0.0.1 (03-june-2009)

  • First release.
Release History

Release History

1.0.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.4

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.3

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

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
rbco.wfdocumentator-1.0.0.zip (19.5 kB) Copy SHA256 Checksum SHA256 Source Aug 27, 2015

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