countdown-cli 2.0.0__tar.gz → 2.2.0__tar.gz

{countdown_cli-2.0.0 → countdown_cli-2.2.0}/.claude/settings.local.json

@@ -16,7 +16,8 @@
       "Bash(uv build:*)",
       "Bash(unzip:*)",
       "Bash(python3:*)",
-      "Bash(timeout 2 uv run pytest:*)"
+      "Bash(timeout 2 uv run pytest:*)",
+      "Bash(python -m pytest tests/test_main.py -x --timeout=10)"
     ],
     "deny": [],
     "ask": []

countdown_cli-2.2.0/.envrc

@@ -0,0 +1 @@
+export UV_PUBLISH_TOKEN=pypi-AgEIcHlwaS5vcmcCJDhmNDdkMDM1LWM4YjgtNDlmNS1hMzEyLTM2YWM2YzZjYWRmZAACFVsxLFsiY291bnRkb3duLWNsaSJdXQACLFsyLFsiZDMzNmM3YzgtZWM1Yy00MTY1LWJlZjUtZjY4YjJiYzE2M2NiIl1dAAAGIL6CAdUYjyGIP7v1Dl9nX3nhlZPtBWLxiKjLfHcMnu0Y

countdown_cli-2.2.0/.serena/.gitignore

@@ -0,0 +1,2 @@
+/cache
+/project.local.yml

countdown_cli-2.2.0/.serena/project.local.yml

@@ -0,0 +1,5 @@
+# This file allows you to locally override settings in project.yml for development purposes.
+#
+# Use the same keys as in project.yml here. Any setting you specify will override the corresponding
+# setting in project.yml, allowing you to customise the configuration for your local development environment
+# without affecting the project configuration in project.yml (which is intended to be versioned).

countdown_cli-2.2.0/.serena/project.yml

@@ -0,0 +1,152 @@
+# the name by which the project can be referenced within Serena
+project_name: "countdown-cli"
+
+
+# list of languages for which language servers are started; choose from:
+#   al                  bash                clojure             cpp                 csharp
+#   csharp_omnisharp    dart                elixir              elm                 erlang
+#   fortran             fsharp              go                  groovy              haskell
+#   java                julia               kotlin              lua                 markdown
+#   matlab              nix                 pascal              perl                php
+#   php_phpactor        powershell          python              python_jedi         r
+#   rego                ruby                ruby_solargraph     rust                scala
+#   swift               terraform           toml                typescript          typescript_vts
+#   vue                 yaml                zig
+#   (This list may be outdated. For the current list, see values of Language enum here:
+#   https://github.com/oraios/serena/blob/main/src/solidlsp/ls_config.py
+#   For some languages, there are alternative language servers, e.g. csharp_omnisharp, ruby_solargraph.)
+# Note:
+#   - For C, use cpp
+#   - For JavaScript, use typescript
+#   - For Free Pascal/Lazarus, use pascal
+# Special requirements:
+#   Some languages require additional setup/installations.
+#   See here for details: https://oraios.github.io/serena/01-about/020_programming-languages.html#language-servers
+# When using multiple languages, the first language server that supports a given file will be used for that file.
+# The first language is the default language and the respective language server will be used as a fallback.
+# Note that when using the JetBrains backend, language servers are not used and this list is correspondingly ignored.
+languages:
+- python
+
+# the encoding used by text files in the project
+# For a list of possible encodings, see https://docs.python.org/3.11/library/codecs.html#standard-encodings
+encoding: "utf-8"
+
+# line ending convention to use when writing source files.
+# Possible values: unset (use global setting), "lf", "crlf", or "native" (platform default)
+# This does not affect Serena's own files (e.g. memories and configuration files), which always use native line endings.
+line_ending:
+
+# The language backend to use for this project.
+# If not set, the global setting from serena_config.yml is used.
+# Valid values: LSP, JetBrains
+# Note: the backend is fixed at startup. If a project with a different backend
+# is activated post-init, an error will be returned.
+language_backend:
+
+# whether to use project's .gitignore files to ignore files
+ignore_all_files_in_gitignore: true
+
+# advanced configuration option allowing to configure language server-specific options.
+# Maps the language key to the options.
+# Have a look at the docstring of the constructors of the LS implementations within solidlsp (e.g., for C# or PHP) to see which options are available.
+# No documentation on options means no options are available.
+ls_specific_settings: {}
+
+# list of additional paths to ignore in this project.
+# Same syntax as gitignore, so you can use * and **.
+# Note: global ignored_paths from serena_config.yml are also applied additively.
+ignored_paths: []
+
+# whether the project is in read-only mode
+# If set to true, all editing tools will be disabled and attempts to use them will result in an error
+# Added on 2025-04-18
+read_only: false
+
+# list of tool names to exclude.
+# This extends the existing exclusions (e.g. from the global configuration)
+#
+# Below is the complete list of tools for convenience.
+# To make sure you have the latest list of tools, and to view their descriptions, 
+# execute `uv run scripts/print_tool_overview.py`.
+#
+#  * `activate_project`: Activates a project by name.
+#  * `check_onboarding_performed`: Checks whether project onboarding was already performed.
+#  * `create_text_file`: Creates/overwrites a file in the project directory.
+#  * `delete_lines`: Deletes a range of lines within a file.
+#  * `delete_memory`: Deletes a memory from Serena's project-specific memory store.
+#  * `execute_shell_command`: Executes a shell command.
+#  * `find_referencing_code_snippets`: Finds code snippets in which the symbol at the given location is referenced.
+#  * `find_referencing_symbols`: Finds symbols that reference the symbol at the given location (optionally filtered by type).
+#  * `find_symbol`: Performs a global (or local) search for symbols with/containing a given name/substring (optionally filtered by type).
+#  * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes.
+#  * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file.
+#  * `initial_instructions`: Gets the initial instructions for the current project.
+#     Should only be used in settings where the system prompt cannot be set,
+#     e.g. in clients you have no control over, like Claude Desktop.
+#  * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol.
+#  * `insert_at_line`: Inserts content at a given line in a file.
+#  * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol.
+#  * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
+#  * `list_memories`: Lists memories in Serena's project-specific memory store.
+#  * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+#  * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with the necessary context).
+#  * `read_file`: Reads a file within the project directory.
+#  * `read_memory`: Reads the memory with the given name from Serena's project-specific memory store.
+#  * `remove_project`: Removes a project from the Serena configuration.
+#  * `replace_lines`: Replaces a range of lines within a file with new content.
+#  * `replace_symbol_body`: Replaces the full definition of a symbol.
+#  * `restart_language_server`: Restarts the language server, may be necessary when edits not through Serena happen.
+#  * `search_for_pattern`: Performs a search for a pattern in the project.
+#  * `summarize_changes`: Provides instructions for summarizing the changes made to the codebase.
+#  * `switch_modes`: Activates modes by providing a list of their names
+#  * `think_about_collected_information`: Thinking tool for pondering the completeness of collected information.
+#  * `think_about_task_adherence`: Thinking tool for determining whether the agent is still on track with the current task.
+#  * `think_about_whether_you_are_done`: Thinking tool for determining whether the task is truly completed.
+#  * `write_memory`: Writes a named memory (for future reference) to Serena's project-specific memory store.
+excluded_tools: []
+
+# list of tools to include that would otherwise be disabled (particularly optional tools that are disabled by default).
+# This extends the existing inclusions (e.g. from the global configuration).
+included_optional_tools: []
+
+# fixed set of tools to use as the base tool set (if non-empty), replacing Serena's default set of tools.
+# This cannot be combined with non-empty excluded_tools or included_optional_tools.
+fixed_tools: []
+
+# list of mode names to that are always to be included in the set of active modes
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the base_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this setting overrides the global configuration.
+# Set this to [] to disable base modes for this project.
+# Set this to a list of mode names to always include the respective modes for this project.
+base_modes:
+
+# list of mode names that are to be activated by default.
+# The full set of modes to be activated is base_modes + default_modes.
+# If the setting is undefined, the default_modes from the global configuration (serena_config.yml) apply.
+# Otherwise, this overrides the setting from the global configuration (serena_config.yml).
+# This setting can, in turn, be overridden by CLI parameters (--mode).
+default_modes:
+
+# initial prompt for the project. It will always be given to the LLM upon activating the project
+# (contrary to the memories, which are loaded on demand).
+initial_prompt: ""
+
+# time budget (seconds) per tool call for the retrieval of additional symbol information
+# such as docstrings or parameter information.
+# This overrides the corresponding setting in the global configuration; see the documentation there.
+# If null or missing, use the setting from the global configuration.
+symbol_info_budget:
+
+# list of regex patterns which, when matched, mark a memory entry as read‑only.
+# Extends the list from the global configuration, merging the two lists.
+read_only_memory_patterns: []
+
+# list of regex patterns for memories to completely ignore.
+# Matching memories will not appear in list_memories or activate_project output
+# and cannot be accessed via read_memory or write_memory.
+# To access ignored memory files, use the read_file tool on the raw file path.
+# Extends the list from the global configuration, merging the two lists.
+# Example: ["_archive/.*", "_episodes/.*"]
+ignored_memory_patterns: []

countdown_cli-2.2.0/.uv-cache/.gitignore

@@ -0,0 +1 @@
+*

countdown_cli-2.2.0/.uv-cache/CACHEDIR.TAG

@@ -0,0 +1 @@
+Signature: 8a477f597d28d172789f06886806bc55

countdown_cli-2.2.0/AGENTS.md

@@ -0,0 +1,12 @@
+# Repository Guidelines
+
+## Structure
+- `src/countdown/` hosts the CLI (`__main__.py`, `timer.py`, `display.py`, `terminal.py`, `keys.py`, `glyphs.txt`); `tests/` mirrors each module.
+- Tooling lives in `justfile`, `pyproject.toml`, and `noxfile.py`; see `CONTRIBUTING.rst` if you need the long-form tour.
+
+## Workflow
+- `just check` runs format + lint + pytest; treat it as the pre-push gate.
+- `just test [-- -k expr]`, `just test-cov`, and `just test-all` cover targeted, coverage, and multi-Python runs.
+
+## Style
+- Use `just format` instead of manual tweaks; keep docstrings concise and only add type hints when they clarify intent.

countdown_cli-2.2.0/CLAUDE.md

@@ -0,0 +1 @@
+See @AGENTS.md

countdown_cli-2.2.0/CONTRIBUTING.rst

@@ -0,0 +1,75 @@
+Contributor Guide
+=================
+
+How to report a bug
+-------------------
+
+Report bugs on the `Issue Tracker`_.
+
+When filing an issue, make sure to answer these questions:
+
+- Which operating system and Python version are you using?
+- Which version of this project are you using?
+- What did you do?
+- What did you expect to see?
+- What did you see instead?
+
+The best way to get your bug fixed is to provide a test case,
+and/or steps to reproduce the issue.
+
+.. _Issue Tracker: https://github.com/treyhunner/countdown-cli/issues
+
+
+How to request a feature
+------------------------
+
+Request features on the `Issue Tracker`_.
+
+
+How to set up your development environment
+------------------------------------------
+
+You need Python, uv_, and just_ installed locally.
+Nox_ is optional but required for the multi-version test matrix.
+
+The CLI is exposed through the ``countdown`` script.
+Run it directly from the synced environment:
+
+.. code:: console
+
+   uv run countdown 6m30s
+
+.. _uv: https://docs.astral.sh/uv/
+.. _just: https://github.com/casey/just
+.. _Nox: https://nox.thea.codes/
+
+
+How to test the project
+-----------------------
+
+This project uses pytest_ and Ruff_ orchestrated through ``just`` tasks.
+Before opening a pull request, run the aggregated check:
+
+.. code:: console
+
+   just check
+
+Useful individual commands:
+
+.. code:: console
+
+   just test -- -k timer
+   just test-cov            # pytest with coverage (fail_under=100)
+
+Unit tests are located in the ``tests`` directory,
+and are written using the pytest_ testing framework.
+Open ``htmlcov/index.html`` after ``just test-cov`` to debug coverage issues.
+
+If you need to validate across every supported Python version, run:
+
+.. code:: console
+
+   just test-all
+
+.. _pytest: https://pytest.readthedocs.io/
+.. _Ruff: https://docs.astral.sh/ruff/

{countdown_cli-2.0.0 → countdown_cli-2.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: countdown-cli
-Version: 2.0.0
+Version: 2.2.0
 Summary: Terminal program to display countdown timer
 Project-URL: homepage, https://github.com/treyhunner/countdown-cli
 Project-URL: repository, https://github.com/treyhunner/countdown-cli
@@ -16,7 +16,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: 3.15
 Requires-Python: >=3.10
-Requires-Dist: click>=8.0.1
+Requires-Dist: click>=8.3.0
 Description-Content-Type: text/x-rst
 
 countdown-cli
@@ -26,8 +26,6 @@ countdown-cli
 
 |Tests| |Codecov|
 
-|pre-commit| |Black|
-
 .. |PyPI| image:: https://img.shields.io/pypi/v/countdown-cli.svg
    :target: https://pypi.org/project/countdown-cli/
    :alt: PyPI
@@ -46,12 +44,6 @@ countdown-cli
 .. |Codecov| image:: https://codecov.io/gh/treyhunner/countdown-cli/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/treyhunner/countdown-cli
    :alt: Codecov
-.. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
-   :target: https://github.com/pre-commit/pre-commit
-   :alt: pre-commit
-.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
-   :target: https://github.com/psf/black
-   :alt: Black
 
 This project is based on a `Python Morsels`_ exercise for a command-line countdown timer.
 If you're working on that exercise right now, please **don't look at the source code** for this. 😉
@@ -77,6 +69,12 @@ Features
 - Pause/resume with ``p``, ``k``, ``Space``, or ``Enter``
 - Add / remove time with ``+`` or ``-``
 
+To start a timer:
+
+.. code:: console
+
+    countdown 6m30s
+
 |32:53|
 
 |14:57|
@@ -103,7 +101,7 @@ You can install **countdown-cli** via uv_ from PyPI_:
 
 .. code:: console
 
-   $ uv tool install countdown-cli
+   uv tool install countdown-cli
 
 
 Contributing

{countdown_cli-2.0.0 → countdown_cli-2.2.0}/README.rst

@@ -5,8 +5,6 @@ countdown-cli
 
 |Tests| |Codecov|
 
-|pre-commit| |Black|
-
 .. |PyPI| image:: https://img.shields.io/pypi/v/countdown-cli.svg
    :target: https://pypi.org/project/countdown-cli/
    :alt: PyPI
@@ -25,12 +23,6 @@ countdown-cli
 .. |Codecov| image:: https://codecov.io/gh/treyhunner/countdown-cli/branch/main/graph/badge.svg
    :target: https://codecov.io/gh/treyhunner/countdown-cli
    :alt: Codecov
-.. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
-   :target: https://github.com/pre-commit/pre-commit
-   :alt: pre-commit
-.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
-   :target: https://github.com/psf/black
-   :alt: Black
 
 This project is based on a `Python Morsels`_ exercise for a command-line countdown timer.
 If you're working on that exercise right now, please **don't look at the source code** for this. 😉
@@ -56,6 +48,12 @@ Features
 - Pause/resume with ``p``, ``k``, ``Space``, or ``Enter``
 - Add / remove time with ``+`` or ``-``
 
+To start a timer:
+
+.. code:: console
+
+    countdown 6m30s
+
 |32:53|
 
 |14:57|
@@ -82,7 +80,7 @@ You can install **countdown-cli** via uv_ from PyPI_:
 
 .. code:: console
 
-   $ uv tool install countdown-cli
+   uv tool install countdown-cli
 
 
 Contributing

{countdown_cli-2.0.0 → countdown_cli-2.2.0}/htmlcov/class_index.html

@@ -56,8 +56,8 @@
                 <a class="button current">Classes</a>
         </h2>
         <p class="text">
-            <a class="nav" href="https://coverage.readthedocs.io/en/7.11.0">coverage.py v7.11.0</a>,
-            created at 2025-11-07 20:46 -0800
+            <a class="nav" href="https://coverage.readthedocs.io/en/7.11.1">coverage.py v7.11.1</a>,
+            created at 2026-03-27 20:23 -0700
         </p>
     </div>
 </header>
@@ -89,12 +89,12 @@
             <tr class="region">
                 <td class="name left"><a href="z_55719c21e2af63da___main___py.html">src/countdown/__main__.py</a></td>
                 <td class="name left"><a href="z_55719c21e2af63da___main___py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
-                <td>54</td>
+                <td>62</td>
                 <td>0</td>
                 <td>1</td>
-                <td>18</td>
+                <td>20</td>
                 <td>0</td>
-                <td class="right" data-ratio="72 72">100%</td>
+                <td class="right" data-ratio="82 82">100%</td>
             </tr>
             <tr class="region">
                 <td class="name left"><a href="z_55719c21e2af63da_digits_py.html">src/countdown/digits.py</a></td>
@@ -109,12 +109,12 @@
             <tr class="region">
                 <td class="name left"><a href="z_55719c21e2af63da_display_py.html">src/countdown/display.py</a></td>
                 <td class="name left"><a href="z_55719c21e2af63da_display_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
-                <td>43</td>
+                <td>47</td>
                 <td>0</td>
                 <td>16</td>
                 <td>10</td>
                 <td>0</td>
-                <td class="right" data-ratio="53 53">100%</td>
+                <td class="right" data-ratio="57 57">100%</td>
             </tr>
             <tr class="region">
                 <td class="name left"><a href="z_55719c21e2af63da_keys_py.html">src/countdown/keys.py</a></td>
@@ -169,12 +169,12 @@
             <tr class="region">
                 <td class="name left"><a href="z_a44f0ac069e85531_test_display_py.html">tests/test_display.py</a></td>
                 <td class="name left"><a href="z_a44f0ac069e85531_test_display_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
-                <td>118</td>
+                <td>124</td>
                 <td>0</td>
                 <td>0</td>
                 <td>6</td>
                 <td>0</td>
-                <td class="right" data-ratio="124 124">100%</td>
+                <td class="right" data-ratio="130 130">100%</td>
             </tr>
             <tr class="region">
                 <td class="name left"><a href="z_a44f0ac069e85531_test_keys_py.html">tests/test_keys.py</a></td>
@@ -188,23 +188,23 @@
             </tr>
             <tr class="region">
                 <td class="name left"><a href="z_a44f0ac069e85531_test_main_py.html#t12">tests/test_main.py</a></td>
-                <td class="name left"><a href="z_a44f0ac069e85531_test_main_py.html#t12"><data value='FakeSleep'>FakeSleep</data></a></td>
-                <td>6</td>
+                <td class="name left"><a href="z_a44f0ac069e85531_test_main_py.html#t12"><data value='FakeClock'>FakeClock</data></a></td>
+                <td>12</td>
                 <td>0</td>
                 <td>0</td>
                 <td>4</td>
                 <td>0</td>
-                <td class="right" data-ratio="10 10">100%</td>
+                <td class="right" data-ratio="16 16">100%</td>
             </tr>
             <tr class="region">
                 <td class="name left"><a href="z_a44f0ac069e85531_test_main_py.html">tests/test_main.py</a></td>
                 <td class="name left"><a href="z_a44f0ac069e85531_test_main_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
-                <td>257</td>
+                <td>394</td>
                 <td>0</td>
                 <td>0</td>
-                <td>8</td>
+                <td>10</td>
                 <td>0</td>
-                <td class="right" data-ratio="265 265">100%</td>
+                <td class="right" data-ratio="404 404">100%</td>
             </tr>
             <tr class="region">
                 <td class="name left"><a href="z_a44f0ac069e85531_test_terminal_py.html">tests/test_terminal.py</a></td>
@@ -219,24 +219,24 @@
             <tr class="region">
                 <td class="name left"><a href="z_a44f0ac069e85531_test_timer_py.html">tests/test_timer.py</a></td>
                 <td class="name left"><a href="z_a44f0ac069e85531_test_timer_py.html"><data value=''><span class='no-noun'>(no class)</span></data></a></td>
-                <td>44</td>
+                <td>49</td>
                 <td>0</td>
                 <td>0</td>
                 <td>0</td>
                 <td>0</td>
-                <td class="right" data-ratio="44 44">100%</td>
+                <td class="right" data-ratio="49 49">100%</td>
             </tr>
         </tbody>
         <tfoot>
             <tr class="total">
                 <td class="name left">Total</td>
                 <td class="name left">&nbsp;</td>
-                <td>620</td>
+                <td>786</td>
                 <td>0</td>
                 <td>84</td>
-                <td>68</td>
+                <td>72</td>
                 <td>0</td>
-                <td class="right" data-ratio="688 688">100%</td>
+                <td class="right" data-ratio="858 858">100%</td>
             </tr>
         </tfoot>
     </table>
@@ -247,8 +247,8 @@
 <footer>
     <div class="content">
         <p>
-            <a class="nav" href="https://coverage.readthedocs.io/en/7.11.0">coverage.py v7.11.0</a>,
-            created at 2025-11-07 20:46 -0800
+            <a class="nav" href="https://coverage.readthedocs.io/en/7.11.1">coverage.py v7.11.1</a>,
+            created at 2026-03-27 20:23 -0700
         </p>
     </div>
     <aside class="hidden">