flickpy

Name	flickpy JSON
Version	3.0.0 JSON
	download
home_page	https://github.com/bytebreach/flickpy
Summary	A Python package for displaying various loading animations in the terminal.
upload_time	2024-11-08 07:41:20
maintainer	None
docs_url	None
author	MrFidal
requires_python	None
license	None
keywords
VCS
bugtrack_url
requirements	No requirements were recorded.
Travis-CI	No Travis.
coveralls test coverage	No coveralls.

            # Flickpy 3.0.0

Flickpy is a Python package that provides various terminal loading animations. You can use it both from the command line and as a library within your Python code. It supports multiple types of animations, duration-based control, and time format parsing (seconds, minutes, and hours).

## Installation

To install the `Flickpy` package, you can use `pip`:

```bash
pip install flickpy
```

## Command-Line Usage

### List Available Animations

To list all the available animations in the package, use the following command:

```bash
flickpy list
```

This will display all the loading animations you can use with the `flickpy run` command.

### Run a Specific Animation

You can run any of the available animations by specifying its name. You also need to provide the duration for how long the animation should run. The duration can be in seconds (`10s`), minutes (`5m`), or hours (`1h`).

```bash
flickpy run "<animation_name>" --duration <duration>
```

For example:

- Run the "Progress Bar Fill" animation for 10 seconds:

```bash
flickpy run "Progress Bar Fill" --duration 10s
```

- Run the "Rotating Bar" animation for 5 minutes:

```bash
flickpy run "Rotating Bar" --duration 5m
```

- Run the "Pulse Blocks" animation for 1 hour:

```bash
flickpy run "Pulse Blocks" --duration 1h
```

If you do not specify a duration, it will default to `10s` (10 seconds).

### Animation Options

The `flickpy run` command supports a variety of animations. Here are the available ones:

- **Progress Bar Fill**
- **Rotating Bar**
- **Expanding Blocks**
- **Bouncing Bar**
- **Sliding Dots**
- **Pulse Blocks**
- **Loading Wave**
- **Blinking Blocks**

You can list these animations with the `flickpy list` command.

## Import Usage

You can also use `Flickpy` within your Python code. Here’s an example:

### Example: List Animations and Run an Animation

```python
from Flickpy import run_animation, list_animations

# Print all available animations
print("Available Animations:")
for anim in list_animations():
    print(anim)

# Run a specific animation for a set duration
run_animation("Progress Bar Fill", "10s")
```

### Example Output

When you run the above Python code, it will:

1. Print a list of available animations.
2. Run the "Progress Bar Fill" animation for 10 seconds.

## Time-Based Control

### Time Format Support

The `--duration` argument accepts the following time formats:

- **Seconds**: Use `s` (e.g., `10s` for 10 seconds)
- **Minutes**: Use `m` (e.g., `5m` for 5 minutes)
- **Hours**: Use `h` (e.g., `1h` for 1 hour)

### Examples:

- **10 seconds**: `10s`
- **5 minutes**: `5m`
- **1 hour**: `1h`

## Example of Using in CLI

```bash
# List all available animations
flickpy list

# Run "Progress Bar Fill" animation for 10 seconds
flickpy run "Progress Bar Fill" --duration 10s

# Run "Rotating Bar" animation for 2 minutes
flickpy run "Rotating Bar" --duration 2m

# Run "Pulse Blocks" animation for 1 hour
flickpy run "Pulse Blocks" --duration 1h
```

## Animations in Flickpy

Here’s a list of animations that you can use with `Flickpy`:

- **Progress Bar Fill**
- **Rotating Bar**
- **Expanding Blocks**
- **Bouncing Bar**
- **Sliding Dots**
- **Pulse Blocks**
- **Loading Wave**
- **Blinking Blocks**

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/bytebreach/flickpy",
    "name": "flickpy",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": null,
    "author": "MrFidal",
    "author_email": "mrfidal@proton.me",
    "download_url": "https://files.pythonhosted.org/packages/39/63/ae4808395f0ab9e1c29ff7282cda8e97007aa5765fa8c9a1d70c67ce3cbb/flickpy-3.0.0.tar.gz",
    "platform": null,
    "description": "# Flickpy 3.0.0\r\n\r\nFlickpy is a Python package that provides various terminal loading animations. You can use it both from the command line and as a library within your Python code. It supports multiple types of animations, duration-based control, and time format parsing (seconds, minutes, and hours).\r\n\r\n## Installation\r\n\r\nTo install the `Flickpy` package, you can use `pip`:\r\n\r\n```bash\r\npip install flickpy\r\n```\r\n\r\n## Command-Line Usage\r\n\r\n### List Available Animations\r\n\r\nTo list all the available animations in the package, use the following command:\r\n\r\n```bash\r\nflickpy list\r\n```\r\n\r\nThis will display all the loading animations you can use with the `flickpy run` command.\r\n\r\n### Run a Specific Animation\r\n\r\nYou can run any of the available animations by specifying its name. You also need to provide the duration for how long the animation should run. The duration can be in seconds (`10s`), minutes (`5m`), or hours (`1h`).\r\n\r\n```bash\r\nflickpy run \"<animation_name>\" --duration <duration>\r\n```\r\n\r\nFor example:\r\n\r\n- Run the \"Progress Bar Fill\" animation for 10 seconds:\r\n\r\n```bash\r\nflickpy run \"Progress Bar Fill\" --duration 10s\r\n```\r\n\r\n- Run the \"Rotating Bar\" animation for 5 minutes:\r\n\r\n```bash\r\nflickpy run \"Rotating Bar\" --duration 5m\r\n```\r\n\r\n- Run the \"Pulse Blocks\" animation for 1 hour:\r\n\r\n```bash\r\nflickpy run \"Pulse Blocks\" --duration 1h\r\n```\r\n\r\nIf you do not specify a duration, it will default to `10s` (10 seconds).\r\n\r\n### Animation Options\r\n\r\nThe `flickpy run` command supports a variety of animations. Here are the available ones:\r\n\r\n- **Progress Bar Fill**\r\n- **Rotating Bar**\r\n- **Expanding Blocks**\r\n- **Bouncing Bar**\r\n- **Sliding Dots**\r\n- **Pulse Blocks**\r\n- **Loading Wave**\r\n- **Blinking Blocks**\r\n\r\nYou can list these animations with the `flickpy list` command.\r\n\r\n## Import Usage\r\n\r\nYou can also use `Flickpy` within your Python code. Here\u00e2\u20ac\u2122s an example:\r\n\r\n### Example: List Animations and Run an Animation\r\n\r\n```python\r\nfrom Flickpy import run_animation, list_animations\r\n\r\n# Print all available animations\r\nprint(\"Available Animations:\")\r\nfor anim in list_animations():\r\n    print(anim)\r\n\r\n# Run a specific animation for a set duration\r\nrun_animation(\"Progress Bar Fill\", \"10s\")\r\n```\r\n\r\n### Example Output\r\n\r\nWhen you run the above Python code, it will:\r\n\r\n1. Print a list of available animations.\r\n2. Run the \"Progress Bar Fill\" animation for 10 seconds.\r\n\r\n## Time-Based Control\r\n\r\n### Time Format Support\r\n\r\nThe `--duration` argument accepts the following time formats:\r\n\r\n- **Seconds**: Use `s` (e.g., `10s` for 10 seconds)\r\n- **Minutes**: Use `m` (e.g., `5m` for 5 minutes)\r\n- **Hours**: Use `h` (e.g., `1h` for 1 hour)\r\n\r\n### Examples:\r\n\r\n- **10 seconds**: `10s`\r\n- **5 minutes**: `5m`\r\n- **1 hour**: `1h`\r\n\r\n## Example of Using in CLI\r\n\r\n```bash\r\n# List all available animations\r\nflickpy list\r\n\r\n# Run \"Progress Bar Fill\" animation for 10 seconds\r\nflickpy run \"Progress Bar Fill\" --duration 10s\r\n\r\n# Run \"Rotating Bar\" animation for 2 minutes\r\nflickpy run \"Rotating Bar\" --duration 2m\r\n\r\n# Run \"Pulse Blocks\" animation for 1 hour\r\nflickpy run \"Pulse Blocks\" --duration 1h\r\n```\r\n\r\n## Animations in Flickpy\r\n\r\nHere\u00e2\u20ac\u2122s a list of animations that you can use with `Flickpy`:\r\n\r\n- **Progress Bar Fill**\r\n- **Rotating Bar**\r\n- **Expanding Blocks**\r\n- **Bouncing Bar**\r\n- **Sliding Dots**\r\n- **Pulse Blocks**\r\n- **Loading Wave**\r\n- **Blinking Blocks**\r\n\r\n## License\r\n\r\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\r\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "A Python package for displaying various loading animations in the terminal.",
    "version": "3.0.0",
    "project_urls": {
        "Homepage": "https://github.com/bytebreach/flickpy"
    },
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "983159a3e694670f88b3bbf43dea5e9b0ef770b521ebdf347774cc3f89aa2690",
                "md5": "80e62eda114dc4793e973c3397e9daa1",
                "sha256": "d994e41202340c0c27c3ef603f4eef3d98e01a93f44e60d2adaf24630fe401fe"
            },
            "downloads": -1,
            "filename": "flickpy-3.0.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "80e62eda114dc4793e973c3397e9daa1",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 4468,
            "upload_time": "2024-11-08T07:41:19",
            "upload_time_iso_8601": "2024-11-08T07:41:19.058085Z",
            "url": "https://files.pythonhosted.org/packages/98/31/59a3e694670f88b3bbf43dea5e9b0ef770b521ebdf347774cc3f89aa2690/flickpy-3.0.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "3963ae4808395f0ab9e1c29ff7282cda8e97007aa5765fa8c9a1d70c67ce3cbb",
                "md5": "85bbacb4d2e2f92c1b5b9e6f5cb69e47",
                "sha256": "06eda98a6029145f39d1b948ca0cfc00f8168cfacf3b92e307e9e20663cc12a3"
            },
            "downloads": -1,
            "filename": "flickpy-3.0.0.tar.gz",
            "has_sig": false,
            "md5_digest": "85bbacb4d2e2f92c1b5b9e6f5cb69e47",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 4113,
            "upload_time": "2024-11-08T07:41:20",
            "upload_time_iso_8601": "2024-11-08T07:41:20.954911Z",
            "url": "https://files.pythonhosted.org/packages/39/63/ae4808395f0ab9e1c29ff7282cda8e97007aa5765fa8c9a1d70c67ce3cbb/flickpy-3.0.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-08 07:41:20",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "bytebreach",
    "github_project": "flickpy",
    "github_not_found": true,
    "lcname": "flickpy"
}