lck.django 0.5.8

Various common Django-related routines.

This library consists of various Django-related routines that extend or modify the behaviour of the framework:

• extensions for settings.py (current directory resolution, namespace package support, settings profile support)

• Choices: an enum implementation for Django forms and models (with predefined classes for languages, countries, etc.)

• typical filters, template tags, models, form fields, etc.

Complete documentation for the package can be found here:

http://packages.python.org/lck.django/

The latest version can be installed via PyPI:

$ pip install lck.django

or:

$ easy_install lck.django

The source code repository and issue tracker are maintained on GitHub.

This package bundles some royalty free static images that are useful in almost every Django project:

• Silk icons 1.3 by FamFamFam - requires attributing the author

• Silk Companion 1 by Damien Guard - requires attributing the author

• Country Flags by SenojFlags.com - requires using the following HTML:

  <a href="http://www.senojflags.com">Country flag</a> image from <a href="http://www.senojflags.com">Flags of all Countries</a>

For the curious, lck stands for LangaCore Kit. LangaCore is a one man software development shop of mine.

Note: lck.common requires Python 2.7 because all of its code is using the so-called four futures (absolute_imports, division, print_function and unicode_literals). One of the virtues in the creation of this library is to make the code beautiful. These switches give a useful transitional state between the old Python 2.x and the new Python 3.x. You should use them as well.

Note: Since 0.5.0 lck.django requires Django 1.3 because it makes my monkey-patching efforts much easier. Moreover, 1.3 nicely deprecates behaviour which I consider ugly.

Change Log

0.5.8

• Simplistic TimingMiddleware introduced.

• Profiles based on BaseProfile now return self for get_profile().

• Trophy icons added.

• Console tag library introduced with the {%color%} tag.

• Allow rendering non-request contexts.

• Choices.ToNames decorator introduced.

• Pre-importing in manage.py shell works also for models with a custom``app_model``.

0.5.7

• EditorTrackable introduced

• Choices can be rendered in grouped form. Currently requires adding '--keyword=Group:2 ' to xgettext invocations in django/core/managemenet/commands/makemessages.py. Cleaning that up is planned for 0.6.0.

• typical_handler works now with forms w/o a save() method

• upperfirst filter introduced: ups only the first character

• Square thumbnails for wide images now work properly

• moved contents of helpers to common (enables i18n and cleans up the API), the helpers module is therefore deprecated

• some i18n updates

0.5.6

• in the thumbnail filter, support for automatic cropping to square introduced

• minor translation updates

0.5.5

• group members inherit shifted attributes

0.5.4

• minor updates to PolishDateWidget

0.5.3

• AvatarSupport abstract model for custom avatars. GravatarSupport can be used as fallback or independently.

• typical_handler now properly supports file uploads

• bugfixes: objects without any score don’t cause exceptions anymore

• leftovers from namespace changes cleaned up

0.5.2

• monkey patches of core Django annotated and regrouped for easier management in the future (yup, more to come)

• a stats calculator

• minor bugfixes

0.5.1

• tags now support models with custom managers

• for Named and Titled models a read-only name_urlencoded and title_urlencoded properties were introduced. Useful as arguments in template tags.

• support for setting additional attributes on choices using an unholy << operator overload

• in tags, support for getting objects marked with specific stems

0.5.0

• migrated to the lck namespace from langacore.kit

• migrated licensing from GPL 3 to MIT

• bumped the trove from alpha status to beta, the code is in production for over a year now

Ancient history

• No proper change log was kept before 0.5.0