chronossync-lite 0.1.0

A lightweight live ticking clock with custom ordinals.

MIT License

Python 3.6+

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:

pip install .

or

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:

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:

>>> 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:

python -m unittest discover tests