aeris 0.1.0__tar.gz

aeris-0.1.0/PKG-INFO

@@ -0,0 +1,51 @@
+Metadata-Version: 2.3
+Name: aeris
+Version: 0.1.0
+Summary: Jotting down notes.
+Author: Lucas Maystre
+Author-email: Lucas Maystre <lucas@maystre.ch>
+Requires-Dist: dateparser>=1.4.0
+Requires-Dist: fastapi>=0.136.1
+Requires-Dist: psycopg[binary]>=3.3.3
+Requires-Dist: pydantic>=2.13.3
+Requires-Dist: pydantic-settings>=2.14.0
+Requires-Dist: sqlalchemy>=2.0.49
+Requires-Dist: typer>=0.24.2
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# aeris
+
+A command-line tool for jotting down notes, backed by a PostgreSQL database.
+
+## Installation
+
+```bash
+pip install aeris
+```
+
+## Configuration
+
+Create `~/.aeris.json`:
+
+```json
+{
+  "database_url": "postgresql+psycopg://user:password@localhost/aeris"
+}
+```
+
+Then initialize the database:
+
+```bash
+aeris reset-db
+```
+
+## Usage
+
+```bash
+aeris add                        # open $EDITOR to write a note
+aeris list                       # list recent notes
+aeris list --last "2 hours"      # notes from the last 2 hours
+aeris display [id]               # display note(s) in full
+aeris delete <id>                # delete a note
+```

aeris-0.1.0/README.md

@@ -0,0 +1,35 @@
+# aeris
+
+A command-line tool for jotting down notes, backed by a PostgreSQL database.
+
+## Installation
+
+```bash
+pip install aeris
+```
+
+## Configuration
+
+Create `~/.aeris.json`:
+
+```json
+{
+  "database_url": "postgresql+psycopg://user:password@localhost/aeris"
+}
+```
+
+Then initialize the database:
+
+```bash
+aeris reset-db
+```
+
+## Usage
+
+```bash
+aeris add                        # open $EDITOR to write a note
+aeris list                       # list recent notes
+aeris list --last "2 hours"      # notes from the last 2 hours
+aeris display [id]               # display note(s) in full
+aeris delete <id>                # delete a note
+```

aeris-0.1.0/aeris/cli.py

@@ -0,0 +1,128 @@
+import os
+import subprocess
+import tempfile
+from datetime import datetime
+
+import dateparser
+import typer
+from sqlalchemy.orm import Session
+
+from aeris.database.engine import engine
+from aeris.database.models import Base, Note
+
+app = typer.Typer()
+
+
+@app.callback()
+def main() -> None:
+    pass
+
+
+def _parse_last(value: str) -> datetime:
+    result = dateparser.parse(f"{value} ago", settings={"RETURN_AS_TIMEZONE_AWARE": True})
+    if result is None:
+        typer.echo(f"Could not parse time expression: '{value}'")
+        raise typer.Exit(1)
+    return result
+
+
+@app.command()
+def add() -> None:
+    editor = os.environ.get("EDITOR", "vi")
+    fd, path = tempfile.mkstemp(suffix=".txt")
+    try:
+        os.close(fd)
+        subprocess.run([editor, path], check=True)
+        with open(path) as f:
+            content = f.read().strip()
+    finally:
+        os.unlink(path)
+
+    if not content:
+        typer.echo("Empty note, nothing saved.")
+        raise typer.Exit()
+
+    with Session(engine) as session:
+        session.add(Note(content=content))
+        session.commit()
+
+    typer.echo("Note saved.")
+
+
+@app.command(name="list")
+def list_notes(
+    limit: int = typer.Option(30, "--limit"),
+    last: str | None = typer.Option(None, "--last"),
+) -> None:
+    with Session(engine) as session:
+        query = session.query(Note).order_by(Note.created_at.asc())
+        if last is not None:
+            query = query.filter(Note.created_at >= _parse_last(last))
+        notes = query.limit(limit).all()
+
+    if not notes:
+        return
+
+    id_width = max(len(str(n.id)) for n in notes)
+    for note in notes:
+        content = note.content.replace("\n", " ")
+        if len(content) > 100:
+            content = content[:99] + "…"
+        created = note.created_at.astimezone().strftime("%Y-%m-%d %H:%M:%S")
+        typer.echo(f"{note.id:<{id_width}}  {created}  {content}")
+
+
+@app.command()
+def display(
+    id: int | None = typer.Argument(None),
+    limit: int = typer.Option(30, "--limit"),
+    last: str | None = typer.Option(None, "--last"),
+) -> None:
+    with Session(engine) as session:
+        if id is not None:
+            note = session.get(Note, id)
+            if note is None:
+                typer.echo(f"No note with id {id}.")
+                raise typer.Exit(1)
+            notes = [note]
+        else:
+            query = session.query(Note).order_by(Note.created_at.asc())
+            if last is not None:
+                query = query.filter(Note.created_at >= _parse_last(last))
+            notes = query.limit(limit).all()
+
+    for i, note in enumerate(notes):
+        created = note.created_at.astimezone().strftime("%Y-%m-%d %H:%M:%S")
+        typer.echo(f"# {note.id} {created}")
+        typer.echo("")
+        typer.echo(note.content.rstrip())
+        if i < len(notes) - 1:
+            typer.echo("")
+            typer.echo("")
+
+
+@app.command()
+def delete(id: int) -> None:
+    with Session(engine) as session:
+        note = session.get(Note, id)
+        if note is None:
+            typer.echo(f"No note with id {id}.")
+            raise typer.Exit(1)
+        session.delete(note)
+        session.commit()
+    typer.echo("Deleted.")
+
+
+@app.command(name="reset-db")
+def reset_db() -> None:
+    confirm = typer.prompt("Type 'reset' to confirm")
+    if confirm != "reset":
+        typer.echo("Aborted.")
+        raise typer.Exit()
+    Base.metadata.drop_all(engine)
+    Base.metadata.create_all(engine)
+    typer.echo("Done.")
+
+
+if __name__ == "__main__":
+    app()

aeris-0.1.0/aeris/config.py

@@ -0,0 +1,31 @@
+from pathlib import Path
+
+from pydantic_settings import (
+    BaseSettings,
+    JsonConfigSettingsSource,
+    PydanticBaseSettingsSource,
+    SettingsConfigDict,
+)
+
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(
+        json_file=Path.home() / ".aeris.json",
+        extra="forbid",
+    )
+
+    database_url: str
+
+    @classmethod
+    def settings_customise_sources(
+        cls,
+        settings_cls: type[BaseSettings],
+        init_settings: PydanticBaseSettingsSource,
+        env_settings: PydanticBaseSettingsSource,
+        dotenv_settings: PydanticBaseSettingsSource,
+        file_secret_settings: PydanticBaseSettingsSource,
+    ) -> tuple[PydanticBaseSettingsSource, ...]:
+        return (JsonConfigSettingsSource(settings_cls),)
+
+
+settings = Settings()  # type: ignore[call-arg]  # fields are populated from ~/.aeris.json

aeris-0.1.0/aeris/database/engine.py

@@ -0,0 +1,10 @@
+from sqlalchemy import create_engine
+
+from aeris.config import settings
+from aeris.database.models import Base
+
+engine = create_engine(settings.database_url)
+
+
+def create_tables() -> None:
+    Base.metadata.create_all(engine)

aeris-0.1.0/aeris/database/models.py

@@ -0,0 +1,19 @@
+from datetime import datetime
+
+from sqlalchemy import DateTime, Text, func
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class Note(Base):
+    __tablename__ = "note"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    created_at: Mapped[datetime] = mapped_column(DateTime(timezone=True), server_default=func.now())
+    updated_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), server_default=func.now(), onupdate=func.now()
+    )
+    content: Mapped[str] = mapped_column(Text)

aeris-0.1.0/aeris/web/AGENTS.md

@@ -0,0 +1,7 @@
+This web app uses:
+
+- FastAPI
+- htmx (v2)
+- Tailwind CSS (v4) 
+
+Pay attention to the versions that are used.

aeris-0.1.0/pyproject.toml

@@ -0,0 +1,62 @@
+[project]
+name = "aeris"
+version = "0.1.0"
+description = "Jotting down notes."
+authors = [
+    {name = "Lucas Maystre", email = "lucas@maystre.ch"},
+]
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "dateparser>=1.4.0",
+    "fastapi>=0.136.1",
+    "psycopg[binary]>=3.3.3",
+    "pydantic>=2.13.3",
+    "pydantic-settings>=2.14.0",
+    "sqlalchemy>=2.0.49",
+    "typer>=0.24.2",
+]
+
+[dependency-groups]
+dev = [
+    "pyright>=1.1.402",
+    "ruff>=0.11.13",
+]
+
+[project.scripts]
+aeris = "aeris.cli:app"
+
+[build-system]
+requires = ["uv_build>=0.11.7,<0.12"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "aeris"
+module-root = ""
+
+[tool.ruff]
+line-length = 100  # Default is 88.
+
+[tool.ruff.format]
+line-ending = "lf"  # Default is "auto".
+
+[tool.ruff.lint]
+extend-select = ["W", "I"]  # Adds warnings & imports.
+
+[tool.pyright]
+deprecateTypingAliases = true
+reportDuplicateImport = true
+reportFunctionMemberAccess = "error"
+reportImportCycles = "error"
+reportIncompatibleMethodOverride = "error"
+reportInvalidStringEscapeSequence = "error"
+reportMatchNotExhaustive = "error"
+reportMissingImports = "error"
+reportPropertyTypeMismatch = "error"
+reportUnknownMemberType = false
+reportUnknownVariableType = false
+reportUntypedBaseClass = "error"
+strictDictionaryInference = true
+strictListInference = true
+strictSetInference = true
+reportMissingParameterType = true