Skip to main content

A Python interface for the dictionary API

Project description

PyPI Downloads PyPI - Python Version GitHub license Code style: black Codacy Badge Build Status codecov API - Python Client

A Python wrapper for the REST API. Easily interact with the REST API using this library.


pip install termania

Getting started

Prior to using this library you will have to request a licence key from


from termania import API

termania_api = API(licence_key=1234567890)


Option Type Required Description
license_key int yes Your API license key



entry ="mama", dictionary_id=70)
Parameter Type Required Description
query str yes Your search query
dictionary_id int yes The dictionary you want to search your query for
    html="""<p xmlns="" xmlns:e="urn:STP_XMLDATA">
             <span class="color_orange font_xlarge strong">mama </span>
             <span class="color_lightdark font_small italic">(slovensko) </span>
             <span class="color_lightdark font_small">samostalnik, </span>
             <span class="color_lightdark font_small">ž. sp. </span>
             <span class="italic font_small color_lightdark">Oblike: </span>
             <span class="">mam, mamah, mamam, mamama, mamami, mame, mami, mamo </span>
                 <hr style="color: #e3e3e3;background-color: #e3e3e3; height: 1px;border: 0 none;"/>
                 <span class="">
                         <span class="italic font_small color_lightdark">Pomen: </span>
                         <span class="color_orange">sorodnik </span>
                         <span class="italic font_small color_lightdark">Povezava spredaj: </span>
                         <span class="font_large">rôden, pokojen </span>
                         <span class="color_lightdark font_small italic"><br/>Slovenska sopomenka: </span>
                         <span class="font_large">mati</span>, 
                         <span class="font_large">roditeljica</span>, 
                         <span class="font_large">rodnica</span>
                         <span class="color_lightdark font_small italic"><br/>Angleški prevod: </span>
                         <span class="color_dark font_xlarge">mother</span>
                         <span class="color_lightdark font_small italic"><br/>Nemški prevod: </span>
                         <span class="color_dark font_xlarge">Mutter</span>, 
                         <span class="color_dark font_xlarge">Mama</span>, 
                         <span class="color_dark font_xlarge">Mom</span>
                         <span class="color_lightdark font_small italic"><br/>Albanski prevod: </span>
                         <span class="color_dark font_xlarge">nënë</span>, 
                         <span class="color_dark font_xlarge">mëmë</span>
                         <span class="color_lightdark font_small italic"><br/>Francoski prevod: </span>
                         <span class="color_dark font_xlarge">mère</span>
                 <hr style="color: #e3e3e3;background-color: #e3e3e3; height: 1px;border: 0 none;"/>
                 <!-- etc ... trimmed to keep the README manageable -->

Get dictionary list

dictionaries = termania_api.get_dictionaries()
    6: Dictionary(id=6, name='Grško-slovenski slovar', author='Anton Dokler', languages=('el', 'sl'), lingualism=2, type=1), 
    8: Dictionary(id=8, name='Besedišče slovenskega jezika z oblikoslovnimi podatki', author='ZRC SAZU, Inštitut za slovenski jezik Frana Ramovša in avtorji', languages=('sl', 'sl'), lingualism=1, type=1), 
    # etc ... trimmed to keep the README manageable


git clone
cd termania-api                  
python3 -m venv env
source env/bin/activate
pip install -e .
pip install -r requirements_dev.txt

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

termania-1.0.2.tar.gz (10.5 kB view hashes)

Uploaded source

Built Distribution

termania-1.0.2-py3-none-any.whl (6.3 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page