delayviewer


Namedelayviewer JSON
Version 0.1.1 PyPI version JSON
download
home_pageNone
SummarySeveral mechanisms to time and view progress of execution/runtime delays in Python
upload_time2024-10-07 01:32:51
maintainerNone
docs_urlNone
authorNone
requires_python>=3.9
licenseNone
keywords util utility
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # DelayViewer

**DelayViewer** is a Python assistant for showing progress info visually within the shell running a python command with long exposure. This library provides a simple spinner graphic and a stopwatch. The predominant use case is to display progress for sections within a decorated function.

## Installation

Use the package manager [pip](https://pip.pypa.io/en/stable/) to install **delayviewer**.

```bash
pip install delayviewer
```


## Spinner Usage
```python
from delayviewer.spinner import handle_spinner
import time

@handle_spinner
def test_spinner(spinner=None):
    spinner.start('delaying 5 sec')
    time.sleep(5)
    spinner.stop()

test_spinner()
```

## Stopwatch Usage
```python
from delayviewer.stopwatch import handle_stopwatch
import time

@handle_stopwatch
def test_stopwatch(stopwatch=None):
    stopwatch.start('clocking 5 sec')
    time.sleep(5)
    stopwatch.stop('Finished timing!')

test_stopwatch()
```


## CLI Utility

The following CLI is included with this package for testing the various progress and timing indicators.

```bash
# dlyview -h
usage: dlyview [-h] {spinner,stopwatch,time.show,sleep.ticks} ...

-.-.-. Delay viewer elements for python scripts

positional arguments:
  {spinner,stopwatch,time.show,sleep.ticks}
    spinner             test Spinner graphic for viewing thru execution delays
    stopwatch           test StopWatch for viewing thru execution delays
    time.show           test time show wrapper
    sleep.ticks         test sleeping ticks progress viewer

options:
  -h, --help            show this help message and exit

.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.
```


## License

[MIT](https://choosealicense.com/licenses/mit/)


## Acknowledgements

Thanks to several posts on StackOverflow regarding basic Spinner class implementation. Took that concept and generated the Stopwatch class to mimic behavior.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "delayviewer",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.9",
    "maintainer_email": "Ed Waldner <waldevburry@proton.me>",
    "keywords": "util, utility",
    "author": null,
    "author_email": "Ed Waldner <waldevburry@proton.me>",
    "download_url": "https://files.pythonhosted.org/packages/d5/0f/f9d445720c3b5479832930c8ee5875079cd5f83da3193aa619b430c08913/delayviewer-0.1.1.tar.gz",
    "platform": null,
    "description": "# DelayViewer\n\n**DelayViewer** is a Python assistant for showing progress info visually within the shell running a python command with long exposure. This library provides a simple spinner graphic and a stopwatch. The predominant use case is to display progress for sections within a decorated function.\n\n## Installation\n\nUse the package manager [pip](https://pip.pypa.io/en/stable/) to install **delayviewer**.\n\n```bash\npip install delayviewer\n```\n\n\n## Spinner Usage\n```python\nfrom delayviewer.spinner import handle_spinner\nimport time\n\n@handle_spinner\ndef test_spinner(spinner=None):\n    spinner.start('delaying 5 sec')\n    time.sleep(5)\n    spinner.stop()\n\ntest_spinner()\n```\n\n## Stopwatch Usage\n```python\nfrom delayviewer.stopwatch import handle_stopwatch\nimport time\n\n@handle_stopwatch\ndef test_stopwatch(stopwatch=None):\n    stopwatch.start('clocking 5 sec')\n    time.sleep(5)\n    stopwatch.stop('Finished timing!')\n\ntest_stopwatch()\n```\n\n\n## CLI Utility\n\nThe following CLI is included with this package for testing the various progress and timing indicators.\n\n```bash\n# dlyview -h\nusage: dlyview [-h] {spinner,stopwatch,time.show,sleep.ticks} ...\n\n-.-.-. Delay viewer elements for python scripts\n\npositional arguments:\n  {spinner,stopwatch,time.show,sleep.ticks}\n    spinner             test Spinner graphic for viewing thru execution delays\n    stopwatch           test StopWatch for viewing thru execution delays\n    time.show           test time show wrapper\n    sleep.ticks         test sleeping ticks progress viewer\n\noptions:\n  -h, --help            show this help message and exit\n\n.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.-.\n```\n\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n\n## Acknowledgements\n\nThanks to several posts on StackOverflow regarding basic Spinner class implementation. Took that concept and generated the Stopwatch class to mimic behavior.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Several mechanisms to time and view progress of execution/runtime delays in Python",
    "version": "0.1.1",
    "project_urls": {
        "Documentation": "https://github.com/ew98/delayviewer/wiki/DelayViewer",
        "Homepage": "https://github.com/ew98/delayviewer",
        "Issues": "https://github.com/ew98/delayviewer/issues"
    },
    "split_keywords": [
        "util",
        " utility"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "2a7dc2a1e35e2ce85ada7470dfe35e0ff4489c2f79e57fe52c4d892474f1140e",
                "md5": "93757bafab670fbbf2f68bf5b95d74da",
                "sha256": "b49d3612a2f794dafc7d41a0c5ee20710759f0d331a39f14cf18f44bddeb3dd6"
            },
            "downloads": -1,
            "filename": "delayviewer-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "93757bafab670fbbf2f68bf5b95d74da",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9",
            "size": 7725,
            "upload_time": "2024-10-07T01:32:50",
            "upload_time_iso_8601": "2024-10-07T01:32:50.863693Z",
            "url": "https://files.pythonhosted.org/packages/2a/7d/c2a1e35e2ce85ada7470dfe35e0ff4489c2f79e57fe52c4d892474f1140e/delayviewer-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "d50ff9d445720c3b5479832930c8ee5875079cd5f83da3193aa619b430c08913",
                "md5": "6d7de50e5cb72832e734d9febd10ab1b",
                "sha256": "686327cca97077d79d8db2e678995d854e3c1e8d9ae23eeab2de9d36e9d01634"
            },
            "downloads": -1,
            "filename": "delayviewer-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "6d7de50e5cb72832e734d9febd10ab1b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9",
            "size": 6897,
            "upload_time": "2024-10-07T01:32:51",
            "upload_time_iso_8601": "2024-10-07T01:32:51.840950Z",
            "url": "https://files.pythonhosted.org/packages/d5/0f/f9d445720c3b5479832930c8ee5875079cd5f83da3193aa619b430c08913/delayviewer-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-10-07 01:32:51",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ew98",
    "github_project": "delayviewer",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "delayviewer"
}
        
Elapsed time: 0.71225s