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

provides an archetypes storage which stores files on the filesystem into a mercurial repository

Project Description


raptus.mercurialstorage depends on Products.ExternalStorage 0.7 which has some flaws and needs to be patched in order to work correctly. The patch may be applied by using the following part in your buildout:

recipe = iw.recipe.cmd:py
on_install = true
on_update = true
cmds =
    >>> import os
    >>> patch = os.path.join("""${buildout:directory}""".strip(), 'eggs/raptus.mercurialstorage-0.4-py2.4.egg/raptus/mercurialstorage', 'es.patch')
    >>> file = os.path.join("""${buildout:directory}""".strip(), 'eggs/Products.ExternalStorage-0.7-py2.4.egg/Products/ExternalStorage/')
    >>> if os.path.exists(file):
    >>>     os.system('patch -N %s %s' % (file, patch))

You also need mercurial working copies at the root of your storages so if you have a field on which you use an ExternalMercurialStorage with a prefix of foo make sure a folder with the name foo exists in your instances var folder and is initialized using ‘hg init’. If you are using buildout, there are two var folders, one in your buildout’s root and one at parts > instance, the aforementioned folder has to be created in the latter one.

All the mercurial commits are handled asynchronous using a queue, as a side effect the files saved to mercurial storage are not immediately visible in plone, in this case a attribute called ‘asynch’ is set on the content instance, which may be used to display an information message to the user. The mentioned queue is processed by a view named ‘processMercurialActionQueue’ which has to be called regularly by a user having the ‘Manage portal’ permission. It is suggested to use zope clock server to call this view about ever minute or more, add the following configuration to your instance part’s zope-conf-additional variable:

  method [PATH_TO_YOUR_PLONE_SITE]@@processMercurialActionQueue
  period 60
  password [MANAGER_PWD]
  host localhost

raptus.mercurialstorage logs to a different log file which is found in your log folder under the name mercurial.log.


0.4 - (2010-04-12)

  • fixed README.txt (adjusted patch file location)
  • fixed ReST format (README)
  • bugfix in recursiveDelete method which raised an exception in some cases and caused the action queue to hang

0.3 - (2010-02-19)

  • bugfix in datamanager (no longer logs empty lines)
  • bugfix in queue (commit transaction after changing asynch flag)

0.2 - (2010-02-19)

  • improved queue to compare appended action with previous ones and skipping them if needed
  • bugfix in datamanager (repo not found under linux)

0.1 - (2009-10-30)

  • Initial release
Release History

Release History

History Node


History Node


History Node


History Node


History Node


This version
History Node


History Node


History Node


History Node


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
raptus.mercurialstorage-0.4.tar.gz (11.7 kB) Copy SHA256 Checksum SHA256 Source Apr 12, 2010

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