sphinx/doc/usage/advanced/websupport/storagebackends.rst
Stephen Finucane 71e8477597 doc: Add "websupport" to usage guide
Signed-off-by: Stephen Finucane <stephen@that.guru>
2018-11-16 13:23:06 +01:00

50 lines
1.2 KiB
ReStructuredText

.. _storagebackends:
.. currentmodule:: sphinxcontrib.websupport.storage
Storage Backends
================
To create a custom storage backend you will need to subclass the
:class:`StorageBackend` class. Then create an instance of the new class and
pass that as the `storage` keyword argument when you create the
:class:`~.WebSupport` object::
support = WebSupport(srcdir=srcdir,
builddir=builddir,
storage=MyStorage())
For more information about creating a custom storage backend, please see the
documentation of the :class:`StorageBackend` class below.
.. class:: StorageBackend
Defines an interface for storage backends.
.. versionchanged:: 1.6
StorageBackend class is moved to sphinxcontrib.websupport.storage from
sphinx.websupport.storage.
Methods
-------
.. automethod:: StorageBackend.pre_build
.. automethod:: StorageBackend.add_node
.. automethod:: StorageBackend.post_build
.. automethod:: StorageBackend.add_comment
.. automethod:: StorageBackend.delete_comment
.. automethod:: StorageBackend.get_data
.. automethod:: StorageBackend.process_vote
.. automethod:: StorageBackend.update_username
.. automethod:: StorageBackend.accept_comment