chronossync 0.1.0.post2

A live ticking clock with custom formatting.

MIT License

Python 3.6+

Author: TheLostIdea1

Chronos Sync

Hello, time travelers! We all know that time... is money, but what if... you want to check the time with no clock? A python script or browsing the web helps. ChronosSync provides a live-ticking terminal experience with high-precision tools, mimicking the namespace style of the standard datetime library.

---

1. Installation & Setup

Install the library using pip from PyPI or TestPyPI:

Standard PyPI:

pip install chronossync

TestPyPI:

python -m pip install --index-url [https://test.pypi.org/simple/](https://test.pypi.org/simple/) chronossync

---

2. Usage & Syntax

ChronosSync allows you to use the library via the full namespace or by importing the class directly.

Live Clock

Evaluating the present() method triggers a live-updating clock in your terminal.

import chronossync
chronossync.chronossync.present()

Timer & Stopwatch

High-precision tools using hh:mm:ss.ms formatting.

from chronossync import chronossync

# 10-second countdown timer
chronossync.timer(10)

# Endless stopwatch
chronossync.stopwatch()

Data Extraction

Extract specific strings without starting a loop.

clock = chronossync.present()
print(clock.date())   # Tuesday, 24th of February, 2026
print(clock.time())   # 06:45:12 PM
print(clock.tzone())  # GMT+06:00

---

3. Logic and Mechanics

• Anti-Flicker (\r): Unlike scripts that clear the whole screen, ChronosSync uses carriage returns to overwrite the current line, preserving your terminal history.
• Precision Timing: The Timer and Stopwatch use time.perf_counter() to remain accurate down to the millisecond, independent of system clock shifts.
• The "Ordinal" Logic: Intentionally follows a custom convention inspired by internet culture:
  • 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 cleanly.

---

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

---