Skip to content

A suite of tools that extends Wagtail's already-awesome StreamField to make it even more flexible/versatile/useful!

License

Notifications You must be signed in to change notification settings

WGBH/wagtail-streamfieldtools

Repository files navigation

wagtail-streamfieldtools

Travis CI Status Coverage Percentage Downloads Latest Version

A suite of tools that extends Wagtail's already-awesome StreamField to make it even more flexible/versatile/useful!

Includes:

  • A simple interface for displaying the individual blocks of a StreamField in any number of renditions.
  • A 'block registry' (and its associated field, RegisteredBlockStreamField) that makes blocks pluggable/re-usable across disparate models/apps/projects.

Compatibility

  • Python:
    • 2.7
    • 3.4
    • 3.5
  • Wagtail:
    • 1.2
    • 1.3
    • 1.4

Note

If you want to use Python 3.3 or Wagtail 1.1 install the 0.2 release.

Installation

First, install with:

$ pip install wagtail-streamfieldtools

After installation completes, add 'streamfield_tools' to INSTALLED_APPS:

INSTALLED_APPS = (
    # All your other apps here
    'streamfield_tools',
)

Running Tests

To run tests, first create a new virtual environment and install the test requirements:

$ virtualenv TEST_ENV
$ pip install -r test_requirements.txt

Then run the test suite with this command:

$ coverage run --source streamfield_tools/ runtests.py

If all tests pass, then push your code to Github where Travis CI will tests against the entire dependency matrix. If [all tests passed there](https://travis-ci.org/WGBH/wagtail-streamfieldtools), then [head over to Coveralls](https://coveralls.io/github/WGBH/wagtail-streamfieldtools) to ensure your coverage has remained the same.

If the tests passed and coverage remained the same then it's time to release to PyPI!

About

A suite of tools that extends Wagtail's already-awesome StreamField to make it even more flexible/versatile/useful!

Resources

License

Stars

Watchers

Forks

Packages

No packages published