haltuf/genderer

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


Keywords
name, czech, gender, salutation
License
BSD-3-Clause

Documentation

Genderer

Build StatusCoverage 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
dev master dev-master >= 5.3, <= 7.3
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

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 to add this line to your composer.json file:

	"require": {
		"haltuf/genderer": "dev-master"
	}

or

composer require haltuf/genderer:@dev

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.