fakedata-python 1.0.0__py3-none-any.whl

fakedata/modules/__init__.py

@@ -0,0 +1 @@
+from . import data, fun, anime, animals

fakedata/modules/animals.py

@@ -0,0 +1,19 @@
+import random
+from ..core import load_data
+
+# Load datasets
+animal_data = load_data('animal.json')
+cat_fact_data = load_data('catfact.json')
+dog_fact_data = load_data('dogfact.json')
+
+def get_random(arr):
+    return random.choice(arr)
+
+def random_animal():
+    return {"animal": get_random(animal_data['animals'])}
+
+def cat_fact():
+    return {"fact": get_random(cat_fact_data['facts'])}
+
+def dog_fact():
+    return {"fact": get_random(dog_fact_data['facts'])}

fakedata/modules/anime.py

@@ -0,0 +1,37 @@
+import random
+from ..core import load_data
+
+# Load datasets
+quote_data = load_data('animequote.json')
+fact_data = load_data('animefact.json')
+
+def get_random(arr):
+    return random.choice(arr)
+
+def quote():
+    item = get_random(quote_data['quotes'])
+    return {
+        "anime": item['anime'],
+        "quote": item['bruh'],
+        "character": item['character'],
+        "id": item.get('id')
+    }
+
+def quotes_by_show(anime_name):
+    filtered = [q for q in quote_data['quotes'] if anime_name.lower() in q['anime'].lower()]
+    if not filtered:
+        return {"error": "No quotes found for this anime"}
+    item = get_random(filtered)
+    return {
+        "anime": item['anime'],
+        "quote": item['bruh'],
+        "character": item['character'],
+        "id": item.get('id')
+    }
+
+def fact():
+    item = get_random(fact_data['facts'])
+    return {
+        "question": item['question'],
+        "answers": item['answers']
+    }

fakedata/modules/data.py

@@ -0,0 +1,179 @@
+import random
+import string
+from ..core import load_data
+
+# Load datasets
+card_data = load_data('cardtype.json')
+occupation_data = load_data('occupation.json')
+domain_data = load_data('domain.json')
+first_names = load_data('first.json')
+middle_names = load_data('middle.json')
+last_names = load_data('last.json')
+emails = load_data('email.json')
+street_data = load_data('street.json')
+state_data = load_data('states.json')
+state_codes = load_data('shortformstate.json')
+
+def get_random(arr):
+    return random.choice(arr)
+
+def generate_single_user(id_index=None):
+    first_name = get_random(first_names['names'])
+    middle_name = get_random(middle_names['father'])
+    last_name = get_random(last_names['surnames'])
+    email_provider = get_random(emails['mails'])
+    card_type = get_random(card_data['cards'])
+    occupation = get_random(occupation_data['occupations'])
+    domain = get_random(domain_data['domains'])
+    street = get_random(street_data['addresses'])
+    state = get_random(state_data['data'])
+
+    user_id = id_index if id_index is not None else random.randint(1, 1000)
+    age = random.randint(18, 38)
+    card_number = random.randint(10**15, 10**16 - 1)
+    card_expiry = f"{random.randint(1, 12)}/{random.randint(25, 35)}"
+    card_cvv = random.randint(100, 999)
+    lat = round(random.uniform(-90, 90), 6)
+    lng = round(random.uniform(-180, 180), 6)
+    ip = ".".join(map(str, (random.randint(0, 255) for _ in range(4))))
+
+    gender_options = ["male", "female", "not provided"]
+    blood_groups = ["+O", "+A", "+B", "+AB", "-O", "-A", "-B", "-AB"]
+    departments = ["PDT Administration", "PDT Marketing", "Transportation", "Shipping", "Human Resources", "Operations", "Inventory", "Sales", "Finance", "Documentation", "Billing", "Control And Credit"]
+
+    phone_number = "".join(random.choices(string.digits, k=10))
+    password = "".join(random.choices(string.ascii_letters + string.digits + "#@$", k=8))
+
+    birth_year = random.randint(1970, 2010)
+    birth_month = random.randint(1, 12)
+    birth_day = random.randint(1, 28)
+
+    return {
+        "id": str(user_id),
+        "fullName": f"{first_name} {middle_name} {last_name}",
+        "firstName": first_name,
+        "lastName": middle_name,
+        "middleName": last_name,
+        "age": str(age),
+        "gender": get_random(gender_options),
+        "email": f"{first_name.lower()}@{email_provider}",
+        "phone": f"+1 {phone_number}",
+        "username": f"{first_name.lower()}{user_id}",
+        "password": password,
+        "birthDate": f"{birth_month}/{birth_day}/{birth_year}",
+        "bloodGroup": get_random(blood_groups),
+        "height": random.randint(100, 200),
+        "weight": random.randint(50, 100),
+        "domain": f"{first_name.lower()}{last_name.lower()}{domain['tlds']}",
+        "ip": ip,
+        "macaddress": ":".join(f"{random.randint(0, 255):02X}" for _ in range(6)),
+        "address": {
+            "street": f"Street {street['address']}",
+            "city": state['city'],
+            "state": state['state'],
+            "country": "United States Of America",
+            "zipCode": random.randint(10000, 99999),
+            "coordinates": {"latitude": str(lat), "longitude": str(lng)}
+        },
+        "university": f"{state['city']} University",
+        "bank": {
+            "nameOnCard": f"{first_name} {middle_name} {last_name}",
+            "cardNumber": str(card_number),
+            "cardType": card_type,
+            "cardExpiry": card_expiry,
+            "cardCvv": str(card_cvv),
+        },
+        "occupation": {
+            "title": occupation,
+            "salary": f"{random.randint(5000, 50000)}$",
+            "department": get_random(departments),
+        }
+    }
+
+def user():
+    return generate_single_user()
+
+def users(count=10):
+    return [generate_single_user(i + 1) for i in range(count)]
+
+def get_email():
+    fn = get_random(first_names['names'])
+    ln = get_random(last_names['surnames'])
+    domain = get_random(emails['mails'])
+    return {"email": f"{fn.lower()}.{ln.lower()}@{domain}"}
+
+def get_username():
+    fn = get_random(first_names['names'])
+    user_id = random.randint(1, 1000)
+    return {"username": f"{fn.lower()}{user_id}"}
+
+def get_password(length=8):
+    charset = string.ascii_letters + string.digits + "#@$"
+    return {"password": "".join(random.choices(charset, k=length))}
+
+def get_zip_code():
+    return {"zipCode": random.randint(10000, 99999)}
+
+def get_coordinates():
+    return {
+        "latitude": str(round(random.uniform(-90, 90), 6)),
+        "longitude": str(round(random.uniform(-180, 180), 6))
+    }
+
+def get_city():
+    return {"city": get_random(state_data['data'])['city']}
+
+def get_state_code():
+    return {"stateCode": get_random(state_codes)}
+
+def creditcard():
+    u = generate_single_user()
+    return {
+        "nameOnCard": u['bank']['nameOnCard'],
+        "cardNumber": u['bank']['cardNumber'],
+        "cardType": u['bank']['cardType'],
+        "cardExpiry": u['bank']['cardExpiry'],
+        "cardCvv": u['bank']['cardCvv'],
+    }
+
+def address():
+    u = generate_single_user()
+    return {
+        "street": u['address']['street'],
+        "city": u['address']['city'],
+        "state": u['address']['state'],
+        "country": u['address']['country'],
+        "zipCode": u['address']['zipCode'],
+        "ip": u['ip'],
+        "macaddress": u['macaddress'],
+        "coordinates": u['address']['coordinates']
+    }
+
+def resume(count=10):
+    resumes = []
+    for i in range(count):
+        u = generate_single_user(i + 1)
+        res = u.copy()
+        res.update({
+            "education": {
+                "level": get_random(["Bachelor's", "Master's", "PhD"]),
+                "major": get_random(["Computer Science", "Business", "Marketing"]),
+                "university": u['university'],
+                "graduationYear": random.randint(2020, 2025)
+            },
+            "skills": random.sample(["JavaScript", "Node.js", "React", "Python", "Docker"], k=3)
+        })
+        resumes.append(res)
+    return resumes
+
+def biodata(count=10):
+    biodatas = []
+    for i in range(count):
+        u = generate_single_user(i + 1)
+        bio = u.copy()
+        bio.update({
+            "personalityType": get_random(["INTJ", "ENFP", "ISTP"]),
+            "favoriteMusic": get_random(["Rock", "Jazz", "Lofi"])
+        })
+        biodatas.append(bio)
+    return biodatas

fakedata/modules/fun.py

@@ -0,0 +1,61 @@
+import random
+from ..core import load_data
+
+# Load datasets
+joke_data = load_data('joke.json')
+fact_data = load_data('fact.json')
+fortune_data = load_data('fortune.json')
+pickup_data = load_data('pickup.json')
+quote_data = load_data('quote.json')
+pokemon_data = load_data('pokemon.json')
+
+def get_random(arr):
+    return random.choice(arr)
+
+def joke():
+    item = get_random(joke_data['jokes'])
+    return {
+        "id": item['id'],
+        "type": item['type'],
+        "setup": item['setup'],
+        "punchline": item['punchline']
+    }
+
+def jokes_by_type(joke_type):
+    filtered = [j for j in joke_data['jokes'] if j['type'].lower() == joke_type.lower()]
+    if not filtered:
+        return {"error": "No jokes found for this type"}
+    item = get_random(filtered)
+    return {
+        "id": item['id'],
+        "type": item['type'],
+        "setup": item['setup'],
+        "punchline": item['punchline']
+    }
+
+def fact():
+    return {"fact": get_random(fact_data['facts'])}
+
+def fortune():
+    return {"fortune": get_random(fortune_data['fortunes'])}
+
+def pickup():
+    return {"pickup": get_random(pickup_data['pickups'])}
+
+def quote():
+    item = get_random(quote_data['quotes'])
+    return {
+        "quote": item['quote'],
+        "author": item['author']
+    }
+
+def pokemon():
+    return get_random(pokemon_data)
+
+def pokemon_by_type(poke_type):
+    filtered = [p for p in pokemon_data if 
+                p['Type 1'].lower() == poke_type.lower() or 
+                (p.get('Type 2') and p['Type 2'].lower() == poke_type.lower())]
+    if not filtered:
+        return {"error": "No pokemon found for this type"}
+    return get_random(filtered)

fakedata/test_python.py

@@ -0,0 +1,29 @@
+import fakedata
+
+def test():
+    print("--- Testing fakedata Python Library ---")
+    
+    # Data
+    user = fakedata.data.user()
+    print(f"\n[Data] Random User: {user['fullName']} from {user['address']['city']}")
+    
+    email = fakedata.data.get_email()
+    print(f"[Data] Random Email: {email['email']}")
+    
+    # Fun
+    poke = fakedata.fun.pokemon()
+    print(f"\n[Fun] Random Pokemon: {poke['name']} ({poke['Type 1']})")
+    
+    joke = fakedata.fun.joke()
+    print(f"[Fun] Joke: {joke['setup']} -> {joke['punchline']}")
+    
+    # Anime
+    quote = fakedata.anime.quotes_by_show("Naruto")
+    print(f"\n[Anime] Naruto Quote: {quote['quote']} - {quote['character']}")
+    
+    # Animals
+    animal = fakedata.animals.random_animal()
+    print(f"\n[Animals] Random Animal: {animal['animal']}")
+
+if __name__ == "__main__":
+    test()

fakedata_python-1.0.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,34 @@
+fakedata/__init__.py,sha256=GFurGog7LOBtwWDYPrn8_AyqTXya1IYjoKzn5tJ18ls,141
+fakedata/core.py,sha256=ZiZ51aZ3cAG7n02Giliq0XO5nN-bbjLJWM3pZQ6gWT4,437
+fakedata/test_python.py,sha256=BSdlxcxWcnbi6kvcIlJtFy-0kEeWBGG5k3VvhrjBJME,844
+fakedata/helpers/animal.json,sha256=7z8dnJSwb_ixoO4F-8fpdn-Gtq36ikCXbZL-anBSTIg,3195
+fakedata/helpers/animefact.json,sha256=AsGid27uaYAq_VcpmZp8Oa98hJyPhys1pAekVTjy1Ow,36415
+fakedata/helpers/animequote.json,sha256=vpDmqJeh3e0mkth3wFrJbY6yEEu35SXZdx2MAw4-MOU,12598
+fakedata/helpers/cardtype.json,sha256=3Ij5N_QPCO1Xg6g7jTp759yOVF9scXkbBDZvWYRaSAM,201
+fakedata/helpers/catfact.json,sha256=bYWRuDbTtXc7wjlR8285G_81kfwXGZI7pdujzSTdDHU,11544
+fakedata/helpers/dogfact.json,sha256=Ao8zQPQ8G4NM3-iwZLoJF8_JjjDhPXcEa99Jszi33ng,48214
+fakedata/helpers/domain.json,sha256=Kqz2wCDQuS7riNLuHGbmD9HGHOJuZMkPAaqx3hqy79k,21872
+fakedata/helpers/email.json,sha256=kXfbmFneGY9vk44WVw73n901sRYibJdjP3RPW0y4Njw,80112
+fakedata/helpers/fact.json,sha256=usHomD8FpiYRQ_WZXnQwyfAnREa6V6PUTTO7eUv9vRM,194240
+fakedata/helpers/first.json,sha256=058xM59Rf9VAx5XkO75YkLY_4f-jpdiEvMrCpxvU3AQ,69794
+fakedata/helpers/fortune.json,sha256=_CDLFnKyanIhxvF0syA6Xhtkl97mMT6zYadPCrjjUs8,21910
+fakedata/helpers/joke.json,sha256=gZt4ynrHP76AWQta5LE4wihTWv5twSRqzgw8KmbWYxw,60303
+fakedata/helpers/last.json,sha256=XBuwhR9q8HhZIOU5g7krw_v2QWYuc25trz_mynEK4HA,160641
+fakedata/helpers/middle.json,sha256=BaK8pl2u9F4vi1-f1rz97lEbi63jhCBg8wgda1hNdGU,53909
+fakedata/helpers/occupation.json,sha256=u77eARP0LZI2MVDSmamaGEuQ3mHgfyqwarO3gBmKCBw,22839
+fakedata/helpers/pickup.json,sha256=dCwjbHZtWw50hjfYlgrHJ38WWlyYq8ksiVlh61MlvkY,1199310
+fakedata/helpers/pokemon.json,sha256=DIN_k_rk9tcfhUHCLSrFs9Y74YOI84HcdTcNca54u6k,209543
+fakedata/helpers/quote.json,sha256=53Xb2Ejk3mR9HEv3rU4mgi-E7_7gAYLYG325IPm2Hlc,712463
+fakedata/helpers/shortformstate.json,sha256=47bqJ12TlEXuauuzr6WKfuXZg0UQEodPPRpyeEH6oK0,506
+fakedata/helpers/state.json,sha256=VAqX6qbWnuSrQwtGSYCrmBrrYxEbGHP0CKHnRO7wijg,842
+fakedata/helpers/states.json,sha256=1NLVCllDcRN8QXp3GTv9iiqeqA8rOOlx2v3_w729jfU,448609
+fakedata/helpers/street.json,sha256=Z-1cRr7uGMXBqlPoqoedPagfx_hLXqbWDNoylcnS8L0,305724
+fakedata/modules/__init__.py,sha256=Mjf8ME6kYjIsrnBKCH3SViF0CpSIkrr5qTZ6Tfr_PbU,40
+fakedata/modules/animals.py,sha256=_TTFa_wQtLdiQONl3MNk5G1dKykXXfCLnv0CMfFFCw4,461
+fakedata/modules/anime.py,sha256=guxfE3sJUNXurBIPAjn6sB-I0RC3YQOF6i8hvisqbvc,939
+fakedata/modules/data.py,sha256=6XrjaOudvfZRskb1wASMCsTemYNcv4bj7shRmhCckoE,6390
+fakedata/modules/fun.py,sha256=0piWxBDHWFOVwJA6gcKqG0c89oy6N4_yV353-OAnTWY,1656
+fakedata_python-1.0.0.dist-info/METADATA,sha256=IO8rpJWrljZrLcwQdqd2jnI-TNpPi3Lndk-FfdcwJIU,4694
+fakedata_python-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+fakedata_python-1.0.0.dist-info/top_level.txt,sha256=SHFa_6848yAE45QgW-PX_DHp_nakY64Zs_t2NobLcn0,9
+fakedata_python-1.0.0.dist-info/RECORD,,

fakedata_python-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fakedata_python-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fakedata