Metadata-Version: 2.4
Name: snowfakery
Version: 4.2.0
Summary: Snowfakery is a tool for generating fake data that has relations between tables. Every row is faked data, but also unique and random, like a snowflake.
Project-URL: Homepage, https://github.com/SFDO-Tooling/Snowfakery
Project-URL: Bug Tracker, https://github.com/SFDO-Tooling/Snowfakery/issues
Author-email: Paul Prescod <pprescod@salesforce.com>, "Salesforce.org" <sfdo-mrbelvedere@salesforce.com>
License: BSD 3-Clause License
License-File: LICENSE
Keywords: data generation,fake data,salesforce,snowfakery
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: click
Requires-Dist: faker
Requires-Dist: faker-edu
Requires-Dist: faker-nonprofit
Requires-Dist: gvgen
Requires-Dist: jinja2
Requires-Dist: pydantic<3,>=2
Requires-Dist: python-baseconv
Requires-Dist: python-dateutil
Requires-Dist: pyyaml
Requires-Dist: requests
Requires-Dist: setuptools>=75.4.0
Requires-Dist: sqlalchemy<3
Description-Content-Type: text/markdown

[![Coverage Status](https://coveralls.io/repos/github/SFDO-Tooling/Snowfakery/badge.svg?branch=main)](https://coveralls.io/github/SFDO-Tooling/Snowfakery?branch=main)

# Snowfakery Documentation

Snowfakery is a tool for generating fake data that has relations between tables. Every row is faked data, but also unique and random, like a snowflake.

To tell Snowfakery what data you want to generate, you need to write a Recipe file in YAML.

Snowfakery can write its output to stdout, or any database accessible to SQLAlchemy. **When it is embedded in CumulusCI it can output to a Salesforce org**. Adding new output formats is fairly straightforward and open source contributions of that form are gratefully accepted.

[Documentation](https://snowfakery.readthedocs.io)

## Contributing

To contribute to snowfakery you will first need to setup a [virtual environment](https://docs.python.org/3/tutorial/venv.html).
Once you have youre virtual environment, you can install dependencies via pip:

`pip install -r requirements_dev.txt`

Or you can install dependencies via pip tools:

```python
make dev-install
```

Now you're all set for contributing to Snowfakery!

### Updating Dependencies

Performing dependency updates is easy. Just run `make update-deps` and commit any changes to `requirements/prod.txt` and `requirements/dev.txt`.
