# Fortune Luck Predictor
A Python package that returns lucky numbers, fortunes, and horoscope-like results.
## Team
- Pranathi Chinthalapani — prc9852@nyu.edu ([GitHub](https://github.com/PranathiChin))
- Sam Rawdon — sr6360@nyu.edu ([GitHub](https://github.com/SamRawdon))
- May Zhou — zz4206@nyu.edu ([GitHub](https://github.com/zz4206))
- Hanjun Deng — hd2432@nyu.edu ([GitHub](https://github.com/Deng-Hanjun))
- William Chan — wc2184@nyu.edu ([GitHub](https://github.com/wc2184))
## What is it?
Fortune Luck Predictor provides:
- Fortunes: Random fortune cookie-style messages
- Future Predictions: Predicts career, marriage age, number of kids, and success level
- Day Predictions: Get day-specific fortunes for any day of the week
- Compatibility Scores: Calculate compatibility between two names
- Lucky Numbers: Generate weighted lucky numbers based on the current date and time
## Installation
From PyPI:
```bash
pip install fortuneluckpredictor
```
From source:
```bash
git clone https://github.com/swe-students-fall2025/3-python-package-team_boreal.git
cd 3-python-package-team_boreal
pip install -e .
```
## How to Run
### Interactive Mode
Run the package as a module:
```bash
python -m fortuneluckpredictor
```
Or if you need to set PYTHONPATH:
```bash
PYTHONPATH=src python -m fortuneluckpredictor
```
This launches an interactive menu with all available functions.
### Using as a Package
Import and use the functions in your Python code:
```python
from fortuneluckpredictor.fortune import get_fortune
from fortuneluckpredictor.futurePredictions import futurePrediction
from fortuneluckpredictor.predictDay import predict_day
from fortuneluckpredictor.compatibility_score import compatibility_score
from fortuneluckpredictor.luckyNumber import get_lucky_number
# Get a fortune
print(get_fortune())
# Predict your future
print(futurePrediction("Alice"))
# Predict a day
print(predict_day("Monday"))
# Check compatibility
print(compatibility_score("Alice", "Bob"))
# Get a lucky number
print(get_lucky_number((1, 100)))
```
## Development
Set up the development environment:
```bash
pipenv install --dev
pipenv shell
pip install -e .
```
Run tests:
```bash
pytest tests/
```
## Links
- GitHub: https://github.com/swe-students-fall2025/3-python-package-team_boreal
- PyPI: https://pypi.org/project/fortuneluckpredictor/
Raw data
{
"_id": null,
"home_page": null,
"name": "fortuneluckpredictor",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "python, package, build, cookie, fun, guess, luck, fortune",
"author": null,
"author_email": "\"Pranathi Chinthalapani, Sam Rawdon, May Zhou, Hanjun Deng, William Chan\" <prc9852@nyu.edu>, Pranathi Chinthalapani <prc9852@nyu.edu>, Sam Rawdon <sr6360@nyu.edu>, May Zhou <zz4206@nyu.edu>, Hanjun Deng <hd2432@nyu.edu>, William Chan <wc2184@nyu.edu>",
"download_url": "https://files.pythonhosted.org/packages/2c/3e/c5ffc1fca90cf5abdc8b01722c6938b334d26d00344c5cb35519fe497c70/fortuneluckpredictor-1.0.2.tar.gz",
"platform": null,
"description": "\n\n# Fortune Luck Predictor\n\nA Python package that returns lucky numbers, fortunes, and horoscope-like results.\n## Team\n\n- Pranathi Chinthalapani \u2014 prc9852@nyu.edu ([GitHub](https://github.com/PranathiChin))\n- Sam Rawdon \u2014 sr6360@nyu.edu ([GitHub](https://github.com/SamRawdon))\n- May Zhou \u2014 zz4206@nyu.edu ([GitHub](https://github.com/zz4206))\n- Hanjun Deng \u2014 hd2432@nyu.edu ([GitHub](https://github.com/Deng-Hanjun))\n- William Chan \u2014 wc2184@nyu.edu ([GitHub](https://github.com/wc2184))\n\n## What is it?\n\n\nFortune Luck Predictor provides:\n- Fortunes: Random fortune cookie-style messages\n- Future Predictions: Predicts career, marriage age, number of kids, and success level\n- Day Predictions: Get day-specific fortunes for any day of the week\n- Compatibility Scores: Calculate compatibility between two names\n- Lucky Numbers: Generate weighted lucky numbers based on the current date and time\n\n## Installation\n\nFrom PyPI:\n```bash\npip install fortuneluckpredictor\n```\n\nFrom source:\n```bash\ngit clone https://github.com/swe-students-fall2025/3-python-package-team_boreal.git\ncd 3-python-package-team_boreal\npip install -e .\n```\n\n## How to Run\n\n### Interactive Mode\n\nRun the package as a module:\n```bash\npython -m fortuneluckpredictor\n```\n\nOr if you need to set PYTHONPATH:\n```bash\nPYTHONPATH=src python -m fortuneluckpredictor\n```\n\nThis launches an interactive menu with all available functions.\n\n### Using as a Package\n\nImport and use the functions in your Python code:\n\n```python\nfrom fortuneluckpredictor.fortune import get_fortune\nfrom fortuneluckpredictor.futurePredictions import futurePrediction\nfrom fortuneluckpredictor.predictDay import predict_day\nfrom fortuneluckpredictor.compatibility_score import compatibility_score\nfrom fortuneluckpredictor.luckyNumber import get_lucky_number\n\n# Get a fortune\nprint(get_fortune())\n\n# Predict your future\nprint(futurePrediction(\"Alice\"))\n\n# Predict a day\nprint(predict_day(\"Monday\"))\n\n# Check compatibility\nprint(compatibility_score(\"Alice\", \"Bob\"))\n\n# Get a lucky number\nprint(get_lucky_number((1, 100)))\n```\n\n## Development\n\nSet up the development environment:\n```bash\npipenv install --dev\npipenv shell\npip install -e .\n```\n\nRun tests:\n```bash\npytest tests/\n```\n\n## Links\n\n- GitHub: https://github.com/swe-students-fall2025/3-python-package-team_boreal\n- PyPI: https://pypi.org/project/fortuneluckpredictor/\n",
"bugtrack_url": null,
"license": null,
"summary": "Fortune & luck predictor. Returns lucky numbers, fortunes, and horoscope-like results.",
"version": "1.0.2",
"project_urls": {
"Homepage": "https://github.com/swe-students-fall2025/3-python-package-team_boreal",
"Issues": "https://github.com/swe-students-fall2025/3-python-package-team_boreal/issues",
"Repository": "https://github.com/swe-students-fall2025/3-python-package-team_boreal.git"
},
"split_keywords": [
"python",
" package",
" build",
" cookie",
" fun",
" guess",
" luck",
" fortune"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "74cba9f78598e0d666428a78b2ccc35528279f09e81e7b487aecc2f78ce0c207",
"md5": "945eaec8e97ded6c24e47ddf4799ec67",
"sha256": "51f8d596f5ec06361f4cf18a78df773e3a691b4a42fa3ef38c0361d2664339d1"
},
"downloads": -1,
"filename": "fortuneluckpredictor-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "945eaec8e97ded6c24e47ddf4799ec67",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 20129,
"upload_time": "2025-11-05T04:40:10",
"upload_time_iso_8601": "2025-11-05T04:40:10.159141Z",
"url": "https://files.pythonhosted.org/packages/74/cb/a9f78598e0d666428a78b2ccc35528279f09e81e7b487aecc2f78ce0c207/fortuneluckpredictor-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2c3ec5ffc1fca90cf5abdc8b01722c6938b334d26d00344c5cb35519fe497c70",
"md5": "323861419c04ba7be972b9aeb7655f0e",
"sha256": "5d475c8bd3325bcc949476ca390553806c00ee5d7e736d3e0ba3aa9c01ff75b4"
},
"downloads": -1,
"filename": "fortuneluckpredictor-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "323861419c04ba7be972b9aeb7655f0e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 24703,
"upload_time": "2025-11-05T04:40:11",
"upload_time_iso_8601": "2025-11-05T04:40:11.225235Z",
"url": "https://files.pythonhosted.org/packages/2c/3e/c5ffc1fca90cf5abdc8b01722c6938b334d26d00344c5cb35519fe497c70/fortuneluckpredictor-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-05 04:40:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "swe-students-fall2025",
"github_project": "3-python-package-team_boreal",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "fortuneluckpredictor"
}
JSON
