Générateur de prénoms

Le script est disponible sur PyPI. Pour installer avec pip :

pip install prenoms

prenoms peut être utilisé via la ligne de commande ou importé comme paquet Python.

Pour utiliser prenoms depuis la ligne de commande :

$ prenoms
Jean Dupont

Quelques exemples d'utilisation :

>>> import prenoms
>>> prenoms.get_nom_complet()
'Jean Bernard'
>>> prenoms.get_prenom()
'Lucie'
>>> prenoms.get_nom()
'Lefevre'
>>> prenoms.get_prenom(originality=Originality.VERY_RARE, gender=Gender.MALE, year=1995)
'Hortensius'
>>> prenoms.get_nom(originality=Originality.VERY_RARE, year=1995)
'Wazner'

Le paramètre originality permet de spécifier l'originalité du nom ou du prénom. Quatre options sont disponibles :

• COMMON
• UNCOMMON
• RARE
• VERY_RARE

Le paramètre gender permet de spécifier le genre du prénom, les options sont MALE ou FEMALE.

Le paramètre year permet de spécifier la décennie de recherche pour un nom ou un prénom. Si ce paramètre est égal à None, l'entièreté des données est utilisée.

Les prénoms sont ceux de personnes nées entre 1900 et 2018 en France (hors Mayotte), regroupés par décennies. Ils doivent avoir été donnés au moins 3 fois par an pour figurer dans la liste globale, et 10 fois par décénnie pour apparaître dans les listes décennales.

Les noms de famille (anciennement noms patronymiques) sont ceux de personnes nées entre 1891 et 2000 en France métropolitaine (sauf celles nées avant 1946 et décédées avant 1972) et celles nées entre 1900 et 2000 dans un département d'outremer. Un nom doit apparaître 10 fois par décénnie pour apparaître dans les listes décennales.

Un nom ou un prénom est commun s'il apparaît plus de 500 fois dans une liste, peu commun s'il apparaît plus de 100 fois, rare s'il apparaît plus de 50 fois, et très rare sinon.

Ce projet est sous licence MIT.

Les données dans le dossier prenoms/data proviennent de l'INSEE et appartiennent au domaine public.