PomCli 0.1.0__tar.gz

pomcli-0.1.0/.idea/.gitignore

@@ -0,0 +1,8 @@
+# Default ignored files
+/shelf/
+/workspace.xml
+# Editor-based HTTP Client requests
+/httpRequests/
+# Datasource local storage ignored files
+/dataSources/
+/dataSources.local.xml

pomcli-0.1.0/.idea/.name

@@ -0,0 +1 @@
+PomCli

pomcli-0.1.0/.idea/PomCli.iml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src" isTestSource="false" />
+      <sourceFolder url="file://$MODULE_DIR$/tests" isTestSource="true" />
+    </content>
+    <orderEntry type="jdk" jdkName="Hatch (pythonproject1) [Python 3.12.7]" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

pomcli-0.1.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

pomcli-0.1.0/.idea/misc.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Hatch (pythonproject1) [Python 3.12.7]" />
+  </component>
+</project>

pomcli-0.1.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/PythonProject1.iml" filepath="$PROJECT_DIR$/.idea/PythonProject1.iml" />
+    </modules>
+  </component>
+</project>

pomcli-0.1.0/.idea/workspace.xml

@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="AutoImportSettings">
+    <option name="autoReloadType" value="SELECTIVE" />
+  </component>
+  <component name="ChangeListManager">
+    <list default="true" id="21804819-0ee5-4d07-9a58-0a8a692c6689" name="Changes" comment="" />
+    <option name="SHOW_DIALOG" value="false" />
+    <option name="HIGHLIGHT_CONFLICTS" value="true" />
+    <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
+    <option name="LAST_RESOLUTION" value="IGNORE" />
+  </component>
+  <component name="ProjectColorInfo"><![CDATA[{
+  "associatedIndex": 1
+}]]></component>
+  <component name="ProjectId" id="2z7o5ttqCSmO2xFVLxQDn63jJfG" />
+  <component name="ProjectViewState">
+    <option name="hideEmptyMiddlePackages" value="true" />
+    <option name="showLibraryContents" value="true" />
+  </component>
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "ModuleVcsDetector.initialDetectionPerformed": "true",
+    "Python tests.Python tests for test_pomodoro.TestPomodoroTimer.executor": "Run",
+    "Python.hello_example.executor": "Run",
+    "Python.pomodoro_example.executor": "Run",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "node.js.detected.package.eslint": "true",
+    "node.js.detected.package.tslint": "true",
+    "node.js.selected.package.eslint": "(autodetect)",
+    "node.js.selected.package.tslint": "(autodetect)",
+    "nodejs_package_manager_path": "npm",
+    "vue.rearranger.settings.migration": "true"
+  }
+}]]></component>
+  <component name="RunManager">
+    <configuration name="Python tests for test_pomodoro.TestPomodoroTimer" type="tests" factoryName="Autodetect" temporary="true" nameIsGenerated="true">
+      <module name="PythonProject1" />
+      <option name="ENV_FILES" value="" />
+      <option name="INTERPRETER_OPTIONS" value="" />
+      <option name="PARENT_ENVS" value="true" />
+      <option name="SDK_HOME" value="" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/tests" />
+      <option name="IS_MODULE_SDK" value="true" />
+      <option name="ADD_CONTENT_ROOTS" value="true" />
+      <option name="ADD_SOURCE_ROOTS" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="_new_additionalArguments" value="&quot;&quot;" />
+      <option name="_new_target" value="&quot;test_pomodoro.TestPomodoroTimer&quot;" />
+      <option name="_new_targetType" value="&quot;PYTHON&quot;" />
+      <method v="2" />
+    </configuration>
+    <recent_temporary>
+      <list>
+        <item itemvalue="Python tests.Python tests for test_pomodoro.TestPomodoroTimer" />
+      </list>
+    </recent_temporary>
+  </component>
+  <component name="SharedIndexes">
+    <attachedChunks>
+      <set>
+        <option value="bundled-js-predefined-d6986cc7102b-b26f3e71634d-JavaScript-PY-251.26094.141" />
+        <option value="bundled-python-sdk-9f8e2b94138c-36ea0e71a18c-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-251.26094.141" />
+      </set>
+    </attachedChunks>
+  </component>
+  <component name="TaskManager">
+    <task active="true" id="Default" summary="Default task">
+      <changelist id="21804819-0ee5-4d07-9a58-0a8a692c6689" name="Changes" comment="" />
+      <created>1751091293397</created>
+      <option name="number" value="Default" />
+      <option name="presentableId" value="Default" />
+      <updated>1751091293397</updated>
+      <workItem from="1751091294400" duration="2280000" />
+    </task>
+    <servers />
+  </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
+  <component name="com.intellij.coverage.CoverageDataManagerImpl">
+    <SUITE FILE_PATH="coverage/PythonProject1$hello_example.coverage" NAME="hello_example Coverage Results" MODIFIED="1751091752281" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/PythonProject1$pomodoro_example.coverage" NAME="pomodoro_example Coverage Results" MODIFIED="1751091915089" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$" />
+    <SUITE FILE_PATH="coverage/PythonProject1$.coverage" NAME=" Coverage Results" MODIFIED="1751092017011" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/tests" />
+  </component>
+</project>

pomcli-0.1.0/LICENSE.txt

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2025-present Yaniv Grosskopf <101043539+YanivGros@users.noreply.github.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

pomcli-0.1.0/PKG-INFO

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: PomCli
+Version: 0.1.0
+Summary: A simple Pomodoro timer CLI tool.
+Project-URL: Documentation, https://github.com/YanivGrosskopf/PomCli#readme
+Project-URL: Issues, https://github.com/YanivGrosskopf/PomCli/issues
+Project-URL: Source, https://github.com/YanivGrosskopf/PomCli
+Author-email: Yaniv Grosskopf <qywoec@gmail.com>
+License-Expression: MIT
+License-File: LICENSE.txt
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# PomCli
+
+[![PyPI - Version](https://img.shields.io/pypi/v/pomcli.svg)](https://pypi.org/project/pomcli)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pomcli.svg)](https://pypi.org/project/pomcli)
+
+-----
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [License](#license)
+
+## Installation
+
+```console
+pip install pomcli
+```
+
+## Usage
+
+Run the Pomodoro timer from the command line:
+
+```console
+pomcli --work 25 --break_time 5
+```
+
+- `--work`: Work duration in minutes (default: 25)
+- `--break_time`: Break duration in minutes (default: 5)
+
+## License
+
+`PomCli` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

pomcli-0.1.0/README.md

@@ -0,0 +1,33 @@
+# PomCli
+
+[![PyPI - Version](https://img.shields.io/pypi/v/pomcli.svg)](https://pypi.org/project/pomcli)
+[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pomcli.svg)](https://pypi.org/project/pomcli)
+
+-----
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [License](#license)
+
+## Installation
+
+```console
+pip install pomcli
+```
+
+## Usage
+
+Run the Pomodoro timer from the command line:
+
+```console
+pomcli --work 25 --break_time 5
+```
+
+- `--work`: Work duration in minutes (default: 25)
+- `--break_time`: Break duration in minutes (default: 5)
+
+## License
+
+`PomCli` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

pomcli-0.1.0/pomodoro_example.py

@@ -0,0 +1,5 @@
+from pomcli.pomodoro import PomodoroTimer
+
+if __name__ == "__main__":
+    timer = PomodoroTimer(work_minutes=0.1, break_minutes=0.05)  # Short times for demo
+    timer.start()

pomcli-0.1.0/pyproject.toml

@@ -0,0 +1,64 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "PomCli"
+dynamic = ["version"]
+description = 'A simple Pomodoro timer CLI tool.'
+readme = "README.md"
+requires-python = ">=3.8"
+license = "MIT"
+keywords = []
+authors = [
+  { name = "Yaniv Grosskopf", email = "qywoec@gmail.com" },
+]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: Implementation :: CPython",
+  "Programming Language :: Python :: Implementation :: PyPy",
+]
+dependencies = []
+
+[project.urls]
+Documentation = "https://github.com/YanivGrosskopf/PomCli#readme"
+Issues = "https://github.com/YanivGrosskopf/PomCli/issues"
+Source = "https://github.com/YanivGrosskopf/PomCli"
+
+[tool.hatch.version]
+path = "src/pomcli/__about__.py"
+
+[tool.hatch.envs.types]
+extra-dependencies = [
+  "mypy>=1.0.0",
+]
+[tool.hatch.envs.types.scripts]
+check = "mypy --install-types --non-interactive {args:src/pomcli tests}"
+
+[tool.coverage.run]
+source_pkgs = ["pomcli", "tests"]
+branch = true
+parallel = true
+omit = [
+  "src/pomcli/__about__.py",
+]
+
+[tool.coverage.paths]
+pomcli = ["src/pomcli", "*/pomcli/src/pomcli"]
+tests = ["tests", "*/pythonproject1/tests"]
+
+[tool.coverage.report]
+exclude_lines = [
+  "no cov",
+  "if __name__ == .__main__.:",
+  "if TYPE_CHECKING:",
+]
+
+[project.scripts]
+pomcli = "pomcli.pomodoro:main"

pomcli-0.1.0/src/pomcli/__about__.py

@@ -0,0 +1,3 @@
+# __about__.py for PomCli
+__version__ = "0.1.0"
+

pomcli-0.1.0/src/pomcli/__init__.py

@@ -0,0 +1,2 @@
+# This file is required to make pomcli a package.
+

pomcli-0.1.0/src/pomcli/pomodoro.py

@@ -0,0 +1,43 @@
+import time
+import logging
+
+class PomodoroTimer:
+    def __init__(self, work_minutes=25, break_minutes=5, logger=None):
+        self.work_minutes = work_minutes
+        self.break_minutes = break_minutes
+        self.is_running = False
+        self.logger = logger or logging.getLogger(__name__)
+
+    def start(self):
+        self.is_running = True
+        self.logger.info(f"Starting Pomodoro: {self.work_minutes} minutes of work.")
+        self._countdown(self.work_minutes * 60, "Work")
+        self.logger.info(f"Time for a break: {self.break_minutes} minutes.")
+        self._countdown(self.break_minutes * 60, "Break")
+        self.logger.info("Pomodoro session complete!")
+        self.is_running = False
+
+    def _countdown(self, seconds, label):
+        while seconds > 0 and self.is_running:
+            mins, secs = divmod(int(seconds), 60)
+            timeformat = f'{mins:02d}:{secs:02d}'
+            self.logger.debug(f'{label} Timer: {timeformat}')
+            time.sleep(1)
+            seconds -= 1
+
+    def stop(self):
+        self.is_running = False
+        self.logger.info("Pomodoro stopped.")
+
+def main():
+    import argparse
+    logging.basicConfig(level=logging.INFO, format='%(message)s')
+    parser = argparse.ArgumentParser(description="Simple Pomodoro CLI Timer")
+    parser.add_argument('--work', type=float, default=25, help='Work duration in minutes (default: 25)')
+    parser.add_argument('--break_time', type=float, default=5, help='Break duration in minutes (default: 5)')
+    args = parser.parse_args()
+    timer = PomodoroTimer(work_minutes=args.work, break_minutes=args.break_time)
+    timer.start()
+
+if __name__ == "__main__":
+    main()

pomcli-0.1.0/tests/__init__.py

@@ -0,0 +1,3 @@
+# SPDX-FileCopyrightText: 2025-present Yaniv Grosskopf <101043539+YanivGros@users.noreply.github.com>
+#
+# SPDX-License-Identifier: MIT

pomcli-0.1.0/tests/test_pomodoro.py

@@ -0,0 +1,45 @@
+import unittest
+import time
+import logging
+from pomcli.pomodoro import PomodoroTimer
+
+class TestPomodoroTimer(unittest.TestCase):
+    def setUp(self):
+        self.logger = logging.getLogger("pomodoro_test")
+        self.logger.setLevel(logging.DEBUG)
+        self.log_output = []
+        handler = logging.StreamHandler(self._LogCapture(self.log_output))
+        handler.setFormatter(logging.Formatter('%(levelname)s:%(message)s'))
+        self.logger.handlers = [handler]
+
+    class _LogCapture:
+        def __init__(self, output_list):
+            self.output_list = output_list
+        def write(self, msg):
+            if msg.strip():
+                self.output_list.append(msg.strip())
+        def flush(self):
+            pass
+
+    def test_start_and_stop(self):
+        timer = PomodoroTimer(work_minutes=0, break_minutes=0, logger=self.logger)
+        timer.start()
+        self.assertIn("INFO:Starting Pomodoro: 0 minutes of work.", self.log_output)
+        self.assertIn("INFO:Time for a break: 0 minutes.", self.log_output)
+        self.assertIn("INFO:Pomodoro session complete!", self.log_output)
+        timer.stop()
+        self.assertIn("INFO:Pomodoro stopped.", self.log_output)
+
+    def test_stop_midway(self):
+        timer = PomodoroTimer(work_minutes=0.001, break_minutes=0, logger=self.logger)
+        import threading
+        t = threading.Thread(target=timer.start)
+        t.start()
+        time.sleep(0.5)
+        timer.stop()
+        t.join()
+        self.assertIn("INFO:Pomodoro stopped.", self.log_output)
+
+if __name__ == "__main__":
+    unittest.main()
+