-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
readthedocs.yaml and long description
- Loading branch information
1 parent
4e90ccc
commit 6785b11
Showing
3 changed files
with
58 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,14 @@ | ||
# Read the Docs configuration file for Sphinx projects | ||
|
||
# Required | ||
version: 0.0.5 | ||
|
||
# Set the OS, Python version and other tools you might need | ||
build: | ||
os: ubuntu-22.04 | ||
tools: | ||
python: "3.10" | ||
|
||
# Build documentation in the "docs/" directory with Sphinx | ||
sphinx: | ||
configuration: docs/conf.py |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,42 @@ | ||
# Ficto - Generate Realistic Demo Data | ||
|
||
Ficto is a Python package that allows you to effortlessly generate realistic demo data in CSV or JSON format. With Ficto, you can create datasets with various column types by simply specifying them in a YAML configuration file. | ||
|
||
## Installation & Quick Start | ||
|
||
To install Ficto, use the following `pip` command: | ||
|
||
```bash | ||
pip install ficto | ||
``` | ||
|
||
Generate a dataset by providing a YAML configuration file, the number of rows, and the desired file format. For example, to generate a CSV file with 100 rows using a configuration file named config.yaml, run the following command: | ||
|
||
```bash | ||
ficto -d config.yaml -n 100 -f csv | ||
``` | ||
|
||
## Features | ||
* **Flexible Configuration:** Customize your dataset by defining columns and their types in a YAML file. | ||
* **Multiple Formats:** Generate datasets in either CSV or JSON format. | ||
* **Easy Installation:** Install Ficto effortlessly with a single pip command. | ||
* **Realistic Demo Data:** Create realistic data for testing purpose. | ||
* **Command-Line Interface (CLI):** User-friendly CLI for quick and simple data generation. | ||
|
||
## Usage | ||
1. **Create Configuration File:** Create a YAML file (e.g., config.yaml) specifying the columns and their types. | ||
|
||
You can find a template [here](https://github.com/taeefnajib/ficto/blob/main/config-template.yaml) containing all the types of column you can add to your dataset. To know more about each value type, kindly read the documentation. | ||
|
||
2. **Generate Data:** Use the Ficto CLI to generate data based on your configuration. | ||
|
||
```bash | ||
ficto -d config.yaml -n 100 -f csv | ||
``` | ||
This command generates a CSV file inside a newly created `data` folder with 100 rows of demo data based on your data configuration file (i.e.`config.yaml`). | ||
|
||
## Documentation | ||
For more details and advanced usage, refer to the Ficto Documentation. | ||
|
||
## License | ||
This project is licensed under the [MIT License](https://github.com/taeefnajib/ficto/blob/main/LICENSE) |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters