Metadata-Version: 2.4
Name: fakedata-python
Version: 1.1.0
Summary: A versatile mock data and entertainment content generator ported to Python.
Author-email: abhay557 <abhaycormourya@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/abhay557/fakedata
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown

# fakedata 
[![PyPI Version](https://img.shields.io/pypi/v/fakedata-python?color=blue&label=pypi)](https://pypi.org/project/fakedata-python/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

A high-performance, **zero-dependency** mock data generation engine for **Python**. Designed for testing, prototyping, and local development.

---

##  Overview

`fakedata` is a utility library that provides a structured API for generating high-quality synthetic data in Python.

### Core Modules:
- **Data**: Professional-grade PII, addresses, and enterprise resumes.
- **Fun**: Pokemon stats, jokes, facts, and fortune cookies.
- **Anime**: Curated quotes and trivia from iconic series.
- **Animals**: Biological facts and random animal profiles.

---

##  Python Implementation

### Installation
```bash
pip install fakedata-python
```

### Quick Start
```python
import fakedata

# Generate a random user profile
user = fakedata.data.user()
print(f"Name: {user['fullName']} | City: {user['address']['city']}")

# Fetch a random Pokemon
poke = fakedata.fun.pokemon()
print(f"Random Pokemon: {poke['name']} ({poke['Type 1']})")
```



---

##  API Reference

| Namespace | Method | Description |
| :--- | :--- | :--- |
| `data` | `user()` | Full identity profile (Name, Address, Job, Bank, Hobbies, Tech Profile). |
| `data` | `users(n)` | Returns an array of `n` unique user profiles. |
| `data` | `creditcard()` | Realistic credit card data (Number, Expiry, CVV). |
| `fun` | `pokemon()` | Random Pokemon with stats and types. |
| `fun` | `joke()` | Random joke across various categories. |
| `anime` | `quote()` | Iconic anime quotes with character attribution. |
| `anime` | `quotes_by_show(s)` | Filtered quotes from a specific show. |
| `animals` | `random_animal()` | Random animal profile and interesting facts. |

---

##  Why use fakedata?

1. **Zero Dependencies**: Pure implementation using native language features.
2. **Optimized for Speed**: Datasets are pre-loaded or efficiently indexed for rapid generation of large datasets.
3. **Rich Datasets**: Bundled with comprehensive JSON assets, no internet connection required.

---

## Contributing

Contributions are welcome! If you'd like to add new datasets or modules:
1. Ensure changes are implemented in `fakedata/`.
2. Maintain naming parity for methods and JSON keys.
3. Submit a Pull Request.

---

## License

Distributed under the **MIT License**. See `LICENSE` for more information.

**Maintainer**: [abhay557](https://github.com/abhay557)

- Project Commit History - ```https://github.com/abhay557/random-api.xyz```
