Metadata-Version: 2.1
Name: jafgen
Version: 0.2.1
Home-page: https://github.com/dbt-labs/jaffle-shop-generator
Author: dbt Labs™️
Author-email: winnie@dbtlabs.com
License: Apache
Classifier: Intended Audience :: Science/Research
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: dev
License-File: LICENSE

# 🥪 Jaffle Shop Generator 🏭

The Jaffle Shop Generator or `jafgen` is a python package with a simple command line tool for generating a synthetic data set suitable for analytics engineering practice or demonstrations.

## Installation

```shell
pip install jafgen
```

## Use

`jafgen` takes one argument, years, which sets the length of time the simulation generates synthetic data for.

```shell
# generate a simulation spanning 3 years from 2016-2019
jafgen --years 3
```

## Purpose

Finding a good data set to practice, learn, or teach analytics engineering with can be difficult. Most open datasets are great for machine learning -- they offer single wide tables that you can manipulate and analyze. Full, real relational databases on the other hand are generally protected by private companies. Not only that, but they're a bit _too_ real. To get to a state that a beginner or intermediate person can understand, there needs to be an advanced amount of analytics engineering transformation applied.

## Approach

Coming soon.

## Contribution

Coming soon.
