Metadata-Version: 2.1
Name: wagtail-inventory
Version: 0.7
Summary: Lookup Wagtail pages by block content
Home-page: https://github.com/cfpb/wagtail-inventory
Author: CFPB
Author-email: tech@cfpb.gov
License: CCO
Platform: UNKNOWN
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.10
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 2.0
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
Classifier: Framework :: Wagtail
Classifier: Framework :: Wagtail :: 1
Classifier: Framework :: Wagtail :: 2
Classifier: License :: CC0 1.0 Universal (CC0 1.0) Public Domain Dedication
Classifier: License :: Public Domain
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: Django (<2.3,>=1.8)
Requires-Dist: tqdm (==4.15.0)
Requires-Dist: wagtail (<2.6,>=1.8)
Provides-Extra: testing
Requires-Dist: coverage (>=3.7.0) ; extra == 'testing'
Requires-Dist: flake8 (>=2.2.0) ; extra == 'testing'
Requires-Dist: mock (>=1.0.0) ; extra == 'testing'

.. image:: https://travis-ci.org/cfpb/wagtail-inventory.svg?branch=master
  :alt: Build Status
  :target: https://travis-ci.org/cfpb/wagtail-inventory

wagtail-inventory
=================

Search Wagtail pages by block type.

Wagtail Inventory adds the ability to search pages in your Wagtail site by the StreamField block types they contain. It adds a new Settings menu to the Wagtail admin site that allows you to search for pages that do or do not contain certain blocks. It supports searching both by Wagtail built-in blocks (like ``CharBlock``) as well as any custom blocks you might define.

Setup
-----

Install the package using pip:

.. code-block:: bash

  $ pip install wagtail-inventory

Add ``wagtailinventory`` as an installed app in your Django settings:

.. code-block:: python

  # in settings.py
  INSTALLED_APPS = (
      ...
      'wagtailinventory',
      ...
  )

Run migrations to create required database tables:

.. code-block:: bash

  $ manage.py migrate wagtailinventory

Run a management command to initialize database tables with current pages:

.. code-block:: bash

  $ manage.py block_inventory

You should now be able to search your pages in the Wagtail admin site, under Settings > Block Inventory.

Compatibility
-------------

This code has been tested for compatibility with:

* Python 2.7, 3.5, 3.6
* Django 1.8 - 1.11, 2.0 - 2.2
* Wagtail 1.8 - 1.13, 2.0 - 2.5

Testing
-------

Run unit tests with ``tox`` to test against select supported package combinations.

Open source licensing info
--------------------------

#. `TERMS <https://github.com/cfpb/wagtail-inventory/blob/master/TERMS.md>`_
#. `LICENSE <https://github.com/cfpb/wagtail-inventory/blob/master/LICENSE>`_
#. `CFPB Source Code Policy <https://github.com/cfpb/source-code-policy>`_


