# Rando-wisdom (Creative library)
`Rando-wisdom` is a versatile Python library designed to inject a dose of variety and entertainment into your projects. This all-in-one library offers functionalities to generate random content, ensuring a delightful and engaging experience for users. It uses different APIs to generate random content. If you are lazy or having problem with generating something creative, this library is for you!
**Table of Contents:**
1. [Installation](#installation)
2. [Basic Usage](#basic-usage)
- [1. Generates random advice](#1-generating-random-advice)
- [2. Generates random jokes](#2-generates-random-joke-or-jokes)
- [3. Produces a random quote](#3-produce-random-quote)
- [4. Generates a random useless fact](#4-generating-random-useless-fact)
- [5. Generates fully random user info](#5-fully-random-user-info-generating)
3. [License](#license)
4. [Author](#author)
5. [Links](#links)
## Installation
You can easily install `Rando-wisdom` using `pip`:
```shell
pip install rando-wisdom
```
## Basic Usage
### 1. Generating random advice
Access a curated collection of inspiring and thought-provoking quotes to add wisdom and motivation to your applications.
#### Example:
```python
from rando_wisdom import get_advice
advice = get_advice()
print(advice['advice'])
#Example output: Once you find a really good friend don't do anything that could mess up your friendship.
```
### 2. Generates random joke or jokes
Bring humor to your projects with a vast array of jokes covering various categories, guaranteed to bring a smile to users' faces.
#### Example:
```python
result = get_random_joke(type="twopart", amount=1, aboutProgramming=False)
print_jokes(result)
#Example output:
#Category: Pun
#Jackson: Why does the size of the snack not matter to a giraffe?
#Olivia: Because even a little bit goes a long way.
#or
result = get_random_joke(type="single", amount=2, aboutProgramming=True)
print_jokes(result)
#Example output:
#Amount: 2
#Joke 1 - Eight bytes walk into a bar.
#The bartender asks, "Can I get you anything?"
#"Yeah," reply the bytes.
#"Make us a double."
#Joke 2 - A byte walks into a bar looking miserable.
#The bartender asks it: "What's wrong buddy?"
#"Parity error." it replies.
#"Ah that makes sense, I thought you looked a bit off."
```
### 3. Produce random quote
`Rando-wisdom` can produce quote, here is example how to do it.
#### Example:
```python
from rando_wisdom import get_random_quote
tags = ["inspirational"]
max_length = 100
random_quote = get_random_quote(tags=tags, max_length=max_length)
if random_quote:
print("Random Quote:")
print(f"Author: {random_quote['author']}")
print(f"Content: {random_quote['content']}")
print(f"Tags: {random_quote['tags']}")
print(f"Length: {random_quote['length']}")
print(f"Date Added: {random_quote['dateAdded']}")
print(f"Date Modified: {random_quote['dateModified']}")
else:
print("Failed to retrieve a quote.")
#Example output:
#Random Quote:
#Author: Johann Wolfgang von Goethe
#Content: Knowing is not enough; we must apply!
#Tags: ['Famous Quotes', 'Inspirational']
#Length: 37
#Date Added: 2019-11-16
#Date Modified: 2023-04-14
```
### 4. Generating random useless fact
Infuse curiosity with useless yet fascinating facts that spark interest and trivia enthusiasts.
#### Example:
```python
from rando_wisdom import get_random_useless_fact
random_fact = get_random_useless_fact()
if random_fact:
print(random_fact)
#Example output: The most common name in world is Mohammed.
```
### 5. Fully random user info generating
Generate random user profiles with diverse attributes, ideal for testing or creating realistic mock scenarios in your applications.
#### Example:
```python
from rando_wisdom import get_random_user
random_user = get_random_user()
if random_user:
print("Random User:")
print(
f"Name: {random_user['name']['title']} {random_user['name']['first']} {random_user['name']['last']}"
)
print(f"Gender: {random_user['gender']}")
print(
f"Location: {random_user['location']['city']}, {random_user['location']['state']}, {random_user['location']['country']}"
)
print(f"Email: {random_user['email']}")
print(f"Username: {random_user['login']['username']}")
print(f"Phone: {random_user['phone']}")
print(f"Cell: {random_user['cell']}")
print(f"Nationality: {random_user['nat']}")
print(f"Profile Picture: {random_user['picture']['large']}")
else:
print("Failed to retrieve a random user.")
#Example output:
#Random User:
# Name: Mr Dorian Fabre
# Gender: male
# Location: Brest, Deux-Sèvres, France
# Email: dorian.fabre@example.com
# Username: silverbutterfly775
# Phone: 01-30-10-45-31
# Cell: 06-48-58-91-52
# Nationality: FR
# Profile Picture: https://randomuser.me/api/portraits/men/21.jpg
```
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
## Author
- [Imranqsl212](https://github.com/Imranqsl212)
## Links
- [GitHub repository](https://github.com/Imranqsl212/rando_wisdom)
- [Telegram](https://t.me/wh0s1mran)
Feel free and creative to explore and utilize the various features of `Random-wisdom` for your project needs.
Raw data
{
"_id": null,
"home_page": "https://github.com/Imranqsl212/rando_wisdom",
"name": "rando-wisdom",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "Quotes Generator,User Profile Generator,Random Jokes,Python Content Library,Test Data Generator,User Simulation Tools,Python Content Library,Advice Generator",
"author": "Imranqsl212",
"author_email": "zakirovimran333@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/2c/aa/a269e30449fd4ebfc14943303735c37354801e61676d4decf204b43f4587/rando_wisdom-1.0.4.tar.gz",
"platform": null,
"description": "# Rando-wisdom (Creative library)\n\n`Rando-wisdom` is a versatile Python library designed to inject a dose of variety and entertainment into your projects. This all-in-one library offers functionalities to generate random content, ensuring a delightful and engaging experience for users. It uses different APIs to generate random content. If you are lazy or having problem with generating something creative, this library is for you!\n**Table of Contents:**\n\n1. [Installation](#installation)\n2. [Basic Usage](#basic-usage)\n - [1. Generates random advice](#1-generating-random-advice)\n - [2. Generates random jokes](#2-generates-random-joke-or-jokes)\n - [3. Produces a random quote](#3-produce-random-quote)\n - [4. Generates a random useless fact](#4-generating-random-useless-fact)\n - [5. Generates fully random user info](#5-fully-random-user-info-generating)\n3. [License](#license)\n4. [Author](#author)\n5. [Links](#links)\n\n## Installation\n\nYou can easily install `Rando-wisdom` using `pip`:\n\n```shell\npip install rando-wisdom\n```\n\n## Basic Usage\n\n### 1. Generating random advice\n\nAccess a curated collection of inspiring and thought-provoking quotes to add wisdom and motivation to your applications.\n\n\n#### Example:\n\n```python\nfrom rando_wisdom import get_advice\n\nadvice = get_advice()\nprint(advice['advice'])\n#Example output: Once you find a really good friend don't do anything that could mess up your friendship.\n```\n\n### 2. Generates random joke or jokes\n\nBring humor to your projects with a vast array of jokes covering various categories, guaranteed to bring a smile to users' faces.\n\n#### Example:\n\n```python\nresult = get_random_joke(type=\"twopart\", amount=1, aboutProgramming=False)\nprint_jokes(result)\n\n#Example output:\n#Category: Pun\n#Jackson: Why does the size of the snack not matter to a giraffe?\n#Olivia: Because even a little bit goes a long way.\n\n\n#or\n\n\nresult = get_random_joke(type=\"single\", amount=2, aboutProgramming=True)\nprint_jokes(result)\n\n#Example output:\n#Amount: 2\n#Joke 1 - Eight bytes walk into a bar.\n#The bartender asks, \"Can I get you anything?\"\n#\"Yeah,\" reply the bytes.\n#\"Make us a double.\"\n#Joke 2 - A byte walks into a bar looking miserable.\n#The bartender asks it: \"What's wrong buddy?\"\n#\"Parity error.\" it replies. \n#\"Ah that makes sense, I thought you looked a bit off.\"\n\n```\n\n### 3. Produce random quote\n\n`Rando-wisdom` can produce quote, here is example how to do it.\n\n#### Example:\n\n```python\nfrom rando_wisdom import get_random_quote\n\ntags = [\"inspirational\"]\nmax_length = 100\n\nrandom_quote = get_random_quote(tags=tags, max_length=max_length)\n\nif random_quote:\n print(\"Random Quote:\")\n print(f\"Author: {random_quote['author']}\")\n print(f\"Content: {random_quote['content']}\")\n print(f\"Tags: {random_quote['tags']}\")\n print(f\"Length: {random_quote['length']}\")\n print(f\"Date Added: {random_quote['dateAdded']}\")\n print(f\"Date Modified: {random_quote['dateModified']}\")\nelse:\n print(\"Failed to retrieve a quote.\")\n\n#Example output:\n#Random Quote:\n#Author: Johann Wolfgang von Goethe\n#Content: Knowing is not enough; we must apply!\n#Tags: ['Famous Quotes', 'Inspirational']\n#Length: 37\n#Date Added: 2019-11-16\n#Date Modified: 2023-04-14\n```\n\n### 4. Generating random useless fact\n\nInfuse curiosity with useless yet fascinating facts that spark interest and trivia enthusiasts.\n\n#### Example:\n\n```python\nfrom rando_wisdom import get_random_useless_fact\n\n\nrandom_fact = get_random_useless_fact()\nif random_fact:\n print(random_fact)\n\n#Example output: The most common name in world is Mohammed.\n```\n\n### 5. Fully random user info generating\n\nGenerate random user profiles with diverse attributes, ideal for testing or creating realistic mock scenarios in your applications.\n\n#### Example:\n\n```python\nfrom rando_wisdom import get_random_user\n\n\nrandom_user = get_random_user()\n\nif random_user:\n print(\"Random User:\")\n print(\n f\"Name: {random_user['name']['title']} {random_user['name']['first']} {random_user['name']['last']}\"\n )\n print(f\"Gender: {random_user['gender']}\")\n print(\n f\"Location: {random_user['location']['city']}, {random_user['location']['state']}, {random_user['location']['country']}\"\n )\n print(f\"Email: {random_user['email']}\")\n print(f\"Username: {random_user['login']['username']}\")\n print(f\"Phone: {random_user['phone']}\")\n print(f\"Cell: {random_user['cell']}\")\n print(f\"Nationality: {random_user['nat']}\")\n print(f\"Profile Picture: {random_user['picture']['large']}\")\n\nelse:\n print(\"Failed to retrieve a random user.\")\n\n#Example output:\n#Random User:\n# Name: Mr Dorian Fabre\n# Gender: male\n# Location: Brest, Deux-S\u00e8vres, France\n# Email: dorian.fabre@example.com\n# Username: silverbutterfly775\n# Phone: 01-30-10-45-31\n# Cell: 06-48-58-91-52\n# Nationality: FR\n# Profile Picture: https://randomuser.me/api/portraits/men/21.jpg\n\n```\n\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Author\n\n- [Imranqsl212](https://github.com/Imranqsl212)\n\n## Links\n\n- [GitHub repository](https://github.com/Imranqsl212/rando_wisdom)\n- [Telegram](https://t.me/wh0s1mran)\n\nFeel free and creative to explore and utilize the various features of `Random-wisdom` for your project needs.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Rando-wisdom is a versatile Python library designed to inject a dose of variety and entertainment into your projects. This all-in-one library offers functionalities to generate random content, ensuring a delightful and engaging experience for users.",
"version": "1.0.4",
"project_urls": {
"Homepage": "https://github.com/Imranqsl212/rando_wisdom"
},
"split_keywords": [
"quotes generator",
"user profile generator",
"random jokes",
"python content library",
"test data generator",
"user simulation tools",
"python content library",
"advice generator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2caaa269e30449fd4ebfc14943303735c37354801e61676d4decf204b43f4587",
"md5": "f73f00624cf3236770e5198bf636bef2",
"sha256": "b34814174de7be5078741e99722502097cb231dfe9021f43fd68b5dfccda6069"
},
"downloads": -1,
"filename": "rando_wisdom-1.0.4.tar.gz",
"has_sig": false,
"md5_digest": "f73f00624cf3236770e5198bf636bef2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 6133,
"upload_time": "2024-01-09T16:18:06",
"upload_time_iso_8601": "2024-01-09T16:18:06.865011Z",
"url": "https://files.pythonhosted.org/packages/2c/aa/a269e30449fd4ebfc14943303735c37354801e61676d4decf204b43f4587/rando_wisdom-1.0.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-01-09 16:18:06",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Imranqsl212",
"github_project": "rando_wisdom",
"github_not_found": true,
"lcname": "rando-wisdom"
}
JSON
