madura-api

madura_api

A Python API to access online madura dictionary

Usage

Install the package

pip3 install madura-api

Example 1

from madura_api import translate

result_list=translate('Home')
print(result_list)

result_list is a list of lists like this,

[
    ['n.', 'ආල'],
    ['n.', 'ආලය'],
    ['n.', 'උත්පත්ති ස්ථානය'],
    ['n.', 'උන්හිටි තැන'],
    ['n.', 'ගෘහය'],
    ['n.', 'ගෙදර'],
    ['a.', 'ගෙදර පිළිබඳ වූ'],
    ['vi.', 'ගෙදරට ආපසු පැමිණෙනවා'],
    ['n.', 'ගේ'],
    ['n.', 'ගේදොර'],
    ['n.', 'ඝර'],
    ['n.', 'නිවස'],
    ['n.', 'නිවහන'],
    ['n.', 'නිවාසය'],
    ['n.', 'නිවෙස'],
    ['Ele.', 'නිවෙසනවා'],
    ['Ele.', 'නිවෙසීම'],
    ['n.', 'පදිංචිය'],
    ['Soc.', 'පවුල'],
    ['Soc.', 'ස්වදේශ'],
    ['n.', 'සියරට']
]

Example 2

from madura_api import translate

result_list=translate('පොත')
print(result_list)

result_list is a list of lists like this,

[
    ['n.','bood'],
    ['n.', 'book'],
    ['n.', 'scroll']
]

• If there is no result, translate function will return False

Example 3

from madura_api import translate

result_list=translate('meen')
print(result_list)

False

Advanced Usage (Suggestions)

Example 4

This is how you translate something if you wanna work with suggestions

import madura_api

result=madura_api.Translate('home')
print(result.list)

[
    ['n.', 'ආල'],
    ['n.', 'ආලය'],
    ['n.', 'උත්පත්ති ස්ථානය'],
    ['n.', 'උන්හිටි තැන'],
    ['n.', 'ගෘහය'],
    ['n.', 'ගෙදර'],
    ['a.', 'ගෙදර පිළිබඳ වූ'],
    ['vi.', 'ගෙදරට ආපසු පැමිණෙනවා'],
    ['n.', 'ගේ'],
    ['n.', 'ගේදොර'],
    ['n.', 'ඝර'],
    ['n.', 'නිවස'],
    ['n.', 'නිවහන'],
    ['n.', 'නිවාසය'],
    ['n.', 'නිවෙස'],
    ['Ele.', 'නිවෙසනවා'],
    ['Ele.', 'නිවෙසීම'],
    ['n.', 'පදිංචිය'],
    ['Soc.', 'පවුල'],
    ['Soc.', 'ස්වදේශ'],
    ['n.', 'සියරට']
]

If you try to translate something that can't be translated it'll give you a suggestion list like this,

Example 5

import madura_api

result=madura_api.Translate('meen')
print(result.list)

[
    'meed',
    'meek',
    'meekness',
    'meerkat',
    'meerschaum',
    'meet',
    'meeting',
    'meeting adjourned', 
    'meeting annual general',
    'meeting extraordinary'
]

But you will need to know if the output you get is a suggestion or not. This how you do that,

Example 6

import madura_api

result=madura_api.Translate('meen')
print(result.is_a_suggestion)

True

Miscellaneous Stuff

If you think madura_api is a pain in the ass to type, do this

import madura_api as mapi