{"id":2435,"library":"click-spinner","title":"Click Spinner","description":"Click Spinner is a Python library that provides a simple context manager to display a spinning cursor in Click command-line interface (CLI) applications during long-running tasks where a precise progress bar isn't feasible. It aims to improve user experience by indicating activity. The library is currently at version 0.1.10 and is maintained as part of the `click-contrib` organization on GitHub.","status":"active","version":"0.1.10","language":"en","source_language":"en","source_url":"https://github.com/click-contrib/click-spinner","tags":["click","spinner","cli","progress","ux"],"install":[{"cmd":"pip install click-spinner","lang":"bash","label":"Install stable version"}],"dependencies":[{"reason":"This library is designed to integrate with Click CLI applications and implicitly expects Click to be installed.","package":"click","optional":false}],"imports":[{"symbol":"spinner","correct":"from click_spinner import spinner"}],"quickstart":{"code":"import time\nfrom click_spinner import spinner\n\ndef long_running_task():\n    \"\"\"Simulates a task that takes some time.\"\"\"\n    time.sleep(3) # Simulate 3 seconds of work\n\nprint(\"Starting a long task...\")\nwith spinner():\n    long_running_task()\nprint(\"Task completed!\")","lang":"python","description":"Wrap your long-running code block within the `spinner()` context manager to automatically display and hide a spinning cursor."},"warnings":[{"fix":"There is no built-in mechanism to suppress the spinner when output is redirected. For machine-readable output, consider conditionally disabling the spinner or ensuring such commands do not use it.","message":"Spinner characters are included in redirected stdout. When piping or redirecting the output of a command that uses `click-spinner` (e.g., `mycommand > output.txt`), the spinner characters will be written to the output file. This can interfere with machine-readable parsing or clean logs.","severity":"gotcha","affected_versions":"0.1.1 to 0.1.10"},{"fix":"No action required, but be aware that upgrading from 0.1.9 to 0.1.10 will not introduce any changes.","message":"Identical versions 0.1.9 and 0.1.10 on PyPI. Due to PyPI issues, versions `0.1.9` and `0.1.10` of `click-spinner` are functionally identical. Users should not expect any differences or new features between these two specific releases.","severity":"gotcha","affected_versions":"0.1.9, 0.1.10"}],"env_vars":null,"last_verified":"2026-04-10T00:00:00.000Z","next_check":"2026-07-09T00:00:00.000Z"}