Skip to main content

General Python tools

Project description

This is a collection of utility modules for Python projects.

Features

  • buildout module, for buildout-built projects:

    Function checkPathForPackage to check a given package against a versions whitelist. Useful if you like to constain the versions of that package without actually requiring it.

  • coding module:

    Factory functions to create safe_encode resp. safe_decode functions as needed

  • classes module:

    Several simple but useful classes derived from Python dicts, e.g. Mirror and Proxy

  • debug module:

    • trace_this decorator
  • dicts module:

    • several tools to work with standard dictionaries
  • files module:

    • functions related to files; for now make_mtime_checker
  • html module:

    • HtmlEntityProxy - a dict which returns unicode characters when given a named HTML entity
  • http module:

    • extract_hostname (using url.split and raising ValueError)
  • lands0 module:

    • several tools to work with lists and strings
  • minifuncs module:

    • very small functions, for some cases where functions are used as arguments
  • profile module:

    • a StopWatch context manager and @profile decorator
  • sequences module:

    • tools for sequences, e.g. inject_indexes
  • times module:

    • functions related to date and/or time calculations

Documentation

The modules are documented by doctests. Apart from this, we don’t have real user documentation yet (sorry).

Installation

Simply install visaplan.tools by using pip:

pip install visaplan.tools

or by adding it to your buildout:

[buildout]

...

eggs =
    visaplan.tools

and then running bin/buildout

Support

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

License

The project is licensed under the GNU General Public License v2 (GPLv2).

Contributors

Changelog

1.2.3 (2019-01-30)

  • new function update_dict in dicts module (which takes a deletions list argument)
  • buildout.extract_package_and_version supports egg specs with subpaths as well (child of an /eggs/ directory)
  • buildout.checkPathForPackage logs the invalid package entries if the package in question could not be found
  • lands0.groupstring supports cumulate option (default: False) [tobiasherp]

1.2.2 (2018-11-08)

  • new module buildout for use in buildout-built projects: use the checkPathForPackage function to check an installed package against a versions whitelist [tobiasherp]

1.2.1 (2018-09-17)

  • new module dates:
    • make_date_parser factory to create a parse_date function which understands multiple date formats
    • make_date_formatter factory to create a function which formats date, given as a datetime object or a tuple of int
  • new module profile:
    • StopWatch context manager and @profile decorator
  • new module mock:
    • a few small classes for use in doctests
    • the same module as visaplan.plone.tools.mock
  • module debug:
    • new decorators trace_this, log_result
    • new function print_indented
    • new factory function make_sleeper
  • module dicts:
    • new function make_key_injector
  • module minifuncs:
    • new function translate_dummy
  • module sequences:
    • new function nocomment_split
    • new function columns [tobiasherp]
  • module lands0:
    • new function join_stripped
  • License changed to GPLv2

1.2 (2018-07-11)

  • breaking changes:
    • classes: Proxy is now a factory rather than a class
  • modules debug, dicts, lands0, minifuncs [tobiasherp]

1.1 (2018-06-12)

  • modules sequences, times, files
  • Minor Bugfixes [tobiasherp]

1.0 (2018-06-11)

  • Initial release, including modules classes, html, http and coding [tobiasherp]

Project details


Download files

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

Files for visaplan.tools, version 1.2.3
Filename, size File type Python version Upload date Hashes
Filename, size visaplan.tools-1.2.3.tar.gz (53.6 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page