random-italian-person 1.0.6
Python package to generate an Italian person randomly.
License: MIT
Requires Python: >=3.8.0

random_italian_person
=========================================================================================
|pip| |downloads| |github|

Python package to generate an Italian person randomly.

How do I install this package?
----------------------------------------------
As usual, just download it using pip:

.. code:: shell

    pip install random_italian_person


Usage examples
-----------------------------------------------

.. code:: python

    from random_italian_person import RandomItalianPerson

    person = RandomItalianPerson()

    print(person.describe())
    # 'Rodrigo Benedetti è nata/o a Molazzana (LU) il 1972-12-18. Ora vive a Cagliari (CA) in Via Giuseppe Garibaldi 109.'

Generate a CSV of random italian persons
-----------------------------------------------
One of the most common usages for this library is to render
fake datasets for testing porposes. For instance,
to generate a CSV with 5 random person you can use:

.. code:: python

    import pandas as pd
    from random_italian_person import RandomItalianPerson

    df = pd.DataFrame([
        RandomItalianPerson().data
        for _ in range(5)
    ])

The obtained dataframe will look like:

+-----------------------+------------+-----------+-----------+-------+----------------------+------------------+----------------+-------------+-----------------------+-------------+-------------------+----------------+-------+----------------+-----------------+------------------+
| region                | province   | surname   | name      | sex   | birth_municipality   | birth_province   | birth_region   |   birth_cap | birth_province_code   | birthdate   | address           | house_number   |   cap | municipality   | province_code   | codice_fiscale   |
+=======================+============+===========+===========+=======+======================+==================+================+=============+=======================+=============+===================+================+=======+================+=================+==================+
| Marche                | Macerata   | Di Felice | Giacomina | F     | Mosciano Sant'angelo | Teramo           | Abruzzo        |       64023 | TE                    | 1945-09-18  | Viale De Amicis   | 76             | 62020 | Colmurano      | MC              | DFLGMN45P58F764B |
+-----------------------+------------+-----------+-----------+-------+----------------------+------------------+----------------+-------------+-----------------------+-------------+-------------------+----------------+-------+----------------+-----------------+------------------+
| Friuli Venezia Giulia | Udine      | Galli     | Imen      | F     | Isola Dovarese       | Cremona          | Lombardia      |       26031 | CR                    | 1942-03-10  | Via Udine         | 2              | 33020 | Verzegnis      | UD              | GLLMNI42C50E356T |
+-----------------------+------------+-----------+-----------+-------+----------------------+------------------+----------------+-------------+-----------------------+-------------+-------------------+----------------+-------+----------------+-----------------+------------------+
| Abruzzo               | Pescara    | Rosso     | Eva       | F     | Cellarengo           | Asti             | Piemonte       |       14010 | AT                    | 2001-12-31  | Via G. Fonzi      | 58             | 65010 | Spoltore       | PE              | RSSVEA01T71C438U |
+-----------------------+------------+-----------+-----------+-------+----------------------+------------------+----------------+-------------+-----------------------+-------------+-------------------+----------------+-------+----------------+-----------------+------------------+
| Emilia Romagna        | Bologna    | Grasso    | Emanuele  | M     | Caposele             | Avellino         | Campania       |       83040 | AV                    | 1942-08-27  | Via G. Massarenti | 223/5          | 40138 | Bologna        | BO              | GRSMNL42M27B674L |
+-----------------------+------------+-----------+-----------+-------+----------------------+------------------+----------------+-------------+-----------------------+-------------+-------------------+----------------+-------+----------------+-----------------+------------------+
| Sicilia               | Palermo    | Pastorino | Lenuta    | F     | Borzonasca           | Genova           | Liguria        |       16041 | GE                    | 1972-09-05  | Via Montalbo      | 124            | 90142 | Palermo        | PA              | PSTLNT72P45B067T |
+-----------------------+------------+-----------+-----------+-------+----------------------+------------------+----------------+-------------+-----------------------+-------------+-------------------+----------------+-------+----------------+-----------------+------------------+


.. |pip| image:: https://badge.fury.io/py/random-italian-person.svg
    :target: https://badge.fury.io/py/random-italian-person
    :alt: Pypi project

.. |downloads| image:: https://pepy.tech/badge/random-italian-person
    :target: https://pepy.tech/badge/random-italian-person
    :alt: Pypi total project downloads

.. |github| image:: https://github.com/lucacappelletti94/random_italian_person/actions/workflows/python.yml/badge.svg
    :target: https://github.com/lucacappelletti94/random_italian_person/actions
    :alt: Github Actions