fakedata-python 1.0.0__tar.gz

fakedata_python-1.0.0/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: fakedata-python
+Version: 1.0.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 (Python)
+
+[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+A high-performance, **zero-dependency** mock data generation engine ported to Python. Designed for testing, prototyping, and local development.
+
+Whether you're building a backend prototype, seeding a database with thousands of records, or developing complex data-driven tests, `fakedata` provides a structured API for generating high-quality synthetic data across multiple domains.
+
+---
+
+##  Key Features
+
+- **Zero External Dependencies**: Uses only Python standard libraries (`json`, `random`, `pathlib`).
+- **Modular Architecture**: Separate namespaces for data, entertainment, anime, and biology.
+- **Rich Datasets**: Bundled with comprehensive JSON assets (Pokemon, Users, Industry-standard resumes).
+- **Type Hinting**: Built-in support for IDE intellisense.
+- **Fast Execution**: Optimized for generating large datasets with minimal overhead.
+
+---
+
+##  Installation
+
+Install the package locally:
+
+```bash
+pip install .
+```
+
+---
+
+##  Quick Start
+
+```python
+import fakedata
+
+# 1. Generate a comprehensive user profile
+user_profile = fakedata.data.user()
+print(f"Identity: {user_profile['fullName']} | City: {user_profile['address']['city']}")
+
+# 2. Fetch specialized entertainment data
+pokemon = fakedata.fun.pokemon()
+random_joke = fakedata.fun.joke()
+
+# 3. Filter specific anime content
+naruto_quotes = fakedata.anime.quotes_by_show('Naruto')
+```
+
+---
+
+## API Documentation
+
+###  Data Module (`fakedata.data`)
+Focused on professional-grade mock data for PII and enterprise simulations.
+
+| Method | Return Type | Description |
+| :--- | :--- | :--- |
+| `user()` | `dict` | Generates a full profile (Personal Details, Address, Job, Bank Info). |
+| `users(count)` | `list` | Returns a list of `n` unique user profiles. |
+| `creditcard()` | `dict` | Generates realistic credit card data (Number, Expiry, CVV). |
+| `resume(count)` | `list` | Mock professional resumes with skills, experience, and education. |
+| `get_password(len)`| `dict` | Secure random password generator (default length: 8). |
+| `get_email()` | `dict` | Randomly generated email address. |
+| `get_city()` | `dict` | Global city name. |
+
+###  Fun (`fakedata.fun`)
+Dynamic content for gaming and entertainment applications.
+
+| Method | Return Type | Description |
+| :--- | :--- | :--- |
+| `pokemon()` | `dict` | Returns a random Pokemon with full stats, types, and abilities. |
+| `pokemon_by_type(t)`| `dict` | Filters Pokemon by specific type (e.g., 'Fire', 'Water'). |
+| `joke()` | `dict` | Randomly selected joke across various categories. |
+| `fact()` | `dict` | General knowledge facts for engagement. |
+| `fortune()` | `dict` | Philosophical or funny fortune cookies. |
+
+###  Anime Module (`fakedata.anime`)
+Curated datasets for anime-themed projects.
+
+| Method | Return Type | Description |
+| :--- | :--- | :--- |
+| `quote()` | `dict` | Iconic quotes with character and show attribution. |
+| `quotes_by_show(s)` | `dict` | All available quotes from a specific anime title. |
+| `fact()` | `dict` | Specialized trivia regarding anime history and trivia. |
+
+###  Animals Module (`fakedata.animals`)
+Simple biological data and interesting facts.
+
+| Method | Return Type | Description |
+| :--- | :--- | :--- |
+| `random_animal()` | `dict` | Returns a random animal profile. |
+| `dog_fact()` | `dict` | Canine-specific trivia and biological facts. |
+| `cat_fact()` | `dict` | Feline-specific trivia and statistics. |
+
+---
+
+##  Testing
+
+To run the local test suite:
+
+```bash
+python test_python.py
+```
+
+---
+
+##  Development & Contributions
+
+Contributions are welcome! If you'd like to add new datasets or modules, please follow these steps:
+
+1. Clone the repository.
+2. Implement your changes in `fakedata/modules/`.
+3. Add relevant tests in `tests/`.
+4. Submit a Pull Request.
+
+---
+
+##  License
+
+Distributed under the **MIT License**. See `LICENSE` for more information.
+
+**Maintainer**: [abhay557](https://github.com/abhay557)

fakedata_python-1.0.0/README.md

@@ -0,0 +1,122 @@
+# fakedata (Python)
+
+[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue.svg)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+A high-performance, **zero-dependency** mock data generation engine ported to Python. Designed for testing, prototyping, and local development.
+
+Whether you're building a backend prototype, seeding a database with thousands of records, or developing complex data-driven tests, `fakedata` provides a structured API for generating high-quality synthetic data across multiple domains.
+
+---
+
+##  Key Features
+
+- **Zero External Dependencies**: Uses only Python standard libraries (`json`, `random`, `pathlib`).
+- **Modular Architecture**: Separate namespaces for data, entertainment, anime, and biology.
+- **Rich Datasets**: Bundled with comprehensive JSON assets (Pokemon, Users, Industry-standard resumes).
+- **Type Hinting**: Built-in support for IDE intellisense.
+- **Fast Execution**: Optimized for generating large datasets with minimal overhead.
+
+---
+
+##  Installation
+
+Install the package locally:
+
+```bash
+pip install .
+```
+
+---
+
+##  Quick Start
+
+```python
+import fakedata
+
+# 1. Generate a comprehensive user profile
+user_profile = fakedata.data.user()
+print(f"Identity: {user_profile['fullName']} | City: {user_profile['address']['city']}")
+
+# 2. Fetch specialized entertainment data
+pokemon = fakedata.fun.pokemon()
+random_joke = fakedata.fun.joke()
+
+# 3. Filter specific anime content
+naruto_quotes = fakedata.anime.quotes_by_show('Naruto')
+```
+
+---
+
+## API Documentation
+
+###  Data Module (`fakedata.data`)
+Focused on professional-grade mock data for PII and enterprise simulations.
+
+| Method | Return Type | Description |
+| :--- | :--- | :--- |
+| `user()` | `dict` | Generates a full profile (Personal Details, Address, Job, Bank Info). |
+| `users(count)` | `list` | Returns a list of `n` unique user profiles. |
+| `creditcard()` | `dict` | Generates realistic credit card data (Number, Expiry, CVV). |
+| `resume(count)` | `list` | Mock professional resumes with skills, experience, and education. |
+| `get_password(len)`| `dict` | Secure random password generator (default length: 8). |
+| `get_email()` | `dict` | Randomly generated email address. |
+| `get_city()` | `dict` | Global city name. |
+
+###  Fun (`fakedata.fun`)
+Dynamic content for gaming and entertainment applications.
+
+| Method | Return Type | Description |
+| :--- | :--- | :--- |
+| `pokemon()` | `dict` | Returns a random Pokemon with full stats, types, and abilities. |
+| `pokemon_by_type(t)`| `dict` | Filters Pokemon by specific type (e.g., 'Fire', 'Water'). |
+| `joke()` | `dict` | Randomly selected joke across various categories. |
+| `fact()` | `dict` | General knowledge facts for engagement. |
+| `fortune()` | `dict` | Philosophical or funny fortune cookies. |
+
+###  Anime Module (`fakedata.anime`)
+Curated datasets for anime-themed projects.
+
+| Method | Return Type | Description |
+| :--- | :--- | :--- |
+| `quote()` | `dict` | Iconic quotes with character and show attribution. |
+| `quotes_by_show(s)` | `dict` | All available quotes from a specific anime title. |
+| `fact()` | `dict` | Specialized trivia regarding anime history and trivia. |
+
+###  Animals Module (`fakedata.animals`)
+Simple biological data and interesting facts.
+
+| Method | Return Type | Description |
+| :--- | :--- | :--- |
+| `random_animal()` | `dict` | Returns a random animal profile. |
+| `dog_fact()` | `dict` | Canine-specific trivia and biological facts. |
+| `cat_fact()` | `dict` | Feline-specific trivia and statistics. |
+
+---
+
+##  Testing
+
+To run the local test suite:
+
+```bash
+python test_python.py
+```
+
+---
+
+##  Development & Contributions
+
+Contributions are welcome! If you'd like to add new datasets or modules, please follow these steps:
+
+1. Clone the repository.
+2. Implement your changes in `fakedata/modules/`.
+3. Add relevant tests in `tests/`.
+4. Submit a Pull Request.
+
+---
+
+##  License
+
+Distributed under the **MIT License**. See `LICENSE` for more information.
+
+**Maintainer**: [abhay557](https://github.com/abhay557)

fakedata_python-1.0.0/fakedata/__init__.py

@@ -0,0 +1,6 @@
+from .modules import data, fun, anime, animals
+
+__version__ = "1.0.0"
+__author__ = "abhay557"
+
+__all__ = ["data", "fun", "anime", "animals"]

fakedata_python-1.0.0/fakedata/core.py

@@ -0,0 +1,15 @@
+import json
+import os
+from pathlib import Path
+
+# Base directory for helpers
+HELPER_DIR = Path(__file__).parent / "helpers"
+
+def load_data(filename):
+    """Safely loads a JSON file from the helpers directory."""
+    file_path = HELPER_DIR / filename
+    if not file_path.exists():
+        raise FileNotFoundError(f"Data file not found: {filename}")
+    
+    with open(file_path, "r", encoding="utf-8") as f:
+        return json.load(f)

fakedata_python-1.0.0/fakedata/helpers/animal.json

@@ -0,0 +1,228 @@
+{
+  "animals": [
+    "Aardvark",
+    "Albatross",
+    "Alligator",
+    "Alpaca",
+    "Ant",
+    "Anteater",
+    "Antelope",
+    "Ape",
+    "Armadillo",
+    "Donkey",
+    "Baboon",
+    "Badger",
+    "Barracuda",
+    "Bat",
+    "Bear",
+    "Beaver",
+    "Bee",
+    "Bison",
+    "Boar",
+    "Buffalo",
+    "Butterfly",
+    "Camel",
+    "Capybara",
+    "Caribou",
+    "Cassowary",
+    "Cat",
+    "Caterpillar",
+    "Cattle",
+    "Chamois",
+    "Cheetah",
+    "Chicken",
+    "Chimpanzee",
+    "Chinchilla",
+    "Chough",
+    "Clam",
+    "Cobra",
+    "Cockroach",
+    "Cod",
+    "Cormorant",
+    "Coyote",
+    "Crab",
+    "Crane",
+    "Crocodile",
+    "Crow",
+    "Curlew",
+    "Deer",
+    "Dinosaur",
+    "Dog",
+    "Dogfish",
+    "Dolphin",
+    "Dotterel",
+    "Dove",
+    "Dragonfly",
+    "Duck",
+    "Dugong",
+    "Dunlin",
+    "Eagle",
+    "Echidna",
+    "Eel",
+    "Eland",
+    "Elephant",
+    "Elk",
+    "Emu",
+    "Falcon",
+    "Ferret",
+    "Finch",
+    "Fish",
+    "Flamingo",
+    "Fly",
+    "Fox",
+    "Frog",
+    "Gaur",
+    "Gazelle",
+    "Gerbil",
+    "Giraffe",
+    "Gnat",
+    "Gnu",
+    "Goat",
+    "Goldfinch",
+    "Goldfish",
+    "Goose",
+    "Gorilla",
+    "Goshawk",
+    "Grasshopper",
+    "Grouse",
+    "Guanaco",
+    "Gull",
+    "Hamster",
+    "Hare",
+    "Hawk",
+    "Hedgehog",
+    "Heron",
+    "Herring",
+    "Hippopotamus",
+    "Hornet",
+    "Horse",
+    "Human",
+    "Hummingbird",
+    "Hyena",
+    "Ibex",
+    "Ibis",
+    "Jackal",
+    "Jaguar",
+    "Jay",
+    "Jellyfish",
+    "Kangaroo",
+    "Kingfisher",
+    "Koala",
+    "Kookabura",
+    "Kouprey",
+    "Kudu",
+    "Lapwing",
+    "Lark",
+    "Lemur",
+    "Leopard",
+    "Lion",
+    "Llama",
+    "Lobster",
+    "Locust",
+    "Loris",
+    "Louse",
+    "Lyrebird",
+    "Magpie",
+    "Mallard",
+    "Manatee",
+    "Mandrill",
+    "Mantis",
+    "Marten",
+    "Meerkat",
+    "Mink",
+    "Mole",
+    "Mongoose",
+    "Monkey",
+    "Moose",
+    "Mosquito",
+    "Mouse",
+    "Mule",
+    "Narwhal",
+    "Newt",
+    "Nightingale",
+    "Octopus",
+    "Okapi",
+    "Opossum",
+    "Oryx",
+    "Ostrich",
+    "Otter",
+    "Owl",
+    "Oyster",
+    "Panther",
+    "Parrot",
+    "Partridge",
+    "Peafowl",
+    "Pelican",
+    "Penguin",
+    "Pheasant",
+    "Pig",
+    "Pigeon",
+    "Pony",
+    "Porcupine",
+    "Porpoise",
+    "Quail",
+    "Quelea",
+    "Quetzal",
+    "Rabbit",
+    "Raccoon",
+    "Rail",
+    "Ram",
+    "Rat",
+    "Raven",
+    "Red deer",
+    "Red panda",
+    "Reindeer",
+    "Rhinoceros",
+    "Rook",
+    "Salamander",
+    "Salmon",
+    "Sand Dollar",
+    "Sandpiper",
+    "Sardine",
+    "Scorpion",
+    "Seahorse",
+    "Seal",
+    "Shark",
+    "Sheep",
+    "Shrew",
+    "Skunk",
+    "Snail",
+    "Snake",
+    "Sparrow",
+    "Spider",
+    "Spoonbill",
+    "Squid",
+    "Squirrel",
+    "Starling",
+    "Stingray",
+    "Stinkbug",
+    "Stork",
+    "Swallow",
+    "Swan",
+    "Tapir",
+    "Tarsier",
+    "Termite",
+    "Tiger",
+    "Toad",
+    "Trout",
+    "Turkey",
+    "Turtle",
+    "Viper",
+    "Vulture",
+    "Wallaby",
+    "Walrus",
+    "Wasp",
+    "Weasel",
+    "Whale",
+    "Wildcat",
+    "Wolf",
+    "Wolverine",
+    "Wombat",
+    "Woodcock",
+    "Woodpecker",
+    "Worm",
+    "Wren",
+    "Yak",
+    "Zebra"
+  ]
+}