offermann / elizabeth

Elizabeth is a library to generate dummy data. It's very useful when you need to bootstrap your database.

Elizabeth

Elizabeth is a library to generate dummy data. It's very useful when you need to bootstrap your database. Elizabeth doesn't have any dependencies.

At this moment a library has 15 supported locales:

F	🇩🇰	🇩🇪	🇺🇸	🇪🇸	🇫🇮	🇫🇷	🇮🇸	🇮🇹	🇳🇱	🇳🇴	🇸🇪	🇷🇺	🇵🇹	🇧🇷	🇵🇱
Code	da	de	en	es*	fi*	fr	is*	it	nl*	no	sv	ru	pt*	pt-br	pl

* - not completely

Documentation

Elizabeth is a pretty simple library and all you need to start is the small documentation. See Elizabeth's Sphinx-generated documentation here: http://elizabeth.readthedocs.io/en/latest/

Installation

➜  ~ git clone https://github.com/lk-geimfari/elizabeth.git
➜  ~ cd elizabeth/
➜  ~ python3 setup.py install

# or

➜  ~ pip install elizabeth

Testing

➜  ~ cd elizabeth/
➜  ~ python3 -m unittest discover tests

# or
➜  ~ ./run_tests.sh

Usage

# ...
# Model from some Flask project.

class Patient(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    email = db.Column(db.String(120), unique=True)
    phone_number = db.Column(db.String(25))
    full_name = db.Column(db.String(100))
    gender = db.Column(db.String(64))
    nationality = db.Column(db.String(64))
    weight = db.Column(db.String(64))
    height = db.Column(db.String(64))
    blood_type = db.Column(db.String(64))

    def __init__(self, **kwargs):
        super(Patient, self).__init__(**kwargs)

    @staticmethod
    def _bootstrap(count=2000):
        from elizabeth import Personal

        person = Personal('en')
        for _ in range(count):
            patient = Patient(email=person.email(),
                              phone_number=person.telephone(),
                              full_name=person.full_name(gender='female'),
                              gender=person.gender(),
                              nationality=person.nationality(),
                              weight=person.weight(),
                              height=person.height(),
                              blood_type=person.blood_type()
                              )
        try:
            db.session.add(patient)
        except Exception:
            db.session.commit()

When you use only one locale, then you can use the Generic class.

from elizabeth import Generic

el = Generic('en')


def patient(gender='female'):
    patient_card = {
        'full_name': el.personal.full_name(sex),
        'gender': el.personal.gender(gender=gender),
        'blood_type': el.person.blood_type(),
        'birthday': el.datetime.birthday()
    }
return patient_card

Available data providers

Provider	Description
Address	Address data (street name, street suffix etc.)
Business	Business data (company, company_type, copyright etc.)
Code	Codes (ISBN, EAN, IMEI etc.).
ClothingSizes	Clothing sizes (international sizes, european etc.)
Datetime	Datetime (day_of_week, month, year etc.)
Development	Data for developers (version, programming language etc.)
File	File data (extension etc.)
Food	Information on food (vegetables, fruits, measurements etc.)
Personal	Personal data (name, surname, age, email etc.)
Text	Text data (sentence, title etc.)
Transport	Dummy data about transport (truck model, car etc.)
Network	Network data (IPv4, IPv6, MAC address) etc
Science	Scientific data (scientist, math_formula etc.)
Internet	Dummy internet data (facebook, twitter etc.)
Hardware	The data about the hardware (resolution, cpu, graphics etc.)
Numbers	Numerical data (floats, primes, digit etc.)
Generic	All at one

Examples

• flask_church - An extension for Flask based on Elizabeth.
• presturinn - This is a fake API based on Falcon and Elizabeth v0.2.0 .

Contributing

Your contributions are always welcome! Please take a look at the contribution guidelines first. Here you can look a list of contributors

Disclaimer

The author does not assume any responsibility for how you will use this library and how you will use data generated with this library. This library is designed only for developers and only with good intentions. Do not use the data generated with elizabeth for illegal purposes.

Licence

MIT License