Visaplan-plone-tools

------------------

- Breaking changes:

- ``forms.tryagain_url``:

- all options (which are all arguments except the request)
will `need to` be given by name
(which is possible and `recommended already`).

------------------

New Features:

- New module ``groups``

- New `.context` functions

- `getMessenger` (factory):

creates a `message` function which doesn't require
(nor accept) a `context` argument

- `getPath`
- `get_parent`
- `parents`
- `parent_brains`
- `make_brainGetter`
- `make_pathByUIDGetter`
- `make_translator`
- `get_published_templateid`
- `getSupportedLanguageTuples`

- New function ``setup.safe_context_id``

- New function ``search.normalizeQueryString`` (unicode, asterisks)

- `POSKeyError` rescue facility, *for now* provided here:

Inspired by the five.grok_-based ``fix-blobs`` view by Mikko Ohtamaa,
we have two views:

- ``check-blobs`` scans the site object tree for
(Archetypes or Dexterity) objects with broken BLOB attachments
(images or files) and shows them in an HTML list with checkboxes;

- ``check-blobs-delete-selected`` allows to delete the objects
found be be affected.

*Note:* this functionality will likely be moved to a dedicated add-on package;
don't rely on it to exist in *any* other release of this package!

- Optional functionality, depending on

- visaplan.plone.search v1.2.1+
- visaplan.plone.subportals

(both currently not yet on PyPI)

Improvements:

- ``setup`` module:

- If the ``reindex`` function, which was created by the ``make_reindexer`` factory,
was given an object both by `brain` and by itself, it compared those two by identity,
which wouldn't ever match. Now checking for equality.

- New function ``clone_tree`` (from release 1.2.0) now works recursively

- When ``clone_tree`` moves objects from one folder to another, it tries to preserve a useful order;
both functions ``_clone_tree_inner`` and ``_move_objects`` use the new helper ``apply_move_order_options``
to inject a ``sort_on`` key into the query.

- ``context`` module:

- ``message`` function (non-generated; with `context` argument):

The default `mapping` is `None` now.

- `make_permissionChecker` doesn't require the ``checkperm``
adapter any more to be useful

- `make_userdetector` doesn't require the ``auth``
adapter any more to be useful

- Working doctests for ``search`` module

- ``zcmlgen`` module:

- "Constructors" of the generator classes support an optional `skip` argument
(keyword-only)

Hard dependencies removed:

- Products.Archetypes_

if it is not installed, parts of the `.attools` module simply won't work

- visaplan.kitchen_

- visaplan.plone.infohubs_

If not installed, `.forms.form_changes` *requires* a `form` argument
(but it is a stub anyway).

[tobiasherp]

------------------

New utilities:

- ``setup`` module:

- New function ``clone_tree``, using
- function factory ``make_object_getter``
and
- function factory ``make_subfolder_creator``

Both factories have overlapping functionality and might become unified in a future version;
their initial purposes were:

``make_object_getter`` creates a function (usually called ``get_object``)
which tries to *find* a (possibly moved and/or renamed) object,
and then is able to apply a few changes;

``make_subfolder_creator`` creates a function (usually called ``new_folder``)
which creates a new *folder* (unless already present),
and then is able to apply a few changes.

[tobiasherp]

------------------

New modules:

- ``decorators`` module:

- ``returns_json``
(uses simplejson_ if available)

New utilities:

- ``context`` module:

- function factory ``make_timeformatter``

Bugfixes:

- Typo in README corrected.

[tobiasherp]

------------------

Bugfixes:

- ``getConfiguration`` might fail; in such cases, log a warning and use the default
- Missing requirements:

- visaplan.kitchen_

[tobiasherp]

------------------

- ``indexes`` module added:

- Function ``getSortableTitle`` for title conversion.

This converts umlauts etc. to sort them
as equal to their corresponding base vocals,
according to German lexical usage.

- ``attools`` module:

- New function ``notifyedit(context)``

- ``forms`` module:

- ``tryagain_url`` function supports ``var_items`` argument

- bugfix for ``make_input`` function (suppression of ``type`` attribute)

- ``zcmlgen`` module:

- changes detection improved to explicitly ignore added/removed blank lines

- ``context`` module:

- new functions ``message`` and ``getbrain``,
as replacement for some adapters named alike

[tobiasherp]