hyperskill-python-portfolio


Namehyperskill-python-portfolio JSON
Version 0.6.6 PyPI version JSON
download
home_pageNone
SummaryMy journey through Hyperskill, captured in a portfolio of Python projects.
upload_time2025-08-11 17:41:09
maintainerNone
docs_urlNone
authorNone
requires_python>=3.12
licenseNone
keywords education hyperskill
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Hyperskill Python Portfolio

A collection of classic command-line applications and games, developed as a portfolio of
Python projects from the Hyperskill platform. Each application is a self-contained,
runnable program built with modern Python 3.12+.

This package allows you to instantly install and run a variety of small, fun programs
directly from your terminal.

## Quick Start: Installation & Usage

Install the package using `pip` (or any modern installer like `uv` or `pipx`):

```
pip install hyperskill-python-portfolio
```

Once installed, you can immediately run any of the included applications.

### Try a Game: Hangman

```
hangman
```

### Try a Simulator: Coffee Machine

```
coffeemachine
```

### Try a Utility: Loan Calculator

The loan calculator can compute annuity payments, principals, and more.

```
# Calculate the monthly payment for a loan
loancalc annuity --principal 500000 --interest 5.5 --periods 360

# Calculate the total principal for a given payment
loancalc annuity --payment 2800 --interest 5.5 --periods 360
```

## Available Applications

This portfolio includes the following command-line applications:

| **Command**     | **Description**                                              |
|-----------------|--------------------------------------------------------------|
| `billsplitter`  | A simple utility to split a bill among friends.              |
| `chatbot`       | A basic, friendly chatbot with scripted dialogue.            |
| `coffeemachine` | An interactive, stateful coffee machine simulator.           |
| `hangman`       | The classic word-guessing game.                              |
| `honestcalc`    | An interactive calculator with memory and 'honest' feedback. |
| `loancalc`      | A powerful command-line loan calculator.                     |
| `rps`           | Rock-Paper-Scissors with score tracking.                     |
| `zookeeper`     | A fun script that displays ASCII art of animals.             |

Each application is a standalone project, refactored for quality and built with modern
tooling.

## About This Project

This project serves two purposes:

1. **For Users:** To provide a simple, installable package of classic command-line tools
   and games.

2. **For Developers:** To serve as a practical portfolio demonstrating modern Python
   development practices.

The source code is heavily documented, tested with `pytest`, type-checked with `mypy`,
and formatted with `ruff`. It is intended to be a clear and readable example of a
well-structured Python application suite.

## For Contributors

This project is managed with a modern Python toolchain. If you are interested in the
development process or wish to contribute, please visit the
project's [GitHub repository](https://github.com/rabestro/hyperskill-python-portfolio "null").

The repository contains detailed information on the development setup, tooling (`uv`,
`ruff`, `mypy`), and how to run the quality checks.

## License

This project is licensed under the MIT License.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "hyperskill-python-portfolio",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.12",
    "maintainer_email": null,
    "keywords": "education, hyperskill",
    "author": null,
    "author_email": "Jegors \u010cemisovs <jegors.cemisovs@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/ca/c3/361632d0a11665fe50462fbaa5a22ce218e80c822cb9a85ee1343e24e5f3/hyperskill_python_portfolio-0.6.6.tar.gz",
    "platform": null,
    "description": "# Hyperskill Python Portfolio\n\nA collection of classic command-line applications and games, developed as a portfolio of\nPython projects from the Hyperskill platform. Each application is a self-contained,\nrunnable program built with modern Python 3.12+.\n\nThis package allows you to instantly install and run a variety of small, fun programs\ndirectly from your terminal.\n\n## Quick Start: Installation & Usage\n\nInstall the package using `pip` (or any modern installer like `uv` or `pipx`):\n\n```\npip install hyperskill-python-portfolio\n```\n\nOnce installed, you can immediately run any of the included applications.\n\n### Try a Game: Hangman\n\n```\nhangman\n```\n\n### Try a Simulator: Coffee Machine\n\n```\ncoffeemachine\n```\n\n### Try a Utility: Loan Calculator\n\nThe loan calculator can compute annuity payments, principals, and more.\n\n```\n# Calculate the monthly payment for a loan\nloancalc annuity --principal 500000 --interest 5.5 --periods 360\n\n# Calculate the total principal for a given payment\nloancalc annuity --payment 2800 --interest 5.5 --periods 360\n```\n\n## Available Applications\n\nThis portfolio includes the following command-line applications:\n\n| **Command**     | **Description**                                              |\n|-----------------|--------------------------------------------------------------|\n| `billsplitter`  | A simple utility to split a bill among friends.              |\n| `chatbot`       | A basic, friendly chatbot with scripted dialogue.            |\n| `coffeemachine` | An interactive, stateful coffee machine simulator.           |\n| `hangman`       | The classic word-guessing game.                              |\n| `honestcalc`    | An interactive calculator with memory and 'honest' feedback. |\n| `loancalc`      | A powerful command-line loan calculator.                     |\n| `rps`           | Rock-Paper-Scissors with score tracking.                     |\n| `zookeeper`     | A fun script that displays ASCII art of animals.             |\n\nEach application is a standalone project, refactored for quality and built with modern\ntooling.\n\n## About This Project\n\nThis project serves two purposes:\n\n1. **For Users:** To provide a simple, installable package of classic command-line tools\n   and games.\n\n2. **For Developers:** To serve as a practical portfolio demonstrating modern Python\n   development practices.\n\nThe source code is heavily documented, tested with `pytest`, type-checked with `mypy`,\nand formatted with `ruff`. It is intended to be a clear and readable example of a\nwell-structured Python application suite.\n\n## For Contributors\n\nThis project is managed with a modern Python toolchain. If you are interested in the\ndevelopment process or wish to contribute, please visit the\nproject's [GitHub repository](https://github.com/rabestro/hyperskill-python-portfolio \"null\").\n\nThe repository contains detailed information on the development setup, tooling (`uv`,\n`ruff`, `mypy`), and how to run the quality checks.\n\n## License\n\nThis project is licensed under the MIT License.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "My journey through Hyperskill, captured in a portfolio of Python projects.",
    "version": "0.6.6",
    "project_urls": {
        "Documentation": "https://rabestro.github.io/hyperskill-python-portfolio/",
        "Homepage": "https://github.com/rabestro/hyperskill-python-portfolio",
        "Issues": "https://github.com/rabestro/hyperskill-python-portfolio/issues",
        "Repository": "https://github.com/rabestro/hyperskill-python-portfolio.git"
    },
    "split_keywords": [
        "education",
        " hyperskill"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "09aaba897cf043cb7eac673f4815a8645a94dc803aed30a8ec182c5a34819058",
                "md5": "9ee3fe44334e3958b3b4ad6354e7a5f5",
                "sha256": "5379e40949e8df6ca81858239ae2353eec9ad35e13b16da8ad20d48a607c08f6"
            },
            "downloads": -1,
            "filename": "hyperskill_python_portfolio-0.6.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "9ee3fe44334e3958b3b4ad6354e7a5f5",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.12",
            "size": 33390,
            "upload_time": "2025-08-11T17:41:09",
            "upload_time_iso_8601": "2025-08-11T17:41:09.122785Z",
            "url": "https://files.pythonhosted.org/packages/09/aa/ba897cf043cb7eac673f4815a8645a94dc803aed30a8ec182c5a34819058/hyperskill_python_portfolio-0.6.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "cac3361632d0a11665fe50462fbaa5a22ce218e80c822cb9a85ee1343e24e5f3",
                "md5": "524670f12cfb4d4b6ea7326cd4db8df1",
                "sha256": "5c6dd685456f27f4d57cbefca02a67f4584f627bce02e48c5b4f189c57086446"
            },
            "downloads": -1,
            "filename": "hyperskill_python_portfolio-0.6.6.tar.gz",
            "has_sig": false,
            "md5_digest": "524670f12cfb4d4b6ea7326cd4db8df1",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.12",
            "size": 68101,
            "upload_time": "2025-08-11T17:41:09",
            "upload_time_iso_8601": "2025-08-11T17:41:09.940494Z",
            "url": "https://files.pythonhosted.org/packages/ca/c3/361632d0a11665fe50462fbaa5a22ce218e80c822cb9a85ee1343e24e5f3/hyperskill_python_portfolio-0.6.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-11 17:41:09",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "rabestro",
    "github_project": "hyperskill-python-portfolio",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "hyperskill-python-portfolio"
}
        
Elapsed time: 0.68046s