Example

>>> from libleipzig import * # might take some time initially
>>> r = Baseform(u"Schlangen")
>>> r # doctest: +NORMALIZE_WHITESPACE
[(Grundform: u'Schlange', Wortart: u'N'),
 (Grundform: u'Schlangen', Wortart: u'S')]
>>> r[0].Grundform
u'Schlange'
>>> help(Baseform) # doctest: +NORMALIZE_WHITESPACE
Help on function Baseform in module libleipzig.protocol:
Baseform(*vectors, **options)
    Baseform(Wort) -> Grundform, Wortart
        Return the lemmatized (base) form.
>>>

Dependencies

• Python 2.5 or later 2.x releases
• suds 0.3.9 or later

Service calls

Every service calls takes exactly its request parameters (as defined in the list of webservices) as positional or keyword arguments and accepts a number of generic options:

auth

Authentication credentials; a tuple of (username, password). See Authentication.

corpus

Language corpus; a string identifier. See Corpora.

Corpora

The project collects corpora in a variety of languages, German (de) only being the largest one and thus the default. According to the reference implementation the following corpora are available (those marked with asterisks actually worked as of the time of writing):

• de* (default)
• en*
• es*
• fr*
• fr05*
• fr05_100K
• fr05_1M
• fr05_300K
• fr05_3M*
• it*
• it100K
• it300K
• it10M
• it3M
• nl*
• nl100K
• nl300K
• nl1M

Note that these collections are not as comprehensive as the German corpus and thus might only provide selected services. Most often these are the simple text processing calls such as RightNeighbours. You can use these corpora in libleipzig by supplying the corpus parameter to any of the service calls:

>>> import libleipzig
>>> libleipzig.Cooccurrences("programming", 0, 1, corpus="en")
[(Wort: u'programming', Kookkurrenz: u'language', Signifikanz: u'4152')]

Authentication

You can increase your rate limit or gain access to private services by supplying authentication credentials to a service call:

Baseform("programming", auth=("username", "password"))

Public service calls can be accessed with the combination anonymous/anonymous, which is also the default.

Troubleshooting

For unauthenticated service calls the server might raise errors such as the following:

suds.WebFault: Server raised fault:
'java.lang.Exception: Communication link failure,
                      message from server: "Server shutdown in progress"'

This is the API's way to impose rate limits on anonymous users. See Authentication for a way to avoid this issue.

Changelog

1.2

• Added authentication support.
• Added different corpora to services.
• Exposed WebFault error condition.
• Extended service parameter by generic options.

1.1

• Bumped suds version to 0.3.9.
• Fixed numerous unicode issues and pointed out potential pitfalls.
• Fixed caching to be persistent but lazy.
• Upgraded virtual environment to incremental build steps.
• Pushed tests into installed package.

Reference