reckn 1.0.0__tar.gz

reckn-1.0.0/LICENSE

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

reckn-1.0.0/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: reckn
+Version: 1.0.0
+Summary: A Soulver-like calculator notepad for the terminal
+Author: David Vignoni
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/davigno/reckn
+Project-URL: Repository, https://github.com/davigno/reckn
+Project-URL: Issues, https://github.com/davigno/reckn/issues
+Keywords: calculator,notepad,terminal,tui,soulver,math,units,currency
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual>=0.40.0
+Requires-Dist: requests>=2.25.0
+Dynamic: license-file
+
+# Reckn
+
+*Pronounced "reckon"*
+
+A Soulver-like calculator notepad for the terminal. Type math expressions on the left, see results on the right - with variables, units, currencies, percentages, dates, and more.
+
+## Install
+
+Requires Python 3.10+.
+
+```bash
+pipx install reckn
+```
+
+That's it. If you don't have pipx: `pip install pipx` or `sudo apt install pipx` (Debian/Ubuntu) or `brew install pipx` (macOS).
+
+Alternatively, with pip:
+
+```bash
+pip install reckn
+```
+
+### Linux Desktop Integration
+
+To add Reckn to your application menu:
+
+```bash
+reckn --install-desktop
+```
+
+### From Source
+
+```bash
+git clone https://github.com/davigno/reckn.git
+cd reckn
+pipx install .
+```
+
+## Usage
+
+```bash
+reckn                  # New empty pad
+reckn mybudget         # Open or create named pad
+reckn --list           # List saved pads
+reckn --version        # Show version
+```
+
+Press `F2` inside the app for a full syntax reference and keyboard shortcuts.
+
+## What Can It Do?
+
+```
+# Monthly Budget
+salary = 5000                    5,000
+tax = 22% of salary                1,100
+rent = 1200 EUR                    €1,200
+rent in USD                        $1,415.28
+---                                5,715.28
+
+# Trip Planning
+distance = 450 km                  450 km
+distance in miles                  279.62 mi
+speed = 100 km/h                   100 km/h
+distance / speed as timespan       4 hr 30 min
+
+# Dates
+today                              25 March 2026
+vacation = June 15                 15 June 2026
+vacation - today                   2 months 21 days
+
+# Time
+meeting = 2:30pm                   2:30 pm
+meeting + 1 hr 45 min              4:15 pm
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `F1` | File menu |
+| `F2` | Help / syntax reference |
+| `Ctrl+N` | New pad |
+| `Ctrl+O` | Open pad |
+| `Ctrl+S` | Save pad |
+| `Ctrl+E` | Export as markdown |
+| `Ctrl+T` | Toggle floating total |
+| `Ctrl+K` | Toggle comment |
+| `Ctrl+X` | Delete line |
+| `Ctrl+C` | Copy result |
+| `Ctrl+Shift+C` | Copy entire pad |
+| `Ctrl+V` | Paste |
+| `Ctrl+Q` | Quit |
+| `Click result` | Insert line reference |
+
+## Syntax Reference
+
+### Arithmetic & Variables
+
+```
+2 + 3 * (10 - 4)            → 20
+2 ^ 10                       → 1,024
+100k + 50k                   → 150,000       (SI: k, M, B, G)
+salary = 60k                 → 60,000        (variable assignment)
+line1 + line2                → (line refs)
+```
+
+### Units & Conversions
+
+Convert with `in`, `to`, or `as`. Compatible units mix automatically.
+
+```
+10 inches in cm              → 25.4 cm
+5 km in miles                → 3.11 mi
+100 degC in degF             → 212 °F
+1000 MB in GB                → 1 GB
+100 km/h in mph              → 62.14 mph
+1 km + 500 m                 → 1,500 m
+500 km / 2 hours             → 250 km/h
+```
+
+**Supported:** length (mm-mi), weight (mg-lb), time (ms-year), data (B-PB, bits), speed, temperature.
+
+### Currencies
+
+Live rates from frankfurter.app, cached locally for offline use.
+
+```
+$100 in EUR                  → €84.79
+100 GBP to USD               → $135.89
+rent = 100 USD               → $100          (unit preserved)
+rent * 12                    → $1,200
+```
+
+### Percentages
+
+```
+25% of 1000                  → 250
+10% off 200                  → 180
+200 + 10%                    → 220
+50 as % of 200               → 25%
+```
+
+### Dates & Clock Time
+
+```
+today                        → 25 March 2026
+today + 3 weeks              → 15 April 2026
+from March 1 to April 1      → 1 month
+7:45am + 9 hours             → 4:45 pm
+3:35pm - 11:00am             → 4 hr 35 min
+5.5 hours as timespan        → 5 hr 30 min
+```
+
+### Structure
+
+```
+# Heading                    (section header, resets subtotals)
+// Comment                   (not evaluated)
+label: 1200                  (display only, no variable)
+var = 1200                   (variable assignment)
+---                          (subtotal)
+===                          (subtotal, alternate style)
+```
+
+## Data Storage
+
+All data in `~/.config/reckn/`:
+
+- `pads/<name>.json` - saved pads
+- `currency_cache.json` - cached exchange rates
+
+## License
+
+MIT

reckn-1.0.0/README.md

@@ -0,0 +1,174 @@
+# Reckn
+
+*Pronounced "reckon"*
+
+A Soulver-like calculator notepad for the terminal. Type math expressions on the left, see results on the right - with variables, units, currencies, percentages, dates, and more.
+
+## Install
+
+Requires Python 3.10+.
+
+```bash
+pipx install reckn
+```
+
+That's it. If you don't have pipx: `pip install pipx` or `sudo apt install pipx` (Debian/Ubuntu) or `brew install pipx` (macOS).
+
+Alternatively, with pip:
+
+```bash
+pip install reckn
+```
+
+### Linux Desktop Integration
+
+To add Reckn to your application menu:
+
+```bash
+reckn --install-desktop
+```
+
+### From Source
+
+```bash
+git clone https://github.com/davigno/reckn.git
+cd reckn
+pipx install .
+```
+
+## Usage
+
+```bash
+reckn                  # New empty pad
+reckn mybudget         # Open or create named pad
+reckn --list           # List saved pads
+reckn --version        # Show version
+```
+
+Press `F2` inside the app for a full syntax reference and keyboard shortcuts.
+
+## What Can It Do?
+
+```
+# Monthly Budget
+salary = 5000                    5,000
+tax = 22% of salary                1,100
+rent = 1200 EUR                    €1,200
+rent in USD                        $1,415.28
+---                                5,715.28
+
+# Trip Planning
+distance = 450 km                  450 km
+distance in miles                  279.62 mi
+speed = 100 km/h                   100 km/h
+distance / speed as timespan       4 hr 30 min
+
+# Dates
+today                              25 March 2026
+vacation = June 15                 15 June 2026
+vacation - today                   2 months 21 days
+
+# Time
+meeting = 2:30pm                   2:30 pm
+meeting + 1 hr 45 min              4:15 pm
+```
+
+## Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `F1` | File menu |
+| `F2` | Help / syntax reference |
+| `Ctrl+N` | New pad |
+| `Ctrl+O` | Open pad |
+| `Ctrl+S` | Save pad |
+| `Ctrl+E` | Export as markdown |
+| `Ctrl+T` | Toggle floating total |
+| `Ctrl+K` | Toggle comment |
+| `Ctrl+X` | Delete line |
+| `Ctrl+C` | Copy result |
+| `Ctrl+Shift+C` | Copy entire pad |
+| `Ctrl+V` | Paste |
+| `Ctrl+Q` | Quit |
+| `Click result` | Insert line reference |
+
+## Syntax Reference
+
+### Arithmetic & Variables
+
+```
+2 + 3 * (10 - 4)            → 20
+2 ^ 10                       → 1,024
+100k + 50k                   → 150,000       (SI: k, M, B, G)
+salary = 60k                 → 60,000        (variable assignment)
+line1 + line2                → (line refs)
+```
+
+### Units & Conversions
+
+Convert with `in`, `to`, or `as`. Compatible units mix automatically.
+
+```
+10 inches in cm              → 25.4 cm
+5 km in miles                → 3.11 mi
+100 degC in degF             → 212 °F
+1000 MB in GB                → 1 GB
+100 km/h in mph              → 62.14 mph
+1 km + 500 m                 → 1,500 m
+500 km / 2 hours             → 250 km/h
+```
+
+**Supported:** length (mm-mi), weight (mg-lb), time (ms-year), data (B-PB, bits), speed, temperature.
+
+### Currencies
+
+Live rates from frankfurter.app, cached locally for offline use.
+
+```
+$100 in EUR                  → €84.79
+100 GBP to USD               → $135.89
+rent = 100 USD               → $100          (unit preserved)
+rent * 12                    → $1,200
+```
+
+### Percentages
+
+```
+25% of 1000                  → 250
+10% off 200                  → 180
+200 + 10%                    → 220
+50 as % of 200               → 25%
+```
+
+### Dates & Clock Time
+
+```
+today                        → 25 March 2026
+today + 3 weeks              → 15 April 2026
+from March 1 to April 1      → 1 month
+7:45am + 9 hours             → 4:45 pm
+3:35pm - 11:00am             → 4 hr 35 min
+5.5 hours as timespan        → 5 hr 30 min
+```
+
+### Structure
+
+```
+# Heading                    (section header, resets subtotals)
+// Comment                   (not evaluated)
+label: 1200                  (display only, no variable)
+var = 1200                   (variable assignment)
+---                          (subtotal)
+===                          (subtotal, alternate style)
+```
+
+## Data Storage
+
+All data in `~/.config/reckn/`:
+
+- `pads/<name>.json` - saved pads
+- `currency_cache.json` - cached exchange rates
+
+## License
+
+MIT

reckn-1.0.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "reckn"
+version = "1.0.0"
+description = "A Soulver-like calculator notepad for the terminal"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    {name = "David Vignoni"}
+]
+keywords = ["calculator", "notepad", "terminal", "tui", "soulver", "math", "units", "currency"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "textual>=0.40.0",
+    "requests>=2.25.0",
+]
+
+[project.scripts]
+reckn = "reckn.__main__:main"
+
+[project.urls]
+Homepage = "https://github.com/davigno/reckn"
+Repository = "https://github.com/davigno/reckn"
+Issues = "https://github.com/davigno/reckn/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["reckn*"]
+
+[tool.setuptools.package-data]
+reckn = ["assets/*.svg"]

reckn-1.0.0/reckn/__init__.py

@@ -0,0 +1,3 @@
+"""Reckn - A Soulver-like calculator notepad for the terminal."""
+
+__version__ = "1.0.0"

reckn-1.0.0/reckn/__main__.py

@@ -0,0 +1,110 @@
+"""Entry point for running Reckn as a module."""
+
+import argparse
+import sys
+
+from . import __version__
+from .pad import list_pads, load_pad, PADS_DIR
+
+
+def install_desktop():
+    """Install desktop entry and icon for Linux desktop integration."""
+    import shutil
+    import subprocess
+    from pathlib import Path
+
+    pkg_dir = Path(__file__).parent
+    icon_src = pkg_dir / "assets" / "reckn.svg"
+
+    if not icon_src.exists():
+        print(f"Error: icon not found at {icon_src}", file=sys.stderr)
+        sys.exit(1)
+
+    # Install icon
+    icon_dir = Path.home() / ".local" / "share" / "icons" / "hicolor" / "scalable" / "apps"
+    icon_dir.mkdir(parents=True, exist_ok=True)
+    shutil.copy2(icon_src, icon_dir / "reckn.svg")
+    print(f"  Icon -> {icon_dir / 'reckn.svg'}")
+
+    # Generate and install .desktop file
+    reckn_exe = shutil.which("reckn") or "reckn"
+    desktop_content = (
+        "[Desktop Entry]\n"
+        "Name=Reckn\n"
+        "Comment=A calculator notepad for the terminal\n"
+        f"Exec={reckn_exe}\n"
+        "Icon=reckn\n"
+        "Terminal=true\n"
+        "Type=Application\n"
+        "Categories=Utility;Calculator;\n"
+        "Keywords=calculator;notepad;math;units;currency;\n"
+    )
+
+    desktop_dir = Path.home() / ".local" / "share" / "applications"
+    desktop_dir.mkdir(parents=True, exist_ok=True)
+    desktop_file = desktop_dir / "reckn.desktop"
+    desktop_file.write_text(desktop_content)
+    print(f"  Desktop entry -> {desktop_file}")
+
+    # Update desktop database (best effort)
+    try:
+        subprocess.run(["update-desktop-database", str(desktop_dir)],
+                       capture_output=True, check=False)
+    except FileNotFoundError:
+        pass
+
+    print("Done. Reckn should now appear in your application menu.")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        prog="reckn",
+        description="Reckn - A calculator notepad for the terminal"
+    )
+    parser.add_argument(
+        "pad_name",
+        nargs="?",
+        help="Name of pad to open"
+    )
+    parser.add_argument(
+        "--version", "-V",
+        action="version",
+        version=f"reckn {__version__}"
+    )
+    parser.add_argument(
+        "--list", "-l",
+        action="store_true",
+        help="List all saved pads"
+    )
+    parser.add_argument(
+        "--install-desktop",
+        action="store_true",
+        help="Install desktop entry and icon (Linux)"
+    )
+
+    args = parser.parse_args()
+
+    if args.install_desktop:
+        install_desktop()
+        return
+
+    if args.list:
+        pads = list_pads()
+        if not pads:
+            print(f"No saved pads found in {PADS_DIR}")
+        else:
+            print(f"Saved pads ({len(pads)}):")
+            for pad in pads:
+                modified = pad.get("modified", "")[:10]  # Just the date part
+                print(f"  {pad['name']:20} {modified}")
+        return
+
+    # Import app here to avoid loading Textual for --list
+    from .app import RecknApp
+
+    app = RecknApp(pad_name=args.pad_name)
+    app.run()
+
+
+if __name__ == "__main__":
+    main()