# Sadaa - Python Story Generation Package
Unleash Your Imagination with Sadaa!
The Sadaa package is not just a Python library; it's a portal to infinite worlds of imagination. Dive into the universe of science fiction and embark on epic journeys with the power of words.
## Table of Contents
- [Installation](#installation)
- [Usage](#usage)
- [Importing the Module](#importing-the-module)
- [Generating Stories](#generating-stories)
- [Examples](#examples)
- [Example 1 : MoonStoryGenerator - Moonlit Tales](#example-1-moonstorygenerator---moonlit-tales)
- [Example 2: Quantum Stories - Beyond Reality](#example-2-generating-quantum-stories)
- [Example 3: Math-based Adventures - Equations Unleashed](#example-3-generating-math-based-stories)
- [Example 4: Prediction Stories - Glimpses of Tomorrow](#example-4-generating-prediction-stories)
- [Example 5: Akikiki Stories - Mysteries of Akikiki](#example-5-generating-akikiki-stories)
- [Example 6: Quantum Stories with Different Lengths - Size Doesn't Matter](#example-6-generating-quantum-stories-with-different-lengths)
- [Example 7: Math-based Stories with Multiple Tales - Math Marvels](#example-7-generating-math-based-stories-with-multiple-stories)
- [Example Output](#example-output)
- [Contributing](#contributing)
- [License](#license)
## Installation
Embark on your storytelling journey by installing the package with a simple command:
```bash
pip install sadaa
```
## Usage
### Importing the Module
Your gateway to imagination is just an import away:
```python
from sadaa import GenerateStoryWords, AkikikiStoryGenerator
```
### Generating Stories
Ready to craft your tales? You have the power to control the narrative. Choose the number of words, stories, and themes, from quantum to math, or delve into predictions. If you seek the mystical Akikiki stories, they're just a generator away:
```python
story_generator = GenerateStoryWords(num_words=80, num_stories=1, type="quantum")
stories = story_generator.generate_stories()
akikiki_story_generator = AkikikiStoryGenerator(num_stories=3) # Unlock the secrets of Akikiki with 3 captivating stories
akikiki_stories = akikiki_story_generator.generate_stories()
```
## Examples
### Example 1: MoonStoryGenerator - Moonlit Tales
Illuminate your night with stories inspired by the serene Moon:
```python
from sadaa import MoonStoryGenerator
moon_story_generator = MoonStoryGenerator(5)
print("Moon-themed Story:")
print(moon_story_generator.generate_stories())
```
### Example 2: Quantum Stories - Beyond Reality
Enter the quantum realm and explore the limitless possibilities of science:
```python
from sadaa import GenerateStoryWords
story_generator = GenerateStoryWords(num_words=70, num_stories=2, type="quantum")
stories = story_generator.generate_stories()
for i, story in enumerate(stories, start=1):
print(f"Quantum Story {i}:\n{story}\n")
```
### Example 3: Math-based Adventures - Equations Unleashed
Let math take you on a thrilling journey through the world of numbers and equations:
```python
from sadaa import GenerateStoryWords
story_generator = GenerateStoryWords(num_words=90, num_stories=2, type="math")
stories = story_generator.generate_stories()
for i, story in enumerate(stories, start=1):
print(f"Math Story {i}:\n{story}\n")
```
### Example 4: Prediction Stories - Glimpses of Tomorrow
Peek into the future with stories that unravel the mysteries of foresight:
```python
from sadaa import GenerateStoryWords
story_generator = GenerateStoryWords(num_words=70, num_stories=2, type="prediction")
stories = story_generator.generate_stories()
for i, story in enumerate(stories, start=1):
print(f"Prediction Story {i}:\n{story}\n")
```
### Example 5: Akikiki Stories - Mysteries of Akikiki
Discover the enigmatic world of Akikiki with 3 captivating stories:
```python
from sadaa import AkikikiStoryGenerator
akikiki_story_generator = AkikikiStoryGenerator(num_stories=3)
akikiki_stories = akikiki_story_generator.generate_stories()
for i, story in enumerate(akikiki_stories, start=1):
print(f"Akikiki Story {i}:\n{story}\n")
```
### Example 6: Quantum Stories with Different Lengths - Size Doesn't Matter
No matter the length, quantum stories always pack a punch:
```python
from sadaa import GenerateStoryWords
story_generator = GenerateStoryWords(num_words=70, num_stories=3, type="quantum")
stories = story_generator.generate_stories()
for i, story in enumerate(stories, start=1):
print(f"Quantum Story {i}:\n{story}\n")
```
### Example 7: Math-based Stories with Multiple Tales - Math Marvels
Multiply your storytelling prowess with multiple math-based stories:
```python
from sadaa import GenerateStoryWords
story_generator = GenerateStoryWords(num_words=80, num_stories=3, type="math")
stories = story_generator.generate_stories()
for i, story in enumerate(stories, start=1):
print(f"Math Story {i}:\n{story}\n")
```
## Example Output
### Quantum Story (200 Words)
Ready for an epic quantum journey? Generate a quantum-inspired story:
```python
quantum_story = GenerateStoryWords(200,type="quantum").generate_story()
print(quantum_story)
```
**Output**:
> Within the shimmering boundaries of a quantum chaos simulation, Quantum Quester, an interdimensional traveler exploring realms beyond the quantum veil, conducted a successful experiment in quantum teleportation. An ancient artifact revealed the quantum echoes of their past lives. Their mastery of quantum manipulation brought about an era of unbounded creativity and innovation. Amidst the swirling vortices of a quantum fluid experiment, Professor Paradox, a time theorist navigating the intricacies of quantum causality, conducted a successful experiment in quantum teleportation of matter. An ancient prophecy foretold of a quantum savior who would reshape the cosmos. The quantum truths they brought to light would challenge the very core of reality and being. Within the crystalline structure of a quantum lattice system, Professor Samuel Quark, an eccentric inventor known for pushing the boundaries of quantum mechanics, opened a gateway to a realm governed by quantum chaos. They discovered they were living in a simulated quantum universe. The quantum enlightenment they attained would permeate the collective consciousness of their species.
## Contributing
Ready to add your own twist to the tales? Check out our [contributing guidelines](
CONTRIBUTING.md).
## License
This project is licensed under the [MIT License](LICENSE).
**Repository Views** 
Dive into the world of Sadaa and let your imagination run wild! 🚀📚
Raw data
{
"_id": null,
"home_page": "https://github.com/ishanoshada/sadaa",
"name": "sadaa",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "Ishan Oshada",
"author_email": "ic31908@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/0c/38/650872d0478a3b21abdb78f7a59a05f5dfea68eeae3cde9e6eec4a183050/sadaa-0.3.0.tar.gz",
"platform": null,
"description": "# Sadaa - Python Story Generation Package\n\nUnleash Your Imagination with Sadaa!\n\n\n\n\n\nThe Sadaa package is not just a Python library; it's a portal to infinite worlds of imagination. Dive into the universe of science fiction and embark on epic journeys with the power of words.\n\n\n\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n - [Importing the Module](#importing-the-module)\n - [Generating Stories](#generating-stories)\n- [Examples](#examples)\n - [Example 1 : MoonStoryGenerator - Moonlit Tales](#example-1-moonstorygenerator---moonlit-tales)\n - [Example 2: Quantum Stories - Beyond Reality](#example-2-generating-quantum-stories)\n - [Example 3: Math-based Adventures - Equations Unleashed](#example-3-generating-math-based-stories)\n - [Example 4: Prediction Stories - Glimpses of Tomorrow](#example-4-generating-prediction-stories)\n - [Example 5: Akikiki Stories - Mysteries of Akikiki](#example-5-generating-akikiki-stories)\n - [Example 6: Quantum Stories with Different Lengths - Size Doesn't Matter](#example-6-generating-quantum-stories-with-different-lengths)\n - [Example 7: Math-based Stories with Multiple Tales - Math Marvels](#example-7-generating-math-based-stories-with-multiple-stories)\n \n- [Example Output](#example-output)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Installation\n\nEmbark on your storytelling journey by installing the package with a simple command:\n\n```bash\npip install sadaa\n```\n\n## Usage\n\n### Importing the Module\n\nYour gateway to imagination is just an import away:\n\n```python\nfrom sadaa import GenerateStoryWords, AkikikiStoryGenerator \n```\n\n### Generating Stories\n\nReady to craft your tales? You have the power to control the narrative. Choose the number of words, stories, and themes, from quantum to math, or delve into predictions. If you seek the mystical Akikiki stories, they're just a generator away:\n\n```python\nstory_generator = GenerateStoryWords(num_words=80, num_stories=1, type=\"quantum\")\nstories = story_generator.generate_stories()\n\nakikiki_story_generator = AkikikiStoryGenerator(num_stories=3) # Unlock the secrets of Akikiki with 3 captivating stories\nakikiki_stories = akikiki_story_generator.generate_stories()\n```\n\n\n\n## Examples\n\n### Example 1: MoonStoryGenerator - Moonlit Tales\n\nIlluminate your night with stories inspired by the serene Moon:\n\n```python\nfrom sadaa import MoonStoryGenerator\n\nmoon_story_generator = MoonStoryGenerator(5)\n\nprint(\"Moon-themed Story:\")\nprint(moon_story_generator.generate_stories())\n```\n\n### Example 2: Quantum Stories - Beyond Reality\n\nEnter the quantum realm and explore the limitless possibilities of science:\n\n```python\nfrom sadaa import GenerateStoryWords\n\nstory_generator = GenerateStoryWords(num_words=70, num_stories=2, type=\"quantum\")\nstories = story_generator.generate_stories()\n\nfor i, story in enumerate(stories, start=1):\n print(f\"Quantum Story {i}:\\n{story}\\n\")\n```\n\n### Example 3: Math-based Adventures - Equations Unleashed\n\nLet math take you on a thrilling journey through the world of numbers and equations:\n\n```python\nfrom sadaa import GenerateStoryWords\n\nstory_generator = GenerateStoryWords(num_words=90, num_stories=2, type=\"math\")\nstories = story_generator.generate_stories()\n\nfor i, story in enumerate(stories, start=1):\n print(f\"Math Story {i}:\\n{story}\\n\")\n```\n\n### Example 4: Prediction Stories - Glimpses of Tomorrow\n\nPeek into the future with stories that unravel the mysteries of foresight:\n\n```python\nfrom sadaa import GenerateStoryWords\n\nstory_generator = GenerateStoryWords(num_words=70, num_stories=2, type=\"prediction\")\nstories = story_generator.generate_stories()\n\nfor i, story in enumerate(stories, start=1):\n print(f\"Prediction Story {i}:\\n{story}\\n\")\n```\n\n### Example 5: Akikiki Stories - Mysteries of Akikiki\n\nDiscover the enigmatic world of Akikiki with 3 captivating stories:\n\n```python\nfrom sadaa import AkikikiStoryGenerator\n\nakikiki_story_generator = AkikikiStoryGenerator(num_stories=3)\nakikiki_stories = akikiki_story_generator.generate_stories()\n\nfor i, story in enumerate(akikiki_stories, start=1):\n print(f\"Akikiki Story {i}:\\n{story}\\n\")\n```\n\n### Example 6: Quantum Stories with Different Lengths - Size Doesn't Matter\n\nNo matter the length, quantum stories always pack a punch:\n\n```python\nfrom sadaa import GenerateStoryWords\n\nstory_generator = GenerateStoryWords(num_words=70, num_stories=3, type=\"quantum\")\nstories = story_generator.generate_stories()\n\nfor i, story in enumerate(stories, start=1):\n print(f\"Quantum Story {i}:\\n{story}\\n\")\n```\n\n### Example 7: Math-based Stories with Multiple Tales - Math Marvels\n\nMultiply your storytelling prowess with multiple math-based stories:\n\n```python\nfrom sadaa import GenerateStoryWords\n\nstory_generator = GenerateStoryWords(num_words=80, num_stories=3, type=\"math\")\nstories = story_generator.generate_stories()\n\nfor i, story in enumerate(stories, start=1):\n print(f\"Math Story {i}:\\n{story}\\n\")\n```\n\n## Example Output\n\n### Quantum Story (200 Words)\n\nReady for an epic quantum journey? Generate a quantum-inspired story:\n\n```python\nquantum_story = GenerateStoryWords(200,type=\"quantum\").generate_story()\n\nprint(quantum_story)\n```\n\n**Output**:\n\n> Within the shimmering boundaries of a quantum chaos simulation, Quantum Quester, an interdimensional traveler exploring realms beyond the quantum veil, conducted a successful experiment in quantum teleportation. An ancient artifact revealed the quantum echoes of their past lives. Their mastery of quantum manipulation brought about an era of unbounded creativity and innovation. Amidst the swirling vortices of a quantum fluid experiment, Professor Paradox, a time theorist navigating the intricacies of quantum causality, conducted a successful experiment in quantum teleportation of matter. An ancient prophecy foretold of a quantum savior who would reshape the cosmos. The quantum truths they brought to light would challenge the very core of reality and being. Within the crystalline structure of a quantum lattice system, Professor Samuel Quark, an eccentric inventor known for pushing the boundaries of quantum mechanics, opened a gateway to a realm governed by quantum chaos. They discovered they were living in a simulated quantum universe. The quantum enlightenment they attained would permeate the collective consciousness of their species.\n\n## Contributing\n\nReady to add your own twist to the tales? Check out our [contributing guidelines](\n\nCONTRIBUTING.md).\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n**Repository Views** \n\nDive into the world of Sadaa and let your imagination run wild! \ud83d\ude80\ud83d\udcda",
"bugtrack_url": null,
"license": "",
"summary": "A package for generating random stories.",
"version": "0.3.0",
"project_urls": {
"Homepage": "https://github.com/ishanoshada/sadaa",
"Source": "https://github.com/ishanoshada/sadaa"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0c38650872d0478a3b21abdb78f7a59a05f5dfea68eeae3cde9e6eec4a183050",
"md5": "0d750600e5e40f3eea77837e02057734",
"sha256": "fdcffc52e120c777852357f743cb56a5b7ad2e20a5e1f7ea75b8ca560edd8e6a"
},
"downloads": -1,
"filename": "sadaa-0.3.0.tar.gz",
"has_sig": false,
"md5_digest": "0d750600e5e40f3eea77837e02057734",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 44978,
"upload_time": "2023-11-06T22:47:24",
"upload_time_iso_8601": "2023-11-06T22:47:24.348294Z",
"url": "https://files.pythonhosted.org/packages/0c/38/650872d0478a3b21abdb78f7a59a05f5dfea68eeae3cde9e6eec4a183050/sadaa-0.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-06 22:47:24",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ishanoshada",
"github_project": "sadaa",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "sadaa"
}
JSON
