О проекте

FakerRussia — программная библиотека для генерации реалистичных персональных данных, адаптированных к российской специфике. Предназначена для тестирования программного обеспечения, наполнения баз данных тестовыми наборами информации, создания демонстрационных стендов, проведения нагрузочных испытаний, а также для любых иных сценариев, требующих наличия правдоподобных персональных данных, соответствующих российским реалиям.

Библиотека обеспечивает генерацию комплексного профиля человека, включающего биографические сведения, адресные данные, контактную информацию, документальные данные, финансовые показатели, сведения о трудовой деятельности, транспортные данные и семейное положение. Все генерируемые характеристики находятся в логической взаимосвязи друг с другом, что обеспечивает высокую степень реалистичности итогового результата.

Возможности

Быстрый старт

from russiafaker import FakerRussia

# Создание генератора
faker = FakerRussia()

# Генерация человека с удобным доступом ко всем данным
person = faker.generate_person()

# Прямой доступ к любым данным
print(f"Клиент: {person.full_name}, {person.age} лет")
print(f"Телефон: {person.phone}")
print(f"Email: {person.email}")
print(f"Адрес: {person.registration_address}")
print(f"Работа: {person.job}, зарплата: {person.salary} руб.")
print(f"Автомобиль: {person.car} {person.car_year} года")
print(f"Семейный статус: {person.marital_status}, детей: {person.children_count}")

# Краткое строковое представление
print(person)

# Сохранение в словарь (для JSON, баз данных)
person_dict = person.to_dict()

Указание пола

# Генерация данных для мужчины
male_faker = FakerRussia(my_gender="мужской")
male_person = male_faker.generate_person()

# Генерация данных для женщины
female_faker = FakerRussia(my_gender="женский")
female_person = female_faker.generate_person()

Требования к окружению

Установка

Через PyPI (рекомендуемый способ)

pip install russiafaker==2.0.0

Ссылка на PyPI: https://pypi.org/project/russiafaker/2.0.0/

Из исходных кодов

git clone https://github.com/waratecs123/FakerRussia.git
cd FakerRussia
pip install .

Руководство по использованию

Импорт и инициализация

from russiafaker import FakerRussia

generator = FakerRussia()

Получение полного профиля

person = generator.generate_person()
print(person)  # Краткая информация
print(generator)  # Полный вывод всех данных

Доступ к отдельным категориям

Примеры доступа к данным

person = generator.generate_person()

# Через объект PersonData
print(person.full_name)      # ФИО
print(person.age)            # Возраст
print(person.phone)          # Телефон
print(person.city)           # Город
print(person.salary)         # Зарплата
print(person.car)            # Автомобиль

# Через прямые генераторы
print(generator.bio.full_name)
print(generator.address.city)

Сброс данных

generator.reset()  # Полная перегенерация всех данных

Класс PersonData

При использовании метода generate_person() возвращается объект PersonData со следующими атрибутами:

Основные атрибуты

Методы

Примеры сгенерированных данных

Краткий вывод (print(person))

Иванов Иван Иванович, 34 лет, male
Проживает: Москва, 101000, Московская область - Город Москва - Тверская д. 25 корп. 3
Работа: Программист, зарплата: 150000 руб.
Семейный статус: Женат, детей: 2

Биографические данные

ФИО: Иванов Иван Иванович
Год рождения: 15.05.1990
Возраст: 34
Пол: male
ФИО отца: Иванов Иван Петрович
ФИО матери: Иванова (девичья фамилия - Петрова) Мария Ивановна
Национальность: Русский
Рост: 178
Вес: 82
Индекс массы тела: 25.87
Знак зодиака: Телец
Поколение: Миллениалы
Группа крови: A (II) Rh+
Религия: Православие
Телосложение: Нормальное
Цвет глаз: Карие
Цвет волос: Русые
Образование: Высшее
Средний балл школьного аттестата: 4.32
Размер обуви: 43
Зрение: -2.5
Уровень слуха: Нормальный
Инвалидность: Отсутствует
Пульс в покое: 72
Прививки: Гепатит B, Корь, Грипп
Военная категория годности: Б

Финансовые данные

БИК: 044525974
Количество карт: 2
Банки: Сбербанк, Тинькофф
Номера карт: 4276123456789012, 5213245678901234
CVV/CVC: 123, 456
Зарплата: 85000
Банкротство: False

Алгоритмы генерации

Вероятностные механизмы

Расширение функциональности

Для создания собственного генератора необходимо унаследоваться от BaseGenerator:

import random
from russiafaker.b_h__base_generator import BaseGenerator
from russiafaker.b__additional_algorithms.a_a__handle_errors import handle_errors

class CustomGenerator(BaseGenerator):
    def __init__(self):
        super().__init__()
        self._data = None
        self._load_custom_data()

    def _load_custom_data(self):
        data = self._load_json('a__data/custom/custom_data.json')
        self.CUSTOM_DATA = data.get("CUSTOM_DATA", [])

    @property
    @handle_errors
    def custom_property(self) -> str:
        if self._data is None:
            self._data = random.choice(self.CUSTOM_DATA)
        return self._data

    def reset(self):
        self._data = None
        return "Данные сброшены"