A Python library for declension of personal names in Serbian
Project description
deklinacija
A Python library for declension of personal names in Serbian, with support for both Cyrillic and Latin scripts.
Installation
The source code is currently hosted on GitHub: https://github.com/urelja/deklinacija
The latest binary versions are hosted on the Python Package Index (PyPI): https://pypi.org/project/deklinacija/
pip install deklinacija
Usage
Simply import
the package. It is recommended to set the alias to dek
.
import deklinacija as dek
As of right now, only first names are supported. To decline names, all you have to do is to call the appropriate function for the grammatical case you want to use, and specify the name
and the gender
parameter. The name parameter must be a string
, can have either Latin or Cyrillic characters (automatically detected), and can contain uppercase or lowercase letters (the script respects the capitalisation of the name and will capitalise the added suffixes according to the last character's capitalisation, see vokativ2
below).
The functions in this example return a string
.
import deklinacija as dek
genitiv = dek.genitiv("Velja","male") #Velje
dativ = dek.dativ("Петар","male") #Петру
akuzativ = dek.akuzativ("Jana","female") #Janu
vokativ = dek.vokativ("Predrag","male") #Predraže
vokativ2 = dek.vokativ("PREDRAG","male") #PREDRAŽE
instrumental = dek.instrumental("Uroš","male") #Urošem
instrumental2 = dek.instrumental("Вук","male") #Вуком
lokativ = dek.lokativ("Lana","female") #Lani
print(f"Zdravo, {vokativ}! Dobio si zahtev za prijateljstvo od {genitiv}.")
#Zdravo Predraže! Dobio si zahtev za prijateljstvo od Velje.
#Translation: Hello Predrag! You have received a friend request from Velja.
You can also immediatelly decline a name through all grammatical cases by calling the declineAll()
function.
The declineAll()
function returns a dictionary
, where keys are the grammatical cases.
import deklinacija as dek
Nikola = dek.declineAll("Nikola","male")
#{'nominativ': 'Nikola', 'genitiv': 'Nikole', 'dativ': 'Nikoli', 'akuzativ': 'Nikolu',
#'vokativ':'Nikola', 'instrumental': 'Nikolom', 'lokativ': 'Nikoli'}
print("Dali ste poklon",Nikola['dativ'])
#Dali ste poklon Nikoli
#Translation: You have given a gift to Nikola
Todo
The following features are on the roadmap:
- Declension of last names
- Possessive forms
Attribution
Vokativi by Startit is licensed under CC BY 4.0 / Modifications: converted to Cyrillic and filtered out names longer than 4 characters
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for deklinacija-1.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8fb5e93e6ba556f0c1395a3080481c1ba9e92ab7267d4dcb598a38daeeb8d50c |
|
MD5 | 45f9ffd33786a3044fbd1e17b50efa08 |
|
BLAKE2b-256 | 0f8e91748a9ba40ee2c0c81713a95b8ee581d957fbbd5d1b02c5ff43f7a58372 |