Skip to main content

General tools for Plone sites

Project description

General tools modules for Plone.

We don’t claim ultimate Plone wisdom (yet); this package is one of the parts a big monolithic classic Zope product was s´plit into.

It is part of the footing of the “Unitracc family” of Plone sites which are maintained by visaplan GmbH, Bochum, Germany.

Some modules of this package might still contain some resources (e.g. type names) which are specific to our “Unitracc family” of sites; this is likely to change in future releases.

Features

This add-on can be seen in action at the following sites:

Modules in version 1.1.4+:

  • attools module

    several tools for Archetypes-based content

  • brains module

    currently one make_collector function, e.g. for address fields

  • cfg module

    Read “product” configuration, and detect development mode

  • context module

    Several tools for processing the request. Some need some modernization …

  • forms module

    Several tools for forms

  • functions module

    Some functions, e.g. is_uid_shaped

  • indexes module (new in v1.1.4)

    • Function getSortableTitle for title conversion.

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

  • log module

    Automatically named loggers

  • mock module

    • a few small classes for use in doctests

    • the same module as visaplan.tools.mock

  • mock_cfg module

    A rudimentary mock module for cfg

  • search module

    A few functions to support creation of ZODB catalog search queries (quite proprietary, I’m afraid; might go away in future versions)

  • setup module (since v1.1)

    Functions for use in migration scripts

  • zcmlgen module (since v1.1.1)

    • Generates configure.zcml files, if

      • changes are detected, and

      • development mode is active, and

      • the source is in an development package.

Documentation

Sorry, we don’t have real user documentation yet.

Most functions are documented by doctests, anyway; it helps to understand some German.

Installation

Since visaplan.plone.tools is a package for Plone instances, it is not normally installed using pip; instead, install it by adding it to your buildout:

[buildout]

...

eggs =
    visaplan.plone.tools

and then running bin/buildout

Contribute

Support

If you are having issues, please let us know; please use the issue tracker mentioned above.

License

The project is licensed under the GPLv2.

Contributors

Changelog

1.2 (unreleased)

  • 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).

1.1.5 (unreleased)

Bugfixes:

  • getConfiguration might fail; in such cases, log a warning and use the default

  • Missing requirements:

    • visaplan.kitchen

[tobiasherp]

1.1.4 (2019-05-09)

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

1.1.3 (2019-01-29)

  • setup.make_renamer(): generated rename function improved: existing positional options default to None; instead of uid, o (object) or brain can be specified (by name).

  • setup.make_query_extractor(), generated extract_query function improved: don’t convert a Language string to a list if it’s value is all

  • zcmlgen module:

    • Bugfix for changes detection

    • If changes are found but disallowed (non-development setup), and if sys.stdout is connected to a terminal, start the debugger

    [tobiasherp]

1.1.2 (2018-11-21)

  • Corrections for the documentation

  • (currently) unused dependencies removed [tobiasherp]

1.1.1 (2018-09-27)

  • zcmlgen module added:

    • Generates configure.zcml files, if

      • changes are detected (buggy; see v1.1.3), and

      • development mode is active, and

      • the source is in a development package.

1.1 (2018-09-17)

  • attools module added:

    • a brown bag of tools for Archetypes

  • brains module added:

    • make_collector, e.g. for address fields

  • forms module added:

    • a brown bag of modules to support forms in a Zope/Plone system

  • mock module added:

    • a few small classes for use in doctests

    • the same module as visaplan.tools.mock

  • mock_cfg module added:

    • accompanies cfg, for testing only

  • search module added:

    • tools for creation of catalog queries

  • setup module added: functions for use in migration scripts

  • Module changes:

    • context module:

      • new function decorated_tool

    • functions module:

      • new function looksLikeAUID (for historical reasons)

1.0 (2018-07-11)

  • Initial release. [tobiasherp]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

visaplan.plone.tools-1.1.5.dev1.tar.gz (65.3 kB view details)

Uploaded Source

File details

Details for the file visaplan.plone.tools-1.1.5.dev1.tar.gz.

File metadata

  • Download URL: visaplan.plone.tools-1.1.5.dev1.tar.gz
  • Upload date:
  • Size: 65.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.4.2 requests/2.19.0 setuptools/41.0.1 requests-toolbelt/0.8.0 tqdm/4.23.4 CPython/2.7.5

File hashes

Hashes for visaplan.plone.tools-1.1.5.dev1.tar.gz
Algorithm Hash digest
SHA256 2f33dc943e7336abb2f1d7507239a0bec786530362ac8ff38f9cb2026faa18c9
MD5 0aad84403fee7b8d9ffa3527acb29350
BLAKE2b-256 9c0dcf26972961b290b432a7ec29b27410ee891d8c2e87dcc4211d613ed63c89

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page