Metadata-Version: 2.1
Name: kotti-toolkit
Version: 1.0.2
Summary: Utilities for Kotti
Home-page: https://github.com/Collective-Kotti/kotti_toolkit
Author: Oshane Bailey
Author-email: b4.oshany@gmail.com
License: BSD-derived (http://www.repoze.org/LICENSE.txt)
Keywords: kotti tools utils web cms wcms pylons pyramid
Platform: UNKNOWN
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Framework :: Pylons
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
Classifier: License :: Repoze Public License
Requires-Dist: click (>=6.6)
Requires-Dist: Kotti (>=1.0.0)
Requires-Dist: kotti-tinymce
Requires-Dist: progress

kotti_toolkit
*******************

This is a toolkit library for Kotti. It adds toolkits for the following components:

- Groups and Users
- Pyramid View Renderers
- Security
- Python list function
- Kotti Content types.

|pypi|_
|downloads_month|_
|license|_
|build_status_stable|_

.. |pypi| image:: https://img.shields.io/pypi/v/kotti_toolkit.svg?style=flat-square
.. _pypi: https://pypi.python.org/pypi/kotti_toolkit/

.. |downloads_month| image:: https://img.shields.io/pypi/dm/kotti_toolkit.svg?style=flat-square
.. _downloads_month: https://pypi.python.org/pypi/kotti_toolkit/

.. |license| image:: https://img.shields.io/pypi/l/kotti_toolkit.svg?style=flat-square
.. _license: http://www.repoze.org/LICENSE.txt

.. |build_status_stable| image:: https://img.shields.io/travis/Collective-Kotti/kotti_toolkit/production.svg?style=flat-square
.. _build_status_stable: http://travis-ci.org/Collective-Kotti/kotti_toolkit

`Find out more about Kotti`_

Development happens at https://github.com/Collective-Kotti/kotti_toolkit

.. _Find out more about Kotti: http://pypi.python.org/pypi/Kotti

Setup
=====

To enable the extension in your Kotti site, activate the configurator::

    kotti.configurators =
        kotti_toolkit.kotti_configure

Database upgrade
================

If you are upgrading from a previous version you might have to migrate your
database.  The migration is performed with `alembic`_ and Kotti's console script
``kotti-migrate``. To migrate, run
``kotti-migrate upgrade --scripts=kotti_toolkit:alembic``.

For integration of alembic in your environment please refer to the
`alembic documentation`_. If you have problems with the upgrade,
please create a new issue in the `tracker`_.

Development
===========

|build_status_master|_

.. |build_status_master| image:: https://img.shields.io/travis/Collective-Kotti/kotti_toolkit/master.svg?style=flat-square
.. _build_status_master: http://travis-ci.org/Collective-Kotti/kotti_toolkit

Contributions to kotti_toolkit are highly welcome.
Just clone its `Github repository`_ and submit your contributions as pull requests.

.. _alembic: http://pypi.python.org/pypi/alembic
.. _alembic documentation: http://alembic.readthedocs.org/en/latest/index.html
.. _tracker: https://github.com/Collective-Kotti/kotti_toolkit/issues
.. _Github repository: https://github.com/Collective-Kotti/kotti_toolkit


History
=========

1.0.1 - 1.0.2
----------------
- Use endswith instead of regex search when querying for principals with a particular email domain name.
- Add a create-user bin script.

1.0.0
----------------

- Add the following users and groups functions found in `kotti_toolkit.security`:
    - search for groups by name using the `find_group` function
    - search for groups and users by email domain name with the `find_groups_by_email_domain` and `find_users_by_email_domain` functions.
    - Easily create groups and users with the `create_group` and `create_user` functions.
- Add a `csv` renderer for **CSV** or excel output, e.g::

    @view_config(name="export-users-status", permission="admin", renderer="csv")
    def export_users(self):
        req_status = self.request.params.get("status", "all")

- Create package with ``pcreate -s kotti kotti_toolkit``.
  [b4oshany]


