Skip to content

Credit Score Provider for the Faker Python Project. Use this to generate fake but realistic-looking consumer credit scores aligning to the most prevalent risk models (FICO, VantageScore, etc.)

License

Notifications You must be signed in to change notification settings

crd/faker_credit_score

Repository files navigation

faker_credit_score

Latest version released on PyPI Release workflow status Test coverage BSD 3-Clause License Black code formatter

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 most common non-industry specific credit scoring models are supported:

  • FICO Score 8
  • FICO Score 9
  • FICO Score 10
  • FICO Score 10 T
  • VantageScore 3.0
  • VantageScore 4.0
  • UltraFICO
  • Equifax Beacon 5.0
  • Experian/Fair Isaac Risk Model V2SM
  • TransUnion FICO Risk Score, Classic 04

Installation

Install with pip (this will also install Faker if you don't already have it):

$ pip install faker-credit-score

Usage

From the Command Line

$ faker credit_score -i faker_credit_score
756

From within your Python Project

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

Contributing

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

Testing

Execute unit tests and calculate code coverage like so:

$ pytest --cov=faker_credit_score
..............
----------------------------------------------------------------------
Ran 14 tests in 0.406s

OK

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

About

Credit Score Provider for the Faker Python Project. Use this to generate fake but realistic-looking consumer credit scores aligning to the most prevalent risk models (FICO, VantageScore, etc.)

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •