german-gender-finder's Introduction

German-gender-finder

Find the gender of the German word.

You can use this script to find out what article your german word needs. Der, Die or Das

Usage

Finding the gender of the word "Besuch" directly from the command line (cmd):

Or from within a script

import find_gender
print(find_gender.get_gender_of_word('mutter'))
#{'word': 'mutter', 'definite_article': 'die', 'indefinite_article': 'eine', 'warning': 'Sure: Found in word list, highly reliable'}

Notes

The script first searches a world list. the list has around 30.000 words. All commonly used words are there.
If the script cannot find the word in the list it will use grammar rules to find its gender.
All words that are exceptions to rules should be in the list.

return values

The script always returns a dictionary with a warning message detailing the reliability:

# very reliable, This will be the response in allmost all cases, due to the size of the wordlist
{
  'word': 'somewordyouchose', 
  'definite_article': 'die',
  'indefinite_article': 'eine',
  'warning': 'Sure: Found in word list, highly reliable'
}


# very reliable
{
    'word': 'somewordyouchose',
    'definite_article': 'der',
    'indefinite_article': 'ein',
    'warning': 'Sure: male due to masculine ending'
}

# not sure, see warning message!
{
     'word': 'somewordyouchose',
     'definite_article': 'der',
     'indefinite_article': 'ein',
     'warning': 'Unsure: However 80% of words ending in "en" are masculine'
}

# all messages you could get:

'warning': 'Sure: Found in word list',
'warning': 'Sure: male due to masculine ending',
'warning': 'Sure: female due to feminine ending',
'warning': 'Sure: neuter due to neuter ending',
'warning': 'Unsure: However 80% of words ending in "en" are masculine',
'warning': 'Unsure: However 60% of nouns ending in "el" are masculine',
'warning': 'Unsure: However 60% of nouns ending in "er" are masculine',
'warning': 'Unsure: However 90% of nouns ending in "e" are masculine',
'warning': 'Unsure: However 90% of nouns starting with "ge" are feminine',
'warning': 'Unsure: Most nouns ending in -t originating from verbs are feminine.',
'warning': 'Not_found: word not found',

The words in the word list are taken from:

https://github.com/mejutoco/german-grammar-statistics

I removed all words without a gender assigned.

german-gender-finder's People

Contributors

Stargazers

Watchers

german-gender-finder's Issues

`import find_gender` after install module from pip does not work

Just like I wrote on the title. The code

!pip3 install german-gender-finder
import find_gender

gives me error below:

Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'find_gender'

Thank you.

publish package on pypi.org

From what I can tell the package is not yet registered on https://pypi.org/. Would be great if you could add it there along with a license. Thank you.