kotti-toolkit 1.0.1

Utilities for Kotti

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
----------------
- 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]