haltuf/genderer

Independent library to detect gender by name in Czech. Also returns 5th grammatical case (vocative) for salutation.

v0.3 2021-05-12 13:59 UTC

This package is auto-updated.

Last update: 2022-05-12 16:19:26 UTC


README

Build Status Coverage Status

Independent library to detect gender by name in Czech language. Also provides 5th grammatical case (vocative) for salutation. Nezávislá knihovna pro detekci pohlaví podle jména. Kromě toho je schopna dle zadaného jména vrátit 5. pád pro oslovení.

See example.php for example of use.

Please be patient, this is my first github project and I use it as a testing playground.

Versions

List of current versions:

Status Version Composer PHP
stable 0.3 ~0.3 >= 5.3, <= 8.0
stable 0.2 ~0.2 >= 5.3, <= 7.3
stable 0.1 ~0.1 >= 5.3, <= 7.1

Requirements

  • PHP 5.3.1 or higher
  • Sqlite3 extension
  • mbstring extension

The library was written as a standalone tool with zero dependencies to other projects. This way you can use it in any project or framework you like. If you want to use it in combination with Nette Framework, check out GenderHelper.

Installation

Easiest way to install is through composer

composer require haltuf/genderer

Usage

use Haltuf\Genderer\Genderer ;

$g = new Genderer ;

// Dobrý den, Tomáši Vomáčko
echo "Dobrý den, " . $g->getVocative("Tomáš Vomáčka");

// 'm' = male, 'f' = female
echo "Pohlaví: " . $g->getGender("Tomáš Vomáčka");

// Dobrý den, MUDr. Tomáši Amosi Březino
echo "Dobrý den, " . $g->getVocative("MUDr. Tomáš Amos Březina");

Data source

The database of names comes from Trixi blog and is a compilation of the government oficial database (MVCR) and the contribution of authors working on validace.cz project.