chronossync-lite 0.1.0__tar.gz

chronossync_lite-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TheLostIdea1
+
+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.

chronossync_lite-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+recursive-include tests *.py
+

chronossync_lite-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: chronossync-lite
+Version: 0.1.0
+Summary: A lightweight live ticking clock with custom ordinals.
+Author: TheLostIdea1
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+![MIT License](https://upload.wikimedia.org/wikipedia/commons/6/6b/License_icon-mit-88x31.svg)  
+*MIT License*
+
+![Python 3.6](https://upload.wikimedia.org/wikipedia/commons/c/c3/Python-logo-notext.svg)  
+*Python 3.6+*
+
+![Author](https://upload.wikimedia.org/wikipedia/commons/8/87/Light_Bulb_or_Idea_Flat_Icon_Vector.svg)  
+*Author: TheLostIdea1*
+
+## Chronos Sync Lite
+
+Hello, time travelers! **Chronos Sync Lite** provides a streamlined, live-ticking terminal experience. This version focuses on the core "present" functionality with a unique triple-naming system.
+
+---
+
+### 1. Installation & Setup
+
+Install the library using `pip` from your local build:
+
+```shell
+pip install .
+```
+
+or
+
+```shell
+pip install chronossync-lite
+```
+
+---
+
+### 2. Usage & Syntax
+
+**Chronos Sync Lite** can be used in the REPL or within a Python script. 
+
+#### Python Script Usage
+When using a script, you must wrap the call in `print()` to trigger the internal display loop:
+
+```python
+import chronossync_lite
+
+# Triple naming: Package.Module/Class.Method
+print(chronossync_lite.chronossync_lite.present())
+```
+
+#### REPL Usage
+In a REPL environment, simply evaluating the method will trigger the clock:
+
+```python
+>>> import chronossync_lite
+>>> chronossync_lite.chronossync_lite.present()
+```
+
+---
+
+### 3. Logic and Mechanics
+
+* **Triple Naming**: Access the logic via `chronossync_lite.chronossync_lite.present()`.
+* **Anti-Flicker (\r)**: Uses carriage returns to overwrite the current line, preserving terminal history.
+* **The "Ordinal" Logic**: Follows a custom convention:
+    * 1st, 2nd, 3th (e.g., "3th of March").
+    * Applies to the tens place: 21st, 22nd, 23th.
+* **Graceful Termination**: Press Ctrl+C at any time to stop the live loop and return to the prompt.
+
+---
+
+### 4. Development & Testing
+
+This project uses the modern `src` layout. To verify the logic, run the test suite from the root directory:
+
+```shell
+python -m unittest discover tests
+```
+

chronossync_lite-0.1.0/README.md

@@ -0,0 +1,74 @@
+![MIT License](https://upload.wikimedia.org/wikipedia/commons/6/6b/License_icon-mit-88x31.svg)  
+*MIT License*
+
+![Python 3.6](https://upload.wikimedia.org/wikipedia/commons/c/c3/Python-logo-notext.svg)  
+*Python 3.6+*
+
+![Author](https://upload.wikimedia.org/wikipedia/commons/8/87/Light_Bulb_or_Idea_Flat_Icon_Vector.svg)  
+*Author: TheLostIdea1*
+
+## Chronos Sync Lite
+
+Hello, time travelers! **Chronos Sync Lite** provides a streamlined, live-ticking terminal experience. This version focuses on the core "present" functionality with a unique triple-naming system.
+
+---
+
+### 1. Installation & Setup
+
+Install the library using `pip` from your local build:
+
+```shell
+pip install .
+```
+
+or
+
+```shell
+pip install chronossync-lite
+```
+
+---
+
+### 2. Usage & Syntax
+
+**Chronos Sync Lite** can be used in the REPL or within a Python script. 
+
+#### Python Script Usage
+When using a script, you must wrap the call in `print()` to trigger the internal display loop:
+
+```python
+import chronossync_lite
+
+# Triple naming: Package.Module/Class.Method
+print(chronossync_lite.chronossync_lite.present())
+```
+
+#### REPL Usage
+In a REPL environment, simply evaluating the method will trigger the clock:
+
+```python
+>>> import chronossync_lite
+>>> chronossync_lite.chronossync_lite.present()
+```
+
+---
+
+### 3. Logic and Mechanics
+
+* **Triple Naming**: Access the logic via `chronossync_lite.chronossync_lite.present()`.
+* **Anti-Flicker (\r)**: Uses carriage returns to overwrite the current line, preserving terminal history.
+* **The "Ordinal" Logic**: Follows a custom convention:
+    * 1st, 2nd, 3th (e.g., "3th of March").
+    * Applies to the tens place: 21st, 22nd, 23th.
+* **Graceful Termination**: Press Ctrl+C at any time to stop the live loop and return to the prompt.
+
+---
+
+### 4. Development & Testing
+
+This project uses the modern `src` layout. To verify the logic, run the test suite from the root directory:
+
+```shell
+python -m unittest discover tests
+```
+

chronossync_lite-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

chronossync_lite-0.1.0/setup.py

@@ -0,0 +1,26 @@
+from setuptools import setup, find_packages
+
+# Reading the cleaned README.md for the long description
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="chronossync-lite",
+    version="0.1.0",
+    author="TheLostIdea1",
+    description="A lightweight live ticking clock with custom ordinals.",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    license="MIT",
+    include_package_data=True,
+    # Maps the 'src' directory to the package
+    packages=find_packages(where="src"),
+    package_dir={"": "src"},
+    python_requires=">=3.6",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+)
+

chronossync_lite-0.1.0/src/chronossync_lite/__init__.py

@@ -0,0 +1,2 @@
+from .chronossync_lite import chronossync_lite
+

chronossync_lite-0.1.0/src/chronossync_lite/chronossync_lite.py

@@ -0,0 +1,44 @@
+import time
+import sys
+from datetime import datetime
+
+class chronossync_lite:
+    def __init__(self):
+        self._now = datetime.now()
+        
+    def _get_tz_string(self):
+        offset_seconds = -time.timezone if (time.daylight == 0) else -time.altzone
+        sign = "+" if offset_seconds >= 0 else "-"
+        offset_abs = abs(offset_seconds)
+        hours = offset_abs // 3600
+        minutes = (offset_abs % 3600) // 60
+        return f"GMT{sign}{hours:02}:{minutes:02}"
+
+    def _get_ordinal(self, day):
+        # Custom logic: 1st, 2nd, 3th... 21st, 22nd, 23th
+        if 11 <= day <= 13: return f"{day}th"
+        last_digit = day % 10
+        if last_digit == 1: return f"{day}st"
+        if last_digit == 2: return f"{day}nd"
+        return f"{day}th"
+
+    @classmethod
+    def present(cls):
+        return cls()
+
+    def __repr__(self):
+        try:
+            while True:
+                now = datetime.now()
+                day_str = self._get_ordinal(now.day)
+                date_part = now.strftime(f"%A, {day_str} of %B, %Y")
+                time_part = now.strftime("%I:%M:%S %p")
+                tz_part = self._get_tz_string()
+                
+                output = f"{date_part}, {time_part}, {tz_part}"
+                sys.stdout.write(f"\r{output}")
+                sys.stdout.flush()
+                time.sleep(1)
+        except KeyboardInterrupt:
+            return "\n[Clock Stopped]"
+

chronossync_lite-0.1.0/src/chronossync_lite.egg-info/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: chronossync-lite
+Version: 0.1.0
+Summary: A lightweight live ticking clock with custom ordinals.
+Author: TheLostIdea1
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: author
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-python
+Dynamic: summary
+
+![MIT License](https://upload.wikimedia.org/wikipedia/commons/6/6b/License_icon-mit-88x31.svg)  
+*MIT License*
+
+![Python 3.6](https://upload.wikimedia.org/wikipedia/commons/c/c3/Python-logo-notext.svg)  
+*Python 3.6+*
+
+![Author](https://upload.wikimedia.org/wikipedia/commons/8/87/Light_Bulb_or_Idea_Flat_Icon_Vector.svg)  
+*Author: TheLostIdea1*
+
+## Chronos Sync Lite
+
+Hello, time travelers! **Chronos Sync Lite** provides a streamlined, live-ticking terminal experience. This version focuses on the core "present" functionality with a unique triple-naming system.
+
+---
+
+### 1. Installation & Setup
+
+Install the library using `pip` from your local build:
+
+```shell
+pip install .
+```
+
+or
+
+```shell
+pip install chronossync-lite
+```
+
+---
+
+### 2. Usage & Syntax
+
+**Chronos Sync Lite** can be used in the REPL or within a Python script. 
+
+#### Python Script Usage
+When using a script, you must wrap the call in `print()` to trigger the internal display loop:
+
+```python
+import chronossync_lite
+
+# Triple naming: Package.Module/Class.Method
+print(chronossync_lite.chronossync_lite.present())
+```
+
+#### REPL Usage
+In a REPL environment, simply evaluating the method will trigger the clock:
+
+```python
+>>> import chronossync_lite
+>>> chronossync_lite.chronossync_lite.present()
+```
+
+---
+
+### 3. Logic and Mechanics
+
+* **Triple Naming**: Access the logic via `chronossync_lite.chronossync_lite.present()`.
+* **Anti-Flicker (\r)**: Uses carriage returns to overwrite the current line, preserving terminal history.
+* **The "Ordinal" Logic**: Follows a custom convention:
+    * 1st, 2nd, 3th (e.g., "3th of March").
+    * Applies to the tens place: 21st, 22nd, 23th.
+* **Graceful Termination**: Press Ctrl+C at any time to stop the live loop and return to the prompt.
+
+---
+
+### 4. Development & Testing
+
+This project uses the modern `src` layout. To verify the logic, run the test suite from the root directory:
+
+```shell
+python -m unittest discover tests
+```
+

chronossync_lite-0.1.0/src/chronossync_lite.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+MANIFEST.in
+README.md
+setup.py
+src/chronossync_lite/__init__.py
+src/chronossync_lite/chronossync_lite.py
+src/chronossync_lite.egg-info/PKG-INFO
+src/chronossync_lite.egg-info/SOURCES.txt
+src/chronossync_lite.egg-info/dependency_links.txt
+src/chronossync_lite.egg-info/top_level.txt
+tests/test_logic.py

chronossync_lite-0.1.0/src/chronossync_lite.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chronossync_lite-0.1.0/src/chronossync_lite.egg-info/top_level.txt

@@ -0,0 +1 @@
+chronossync_lite

chronossync_lite-0.1.0/tests/test_logic.py

@@ -0,0 +1,13 @@
+import unittest
+from chronossync_lite import chronossync_lite
+
+class TestLiteLogic(unittest.TestCase):
+    def test_ordinals(self):
+        # Accessing the class via the import structure
+        clock = chronossync_lite.chronossync_lite()
+        self.assertEqual(clock._get_ordinal(3), "3th")
+        self.assertEqual(clock._get_ordinal(22), "22nd")
+
+if __name__ == '__main__':
+    unittest.main()
+