Skip to main content

Sort terms according to German DIN.

Project description

Sort terms according to German DIN 5007.

Build Status | sources | issues

Little Python library to support sorting of terms according to DIN (German Standards Institute) standard 5007.

This standard describes how to sort german terms alphabtically. It provides two variants:

  • Variant 1:

    • 'ä' equals 'a'

    • 'ß' equals 'ss'

  • Variant 2:

    • 'ä' equals 'ae'

    • 'ß' equals 'ss'

In both variants other diacritics are removed. So 'é' and 'ç' become 'e' and 'c' respecively.

Usage

dinsort is a Python library.

Normalizing Terms

Main function is dinsort.normalize. It generates a normalized form of any string term given:

>>> from dinsort import normalize
>>> normalize("Löblich")
'loblich'

Variants are defined as constants:

>>> from dinsort import VARIANT1, VARIANT2
>>> normalize("Müßig", variant=VARIANT1)
'mussig'

>>> normalize("Müßig", variant=VARIANT2)
'muessig'

Terms are normalized to lower-case by default. You can request case-sensitiveness:

>>> normalize("Maße", case_sensitive=True)
'Masse'

Sorting

Normalized terms can easily be used for sorting lists of terms:

>>> sorted(["fas", "fair", "fär"], key=lambda x: normalize(x))
['fair', 'fär', 'fas']

We provide a shortcut to avoid (sometimes not easy to read) lambda statements with normalize in your code. Use sort_func for that:

>>> from dinsort import sort_func
>>> sorted(["fas", "fair", "fär"], key=sort_func())
['fair', 'fär', 'fas']

The sort_func accepts the keywords of normalize:

>>> sorted(["Muße", "muß"], key=sort_func())
['muß', 'Muße']

>>> sorted(["Muße", "muß"], key=sort_func(case_sensitive=True))
['Muße', 'muß']

>>> sorted(["far", "fähre"], key=sort_func())
['fähre', 'far']

>>> sorted(["far", "färe", "fast"], key=sort_func())
['far', 'färe', 'fast']

>>> sorted(["far", "färe", "fast"], key=sort_func(variant=VARIANT2))
['färe', 'far', 'fast']

Install

User Install

The latest release of dinsort can be installed via pip:

$ pip install dinsort

The exact way depends on your operating system.

Developer Install

Developers clone the sources from github:

$ git clone https://github.com/ulif/dinsort.git

Create a virtual env (Python versions >= 2.6 supported):

$ cd dinsort
$ virtualenv py27
$ source py27/bin/activate

and install dependencies:

(py27) python setup py dev

You can run tests with py.test:

(py27) py.test

or with tox:

(py27) pip install tox
(py27) tox

Changes

0.2 (2015-10-14)

  • Add sort_func. It is as shortcut for lambda expressions with normalize.

  • Support pypy officially.

0.1 (2015-10-13)

  • Initial version.

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

dinsort-0.2.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

dinsort-0.2-py2.py3-none-any.whl (6.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file dinsort-0.2.tar.gz.

File metadata

  • Download URL: dinsort-0.2.tar.gz
  • Upload date:
  • Size: 12.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for dinsort-0.2.tar.gz
Algorithm Hash digest
SHA256 18a15223cb1e27ac3e73d5de41e08fe8d47dc85ee9feeeea8177b867033ca76c
MD5 df0a8f478fe4f94d1309f49aadcea6ce
BLAKE2b-256 ccb218ff2e44fe0cb7e1e7955229f62904c299674b7b9ef6500255951ae793b9

See more details on using hashes here.

File details

Details for the file dinsort-0.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for dinsort-0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 9649c8ab7def8c16aa46fa066beba3516271f921620030f0440bd749130a104c
MD5 ebc6c5bdd6a7a8b5d9b048f7134d5572
BLAKE2b-256 d931ab178c5108772b326acf61b54546aa54e39c77e1c5129f9e70723384dc50

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