Metadata-Version: 2.1
Name: RandoMorph
Version: 0.0.7
Summary: A simple Python library for generating random data of various types, including strings, names, addresses, numbers, and more.
Home-page: https://github.com/soyll/RandoMorph
Author: soyll
Author-email: soyll@vk.com
Project-URL: GitHub, https://github.com/soyll
Keywords: test python generate random randomorph
Classifier: Programming Language :: Python :: 3.11
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown

# RandoMorph
The **RandoMorph** is a simple Python library designed for generating random data of various types, including strings, names, addresses, numbers, and more. This library is ideal for creating test data, mock-ups, or demonstration samples.

## Table of Contents
* [Getting Started](#getting-started)
  * [Installation](#installation)
* [Usage](#usage)
* [**Arguments**](#arguments)

## Getting Started

### Installation
#### Install using pypi
```bash
pip install randomorph
```
or
* Clone the GitHub repository:
	```bash
	git clone https://github.com/soyll/RandoMorph.git	
	```
* Navigate to directory:
	```bash
	cd RandoMorph	
	```
* (Recommended) Create a virtual environment to manage Python packages for your project:
	```bash
	python3 -m venv venv
	```
* Activate the virtual enviropment
	* On windows:
		```bash
		.\venv\Scripts\activate
		```  
	* On linux or macOs:
		```
		source venv/bin/activate
		```
* Install the required Python packages from  `requirements.txt`:
	```bash
	pip install -r requirments.txt
	```
## Usage

```python
import RandoMorph

# later... ---> ???
```

## Arguments
| Argument Name | Description | Conditions | Example |
| --- | --- | --- | --- |
| `sample` | Examples of data that should be included in the file. Can include addresses, dates, email addresses, user IDs, and names. Multiple options can be specified in any order. | Options: `Address`, `Date`, `Email`, `User_id`, `Name`. Multiple options can be used in different combinations. | `sample='Name' 'Email'` |
| `length` | The length of the table, i.e., the number of rows in the generated file. Limited to values less than 100. | Integer `1<N<100`. | `length=50` |
| `filename` | The name of the file and its extension in which the result will be saved. | A string with a valid file extension (e.g., 'xlsx', 'png', 'json', 'csv'). | `filename='sample_data.xlsx'` |
| `output_path` | The path where the file will be saved. | A string representing the directory path where the file should be saved. | `output_path='/path/to/save/'` |
