Compare commits
No commits in common. "main" and "v0.1.0.0" have entirely different histories.
106
docs/README.md
106
docs/README.md
|
|
@ -1,106 +0,0 @@
|
||||||
# Skyfeed
|
|
||||||
Leak Technologies — Terminal Weather Intelligence
|
|
||||||
|
|
||||||
Skyfeed is a minimal, terminal-style weather application built for Linux systems.
|
|
||||||
It retrieves live Environment Canada data, normalizes conditions, and displays
|
|
||||||
them using a clean Unicode interface with a black-on-colour retro aesthetic.
|
|
||||||
|
|
||||||
This project forms the foundation of the weather system that will power the
|
|
||||||
Telefact information service.
|
|
||||||
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
Features
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
|
|
||||||
• Real-time Environment Canada weather data
|
|
||||||
• Government alert integration (warnings, advisories, statements)
|
|
||||||
• Automatic or manual location detection
|
|
||||||
• Unicode icon set (no external graphics required)
|
|
||||||
• Monospaced terminal UI (inspired by Ceefax / MS-DOS)
|
|
||||||
• Multilingual support (English, French, Inuktut)
|
|
||||||
• Configurable refresh and cache intervals
|
|
||||||
• Optional alert border and clock display
|
|
||||||
• Modular architecture for easy reuse by Telefact
|
|
||||||
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
Installation
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
|
|
||||||
Requirements:
|
|
||||||
- Python 3.13 or later
|
|
||||||
- pip
|
|
||||||
- Linux or compatible terminal environment
|
|
||||||
|
|
||||||
Clone and install locally:
|
|
||||||
git clone https://git.leaktechnologies.dev/stu/Skyfeed.git
|
|
||||||
cd Skyfeed
|
|
||||||
pip install -r requirements.txt # if created later
|
|
||||||
python -m src.cli.main
|
|
||||||
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
Configuration
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
|
|
||||||
Configuration file:
|
|
||||||
config/config.json
|
|
||||||
|
|
||||||
Key options:
|
|
||||||
• Language — en_CA, fr_CA, iu_CA
|
|
||||||
• Theme — dark / custom
|
|
||||||
• ManualLocation — override IP lookup
|
|
||||||
• Display — alert borders, clock toggle, icon scale
|
|
||||||
• RefreshMinutes — update interval
|
|
||||||
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
Running Tests
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
|
|
||||||
Run all tests:
|
|
||||||
pytest -v
|
|
||||||
|
|
||||||
Run a specific test:
|
|
||||||
pytest tests/test_weather_client.py
|
|
||||||
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
Development Notes
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
|
|
||||||
Version format:
|
|
||||||
MAJOR.MINOR.PATCH.DEV
|
|
||||||
|
|
||||||
Example:
|
|
||||||
0.1.0.0 = Initial scaffolding and documentation
|
|
||||||
0.1.0.1 = Development build after README and tests
|
|
||||||
0.1.1.0 = Patch release with fixes
|
|
||||||
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
Roadmap
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
|
|
||||||
• [x] Initial architecture and documentation
|
|
||||||
• [x] Unicode weather symbol mapping
|
|
||||||
• [x] Localization (English, French, Inuktut)
|
|
||||||
• [ ] Minimal terminal UI
|
|
||||||
• [ ] Fullscreen weather view
|
|
||||||
• [ ] Alert notification bar
|
|
||||||
• [ ] Integration with Telefact
|
|
||||||
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
Repository
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
|
|
||||||
Primary repo:
|
|
||||||
https://git.leaktechnologies.dev/stu/Skyfeed.git
|
|
||||||
|
|
||||||
Maintainer:
|
|
||||||
Stu Leak — Leak Technologies
|
|
||||||
|
|
||||||
License:
|
|
||||||
MIT License (see LICENSE file)
|
|
||||||
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
Version
|
|
||||||
----------------------------------------------------------------------
|
|
||||||
|
|
||||||
Current version: 0.1.0.1-dev
|
|
||||||
Revision date: November 2025
|
|
||||||
Loading…
Reference in New Issue
Block a user