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

