faker_credit_score is a community-created provider for the Faker test data generator Python package.

This package provides fake credit score data for testing purposes. The four most common non-industry specific credit scoring models are supported:

• FICO Score 8
• Equifax Beacon 5.0
• Experian/Fair Isaac Risk Model V2SM
• TransUnion FICO Risk Score, Classic 04

Install with pip:

$ pip install faker-credit-score

Alternatively, install with setup.py:

$ git clone https://github.com/crd/faker_credit_score.git
$ cd faker_credit_score && python setup.py install

$ faker credit_score -i faker_credit_score
756

Add the CreditScore Provider to your Faker instance:

from faker import Faker
from faker_credit_score import CreditScore

fake = Faker()
fake.add_provider(CreditScore)

fake.credit_score_name()
'TransUnion FICO Risk Score, Classic 04'
fake.credit_score_provider()
'TransUnion'
fake.credit_score()
791

By all means, contribute! I'd be happy to work with any first-time open source contributors so please, don't be shy.

Execute unit tests and calculate code coverage like so:

$ coverage run -m unittest tests/*
........
----------------------------------------------------------------------
Ran 8 tests in 0.224s

OK

$ coverage report
Name                             Stmts   Miss  Cover
----------------------------------------------------
faker_credit_score/__init__.py      49      0   100%