PyPI - leadger - Versions diffs - 0.1.0__py3-none-any.whl - Mend

leadger 0.1.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (23) hide show

leadger/__init__.py +1 -0
leadger/__main__.py +5 -0
leadger/cli.py +253 -0
leadger/core/__init__.py +14 -0
leadger/core/ics.py +82 -0
leadger/core/ids.py +16 -0
leadger/core/parse.py +79 -0
leadger/core/periods.py +32 -0
leadger/core/recur.py +45 -0
leadger/core/storage.py +385 -0
leadger/core/tasks.py +161 -0
leadger/core/time_utils.py +43 -0
leadger/core/yaml_io.py +97 -0
leadger/server.py +221 -0
leadger/static/assets/index-BFMiMAZM.css +2 -0
leadger/static/assets/index-PnqahOsL.js +24 -0
leadger/static/favicon.svg +5 -0
leadger/static/index.html +14 -0
leadger-0.1.0.dist-info/METADATA +215 -0
leadger-0.1.0.dist-info/RECORD +23 -0
leadger-0.1.0.dist-info/WHEEL +4 -0
leadger-0.1.0.dist-info/entry_points.txt +2 -0
leadger-0.1.0.dist-info/licenses/LICENSE +21 -0

leadger/static/index.html ADDED Viewed

@@ -0,0 +1,14 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="/favicon.svg?v=2" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Leadger</title>
+    <script type="module" crossorigin src="/assets/index-PnqahOsL.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-BFMiMAZM.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

leadger-0.1.0.dist-info/METADATA ADDED Viewed

@@ -0,0 +1,215 @@
+Metadata-Version: 2.4
+Name: leadger
+Version: 0.1.0
+Summary: Personal productivity — local, calm, yours.
+Author-email: Gabriel Henrique <gabrielhcacontato@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: cli,local-first,productivity,tasks,todo,yaml
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: Web Environment
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Office/Business :: Scheduling
+Requires-Python: >=3.11
+Requires-Dist: fastapi>=0.111
+Requires-Dist: ruamel-yaml>=0.18
+Requires-Dist: typer>=0.12
+Requires-Dist: tzdata>=2024.1; sys_platform == 'win32'
+Requires-Dist: uvicorn[standard]>=0.29
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: httpx>=0.27; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Description-Content-Type: text/markdown
+<div align="center">
+# Leadger
+**Personal productivity — local, calm, yours.**
+[![PyPI](https://img.shields.io/pypi/v/leadger)](https://pypi.org/project/leadger/)
+[![Python](https://img.shields.io/badge/python-3.11%2B-blue)](https://pypi.org/project/leadger/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+*For the important tasks that don't belong in your work's Jira.*
+</div>
+---
+No cloud. No account. No telemetry. No gamification. Your data lives in a
+single human-readable YAML file you can keep in git.
+```bash
+pip install leadger
+leadger
+```
+That starts a local web UI on `localhost` and opens your browser. No Node
+required — the frontend ships embedded in the package.
+<!-- demo: add docs/presentation.mp4 or a screenshot here -->
+## Why Leadger?
+Most task apps fail the same way: red "overdue" badges that breed anxiety,
+metrics you can game by deleting tasks, and feature creep that turns a todo
+list into a project-management chore. Leadger takes the opposite bet —
+**statistical honesty about yourself, calmly delivered**:
+- **Frozen daily goal.** The first time you open Leadger each day, it
+  snapshots your planned tasks: that's your goal. Tasks created during the
+  day count as *extras* — they add to your delivery but never inflate the
+  goal. Cancelling or deleting a planned task doesn't shrink the goal
+  either (anti-gaming, by design).
+- **"% of the day delivered."** The hero metric. It can pass 100%
+  (over-delivery gets a second amber lap on the ring). Zero goal with
+  deliveries = bonus day (∞).
+- **Honest rollover.** Whatever you don't finish migrates to the next day
+  automatically, with a visible `↻N` counter. History surfaces your most
+  pushed tasks — procrastination becomes visible, without judgment.
+- **Personal correction factor.** *"You plan 5.8 tasks/day on average and
+  deliver 5.2 — your real rate is 90%."* Just statistics over your last 30
+  days, so you can plan like the person you actually are.
+- **Week at a glance.** The Week view shows each day's % (Mon→Sun strip),
+  the week's aggregate on the ring, and the list split into *not done* /
+  *done*.
+- **Stale-task alert.** A task open for 7+ days triggers a one-time,
+  dismissable notice: complete, reschedule, pause or cancel — deciding is
+  progress too.
+- **Markdown summary.** One palette action copies the period's
+  goal/delivered/% plus both task lists — ready to paste into a standup.
+## Quick capture
+An always-visible input with live syntax highlighting:
+```
+Estudar FAISS #estudo !amanha
+Entregar relatório #trabalho !sex
+Pagar contas !2026-07-01
+Meditar !todo-dia
+Review da semana #trabalho !rec:seg
+```
+| Token | Meaning |
+|---|---|
+| `#tag` | add a tag (click a tag in the list to filter by it) |
+| `!hoje` / `!amanha` | target today / tomorrow |
+| `!seg`…`!dom` | target the next matching weekday |
+| `!YYYY-MM-DD` | target an exact date |
+| `!todo-dia` | recurring: every day |
+| `!rec:dia` / `!rec:seg`…`!rec:dom` | recurring: daily / weekly on that weekday |
+> Capture tokens are Portuguese — Leadger is a PT-first product; the UI
+> ships in Portuguese and English (toggle in the header).
+**Recurring tasks** are materialized one occurrence at a time: completing
+the open occurrence creates the next; cancelling or deleting it ends the
+series. The daily goal stays honest — each occurrence counts as a regular
+task on its day.
+## Keyboard first (mouse welcome)
+| Key | Action |
+|---|---|
+| `n` | focus capture |
+| `j` / `k` | navigate the list |
+| `x` / `p` / `c` | complete · pause · cancel |
+| `e` | inline edit (double-click works too) |
+| `1`–`6` | period: Day · Week · Month · Quarter · Half · Year |
+| `⌘K` / `Ctrl+K` | command palette |
+| `g h` / `g t` | History · Today |
+| `?` | cheatsheet |
+Every keyboard action also has a visual control — hover a task row for
+edit/pause/cancel/delete buttons, each tooltip teaching its shortcut.
+## CLI
+```bash
+leadger                       # start the server and open the browser
+leadger serve --port 8080 --no-browser
+leadger add "Estudar FAISS #estudo !amanha"
+leadger today                 # today's summary in the terminal
+leadger week                  # weekly summary: % per day + (not) done
+leadger ics --out agenda.ics  # export open tasks as iCalendar
+leadger --data other.yaml …   # use another data file
+```
+## Calendar (.ics)
+See your open tasks in any calendar app, without a cloud:
+`leadger ics --out leadger.ics` writes the file, and with the server
+running, `http://localhost:4242/calendar.ics` serves the same content.
+Recurring tasks become `RRULE`s, so the whole series shows up projected on
+your calendar. The export is read-only — the YAML remains the single
+source of truth.
+## Your data
+Everything lives in `~/.leadger/leadger.yaml` — a commented, readable,
+versionable YAML file. Leadger preserves your comments and key order on
+every write (round-trip), writes atomically and keeps a `.bak` of the
+previous version. Edit it in any editor; the app detects the change and
+reloads.
+```yaml
+tasks:
+  - id: t_8f3k2a
+    title: Revisar pipeline de segmentação
+    status: todo            # todo | done | paused | cancelled
+    target: 2026-06-09
+    tags: [trabalho]
+    migrations: 0           # times pushed to the next day
+    recur: seg              # optional: dia | seg..dom (recurring task)
+```
+## What Leadger deliberately doesn't do
+Sync, cloud, accounts, subtasks, pomodoro, XP, badges, confetti,
+databases. The YAML is the single source of truth.
+## Development
+See `CONTEXT.md` for the full contract (schema, business rules, phases).
+```bash
+pip install -e ".[dev]"
+pytest
+```
+### Frontend (React + Vite + Tailwind)
+```bash
+cd frontend
+npm install
+npm run dev      # hot reload; proxies /api to the backend on 4242
+npm run build    # outputs frontend/dist
+```
+For development, run the backend with `leadger serve --port 4242
+--no-browser` and Vite with `npm run dev`.
+### Release
+```bash
+make dist        # frontend build + embed into src/leadger/static + python -m build
+twine upload dist/*
+```
+Without `make` (PowerShell): `npm run build` in `frontend/`, copy
+`frontend/dist/*` into `src/leadger/static/`, then `python -m build`.
+## License
+[MIT](LICENSE)

leadger-0.1.0.dist-info/RECORD ADDED Viewed

@@ -0,0 +1,23 @@
+leadger/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+leadger/__main__.py,sha256=wLraIrsV87wu981WnRtyPgMaGKgAluEk_KzJlnQN0pM,100
+leadger/cli.py,sha256=V044y671s2JmxxBVmCYc1ROfiQr9Smt4x-3pbBaBJVE,8481
+leadger/server.py,sha256=ickXN_VBu52pLF2NUuE0hMwU1V0RMgZWZxnN-S3C_Nc,8267
+leadger/core/__init__.py,sha256=AjzFV_0cEsu7_u91rEZ-FC5njXfXwIlWiOlkALNiNHU,350
+leadger/core/ics.py,sha256=7bmHvdEyoHUvCQPqGg35FTJl-0a2sN7SaCSTzEIQaoY,2582
+leadger/core/ids.py,sha256=x50ISS2IVUKs920-agl32t4v8lYLK0kVQaS6A0xBsjg,397
+leadger/core/parse.py,sha256=yoHA9-TjJ2xfCv_csoyZLR541POCaeZcPaRSkaiWchg,2763
+leadger/core/periods.py,sha256=fXa-p0khCUmC8HU8o0Xq_2Twd5louV2Cu2jaCnayobQ,1284
+leadger/core/recur.py,sha256=4wIMKY_4WNPVO6TUXXrHMPnnAGUHwL8RpV9FmRaGiH4,1444
+leadger/core/storage.py,sha256=IQ1ybx7yN0TqLfwybVzSiVEPfRfTTkJH_1PdsDohn_Q,13162
+leadger/core/tasks.py,sha256=-WFchiOYq_VeXQ5to2_9pGGgrCvASulM81id0KwtxUM,4791
+leadger/core/time_utils.py,sha256=8ELwpbIROuYrX_heWN1sLTof12VtRtxeKjACctgZgsM,1450
+leadger/core/yaml_io.py,sha256=symdryss54cb12DpSm6bs4H8ruyKmzTkP7xkfQy6t04,3370
+leadger/static/favicon.svg,sha256=FIK862Iqqr_u3lGAwUXzt2Y53pABk6Ars0ERXX8NPQM,270
+leadger/static/index.html,sha256=lt2fqgxSZqZVCXXbMOvh0FquKroQ5QHmCOel5ckvSMk,461
+leadger/static/assets/index-BFMiMAZM.css,sha256=VcIdbvQAF6DOh2986H9p-oSVZDbwaH6U_NntUEnxFgg,23624
+leadger/static/assets/index-PnqahOsL.js,sha256=-YWxZW2VIftwr9rBpoDzoaYIpqh-Th-8m2QdwwKp3XE,234233
+leadger-0.1.0.dist-info/METADATA,sha256=Wj_OKIf6vWrFKzkOQIRFBpysFG52RxikwV4f7Fk0AQs,7499
+leadger-0.1.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+leadger-0.1.0.dist-info/entry_points.txt,sha256=bANhxCrttP4tzwm0_TNGdgBPLJuSam1ZdMc-sOQUOac,44
+leadger-0.1.0.dist-info/licenses/LICENSE,sha256=Wz-v8EWhGBc11qOjP8QBRkDowbYCn_gqZgSJUzMIF8E,1073
+leadger-0.1.0.dist-info/RECORD,,

leadger-0.1.0.dist-info/WHEEL ADDED Viewed

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.30.1
+Root-Is-Purelib: true
+Tag: py3-none-any

leadger-0.1.0.dist-info/entry_points.txt ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ [console_scripts]
2	+ leadger = leadger.cli:app

leadger-0.1.0.dist-info/licenses/LICENSE ADDED Viewed

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