Skip to content

Commit

Permalink
readthedocs.yaml and long description
Browse files Browse the repository at this point in the history
  • Loading branch information
taeefnajib committed Nov 24, 2023
1 parent 4e90ccc commit 6785b11
Show file tree
Hide file tree
Showing 3 changed files with 58 additions and 2 deletions.
14 changes: 14 additions & 0 deletions .readthedocs.yaml
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
42 changes: 42 additions & 0 deletions PyPi.md
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)
4 changes: 2 additions & 2 deletions setup.py
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
import setuptools

with open("README.md", "r", encoding="utf-8") as f:
with open("PyPi.md", "r", encoding="utf-8") as f:
long_description = f.read()

__version__ = "0.0.4"
__version__ = "0.0.5"

REPO_NAME = "ficto"
AUTHOR_USER_NAME = "taeefnajib"
Expand Down

0 comments on commit 6785b11

Please sign in to comment.