twd-m4sc0 3.1.0__py3-none-any.whl → 3.1.1__py3-none-any.whl

twd/__init__.py

@@ -1,6 +1 @@
-from importlib.metadata import version, PackageNotFoundError
-
-try:
-    __version__ = version("twd")
-except PackageNotFoundError as e:
-    __version__ = "unknown"
+__version__ = "3.1.1"

twd/cli.py

@@ -8,7 +8,7 @@ from .tui import TWDApp
 
 @click.group(invoke_without_command=True)
 @click.pass_context
-@click.version_option(version=__version__)
+@click.version_option(version=__version__, prog_name="twd")
 def cli(ctx):
     """
     TWD - Temp / Tracked Working Directory
@@ -39,7 +39,18 @@ def cli(ctx):
 @click.pass_context
 def save(ctx, path, alias, name):
     """
-    Save a new twd with PATH, [opt] ALIAS and [opt] NAME
+    Save a new TWD with an Alias (UUID like) and Name
+
+    Examples:
+
+        twd save ./Movies movies Media
+
+        twd save / root "Root Directory -- /dev/sda3"
+
+        twd save . finances-q1 "Finance Documents Q1"
+
+    The naming conventions for the alias align with kebab-casing.
+    There are no naming conventions for the name.
     """
     manager: TwdManager = ctx.obj['manager']
 
@@ -61,7 +72,13 @@ def save(ctx, path, alias, name):
 @click.pass_context
 def get(ctx, alias):
     """
-    get path for ALIAS
+    cd into a directory by the given Alias
+
+    Examples:
+
+        twd get movies
+
+    There's really not much to it.
     """
     manager = ctx.obj['manager']
 
@@ -81,7 +98,13 @@ def get(ctx, alias):
 @click.pass_context
 def remove(ctx, alias):
     """
-    remove TWD by ALIAS
+    Remove TWD by the given Alias
+
+    Examples:
+
+        twd remove movies
+
+    That's it.
     """
     manager = ctx.obj['manager']
     
@@ -95,7 +118,9 @@ def remove(ctx, alias):
 @cli.command('list')
 @click.pass_context
 def list_twds(ctx):
-    """List all TWDs"""
+    """
+    List all TWDs
+    """
     manager = ctx.obj['manager']
     
     entries = manager.list_all()
@@ -118,7 +143,10 @@ def list_twds(ctx):
 @click.pass_context
 def clean(ctx, yes):
     """
-    clean twds from invalid paths
+    Clean the records of rogue TWDs
+
+    Sometimes it's possible that TWDs are not properly cleaned up.
+    That's what this subcommand does.
     """
     manager = ctx.obj['manager']
 

twd/data.py

@@ -15,6 +15,17 @@ class Entry(BaseModel):
     name: str = Field(..., min_length=3)
     created_at: datetime = Field(default_factory=datetime.now)
 
+    def __eq__(self, other) -> bool:
+        """Compare entries based on their values"""
+        if not isinstance(other, Entry):
+            return NotImplemented
+
+        return (
+                self.alias == other.alias
+                and self.path == other.path
+                and self.name == other.name
+                )
+
     @validator("alias")
     def validate_alias(cls, v):
         if not v.replace("_", "").replace("-", "").isalnum():
@@ -47,6 +58,16 @@ class Entry(BaseModel):
                 created_at=datetime.fromisoformat(row[3])
                 )
 
+    @classmethod
+    def from_values(cls, alias, path, name, created_at) -> "Entry":
+        """create from values"""
+        return cls(
+                alias=alias,
+                path=path,
+                name=name,
+                created_at=created_at
+                )
+
 class TwdManager:
     """twd entry manager stored in csv"""
 
@@ -115,6 +136,16 @@ class TwdManager:
 
         return None
 
+    def update(self, alias: str, entry: Entry) -> bool:
+        """update TWD by alias"""
+        if not self.exists(alias):
+            return False
+
+        # simplest form of update is remove and add
+        self.remove(alias)
+
+        self.add(entry.alias, entry.path, entry.name)
+
     def remove(self, alias: str) -> None:
         """remove entry by alias"""
         entries = self._read_all()

twd/modals/__init__.py

@@ -0,0 +1,4 @@
+from twd.modals.confirm import ConfirmModal, EntryDeleteModal
+from twd.modals.edit import EditEntryModal
+
+__all__ = ["ConfirmModal", "EntryDeleteModal", "EditEntryModal"]

twd/{modals.py → modals/confirm.py}

@@ -3,11 +3,13 @@ from textual.app import ComposeResult
 from textual.screen import ModalScreen
 from textual.containers import Container, Horizontal
 from textual.widgets import Button, Label
-from typing import Union
+from typing import Union, TypeVar, Generic
 
 from twd.data import Entry
 
-class ConfirmModal(ModalScreen[bool]):
+T = TypeVar('T')
+
+class ConfirmModal(ModalScreen[T], Generic[T]):
     """A confirm modal"""
 
     DEFAULT_CSS = """
@@ -42,7 +44,9 @@ class ConfirmModal(ModalScreen[bool]):
             self, 
             message: Union[str, None] = None,
             confirm_text: str = "Yes",
-            cancel_text: str = "No"
+            cancel_text: str = "No",
+            confirm_value: T | None = None,
+            cancel_value: T | None = None,
     ):
         """
         message: The message to display when popping the modal
@@ -53,6 +57,9 @@ class ConfirmModal(ModalScreen[bool]):
         self.confirm_text = confirm_text
         self.cancel_text = cancel_text
 
+        self.confirm_value = confirm_value
+        self.cancel_value = cancel_value
+
         super().__init__()
 
     def compose_content(self) -> ComposeResult:
@@ -68,18 +75,16 @@ class ConfirmModal(ModalScreen[bool]):
         with Container():
             yield from self.compose_content()
             with Horizontal():
-                yield Button(self.cancel_text, id="no", variant="error")
-                yield Button(self.confirm_text, id="yes", variant="success")
-
-    @on(Button.Pressed, "#no")
-    def no_decision(self) -> None:
-        """decision no"""
-        self.dismiss(False)
-
-    @on(Button.Pressed, "#yes")
-    def yes_decision(self) -> None:
-        """decision yes"""
-        self.dismiss(True)
+                yield Button(self.cancel_text, id="cancel", variant="error")
+                yield Button(self.confirm_text, id="confirm", variant="success")
+
+    @on(Button.Pressed, "#cancel")
+    def cancel_pressed(self) -> None:
+        self.dismiss(self.cancel_value)
+
+    @on(Button.Pressed, "#confirm")
+    def confirm_pressed(self) -> None:
+        self.dismiss(self.confirm_value)
 
 class EntryDeleteModal(ConfirmModal):
     """Confirmation modal with detailed entry information"""

twd/modals/edit.py

@@ -0,0 +1,52 @@
+from textual import on
+from textual.app import ComposeResult
+from textual.containers import Container, Horizontal
+from textual.widgets import Button, Label, Input
+
+from twd.data import Entry
+from twd.modals import ConfirmModal
+
+class EditEntryModal(ConfirmModal[Entry | None]):
+    """A modal to edit an existing entry"""
+
+    DEFAULT_CSS = """
+        Label {
+            width: 100%;
+            text-align: left;
+        }
+        Input {
+            margin: 1;
+        }
+    """
+
+    def __init__(self, entry):
+        """
+        entry: the entry to edit
+        """
+        self.entry = Entry.from_values(entry.alias, entry.path, entry.name, entry.created_at)
+
+        super().__init__(
+                confirm_text="Save",
+                cancel_text="Discard",
+                confirm_value=self.entry,
+                )
+
+    def compose_content(self) -> ComposeResult:
+        yield Label(f"Edit Entry", id="title")
+
+        yield Label("Alias")
+        yield Input(value=self.entry.alias, id="alias", disabled=True)
+        yield Label("Path")
+        yield Input(value=str(self.entry.path), id="path")
+        yield Label("Name")
+        yield Input(value=self.entry.name, id="name")
+    
+    @on(Input.Changed, "#path")
+    def on_path_change(self, event: Input.Changed) -> None:
+        self.entry.path = event.value
+    
+    @on(Input.Changed, "#name")
+    def on_name_change(self, event: Input.Changed) -> None:
+        self.entry.name = event.value
+
+        

twd/tui.py

@@ -8,9 +8,9 @@ from textual.widgets import Button, Digits, Footer, Header, DataTable, Label, Ru
 from textual.color import Color
 
 from twd.config import Config
-from twd.data import TwdManager
+from twd.data import TwdManager, Entry
 from twd.utils import fuzzy_search, linear_search
-from twd.modals import ConfirmModal, EntryDeleteModal
+from twd.modals import ConfirmModal, EntryDeleteModal, EditEntryModal
 
 class Mode(Enum):
     NORMAL = "normal"
@@ -29,9 +29,10 @@ class TWDApp(App):
             Binding("k", "cursor_up", "Up"),
 
             # modify
-            Binding("/", "enter_search_mode", "Search"),
-            Binding("d", "delete_entry", "Delete"),
-            Binding("escape", "enter_normal_mode", "Normal", show=False),
+            Binding("/", "slash_key", "Search"),
+            Binding("d", "d_key", "Delete"),
+            Binding("e", "e_key", "Edit"),
+            Binding("escape", "escape_key", "Normal", show=False),
             # TODO: edit
             # TODO: rename
 
@@ -43,6 +44,7 @@ class TWDApp(App):
         ]
 
     mode: Mode = reactive(Mode.NORMAL)
+    search_results = None
 
     def __init__(self, manager: TwdManager, *args, **kwargs):
         self.manager = manager
@@ -98,6 +100,19 @@ class TWDApp(App):
         for entry in entries:
             table.add_row(entry.alias, str(entry.path), entry.name, entry.created_at.strftime("%Y-%m-%d %H:%M:%S"))
 
+    def _current_row_entry(self) -> Entry:
+        table = self.query_one(DataTable)
+
+        # get row
+        row_key = table.coordinate_to_cell_key(table.cursor_coordinate).row_key
+        row_data = table.get_row(row_key)
+        alias = row_data[0]
+
+        # get entry
+        entry = self.manager.get(alias)
+
+        return entry
+
     def watch_mode(self, old_mode: Mode, new_mode: Mode) -> None:
         """
         react to mode changes
@@ -153,7 +168,7 @@ class TWDApp(App):
 
         table.move_cursor(row=prev_row)
 
-    def action_enter_search_mode(self) -> None:
+    def action_slash_key(self) -> None:
         """
         enter search mode
         """
@@ -161,30 +176,25 @@ class TWDApp(App):
             return
         self.mode = Mode.SEARCH
 
-    def action_enter_normal_mode(self) -> None:
+    def action_escape_key(self) -> None:
         """
         enter normal mode
         """
         if self.mode == Mode.NORMAL:
+            if self.search_results is not None:
+                self._populate_table()
+                self.search_results = None
             return
         self.mode = Mode.NORMAL
 
-    def action_delete_entry(self) -> None:
+    def action_d_key(self) -> None:
         """
         open confirm modal and delete entry if yes
         """
         if not self.mode == Mode.NORMAL:
             return
 
-        table = self.query_one(DataTable)
-
-        # get row
-        row_key = table.coordinate_to_cell_key(table.cursor_coordinate).row_key
-        row_data = table.get_row(row_key)
-        alias = row_data[0]
-
-        # get entry
-        entry = self.manager.get(alias)
+        entry = self._current_row_entry()
 
         def check_delete(decision: bool | None) -> None:
             """
@@ -199,9 +209,29 @@ class TWDApp(App):
 
             self.notify(f"Removed entry \"{entry.name}\"")
 
-        # self.push_screen(ConfirmModal(message=f"Are you sure want to delete '{entry.alias}'?"), check_delete)
         self.push_screen(EntryDeleteModal(entry), check_delete)
 
+    def action_e_key(self) -> None:
+        """
+        open edit modal and edit entry in place
+        """
+        entry = self._current_row_entry()
+
+        def save_new_entry(new_entry: Entry | None) -> None:
+            if not new_entry or entry == new_entry:
+                # user hit 'Discard'
+                # no changes so no update
+                self.notify(f"No changes")
+                return
+
+            self.notify(f"Updated TWD '{new_entry.alias}'")
+
+            self.manager.update(new_entry.alias, new_entry)
+            self.manager._write_all(self.manager._read_all())
+            self._populate_table()
+
+        self.push_screen(EditEntryModal(entry), save_new_entry)
+
     def action_exit(self) -> None:
         self.exit()
 
@@ -228,6 +258,7 @@ class TWDApp(App):
         filtered = [item[0] for item in search_result]
 
         self._populate_table(filtered)
+        self.search_results = filtered
 
     @on(Input.Submitted, "#search-input")
     def on_search_submitted(self, e: Input.Submitted) -> None:
@@ -238,6 +269,7 @@ class TWDApp(App):
             return
 
         self.mode = Mode.NORMAL
+        self._populate_table(self.search_results)
 
         self.query_one(DataTable).focus()
 
@@ -250,12 +282,7 @@ class TWDApp(App):
         table = event.data_table
         row_key = event.row_key
 
-        # get row
-        row_data = table.get_row(row_key)
-        alias = row_data[0]
-
-        # get entry
-        entry = self.manager.get(alias)
+        entry = self._current_row_entry()
 
         self.notify(f"Selected: {entry.alias} -> {entry.path}")
 

{twd_m4sc0-3.1.0.dist-info → twd_m4sc0-3.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: twd-m4sc0
-Version: 3.1.0
+Version: 3.1.1
 Summary: TWD by m4sc0
 Author: m4sc0
 License: MIT

twd_m4sc0-3.1.1.dist-info/RECORD

@@ -0,0 +1,15 @@
+twd/__init__.py,sha256=14eImCCNxRh4pWMIfkKe4h5OCS1ICfRjHSj2AfgEXa0,22
+twd/cli.py,sha256=jRdFB741czlkGn9bUrUy4cV9B6iae-87vJpTCcKp04Y,4824
+twd/config.py,sha256=pGAaurguz1Bv6NxjwKbLBbvJ9tuAVJx_l7tcvd0B84I,1996
+twd/data.py,sha256=_Wn4aoJsYyFmrjtuzOou2x70YH4ZuJrGnIdflzjIttc,4756
+twd/tui.py,sha256=X8HWrtvru8nigKx61aMemQ-elJM8UrUZdhjTXMZBdF0,8253
+twd/tui.tcss,sha256=GVEtk-fUcAaaGP3I-VjTFUzZocPAEcASDCBNGVoUBWw,778
+twd/utils.py,sha256=xsMa69vAotpNMd3Vp5_F7ELwZCwT-sd45taN7PRI9pE,1201
+twd/modals/__init__.py,sha256=PE3zZ9RrWABlvjoBRnpbbNj8t7xXy24mqLeW3uVv7Yg,171
+twd/modals/confirm.py,sha256=QOEnV6OYzt95ZWrTd4lTULfWd1bl52aotZWu4uBovsk,2814
+twd/modals/edit.py,sha256=c7Mr5cNeq5XR6EdHCzbWi32ruCPHXDNIZPgEv8cYtj4,1475
+twd_m4sc0-3.1.1.dist-info/METADATA,sha256=BYD3Mv8S298thP3dzitSMEr2FdPtFHw5PkRLsjQapI0,437
+twd_m4sc0-3.1.1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+twd_m4sc0-3.1.1.dist-info/entry_points.txt,sha256=KeIDpaQx0GSqgJFYql14wmT3yj_JHTwq7rRsm-mKckc,36
+twd_m4sc0-3.1.1.dist-info/top_level.txt,sha256=B93Li7fIZ4uWoKq8rKVuGPU_MtzyjxxDb0NF96oGZ0o,4
+twd_m4sc0-3.1.1.dist-info/RECORD,,

{twd_m4sc0-3.1.0.dist-info → twd_m4sc0-3.1.1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

twd_m4sc0-3.1.0.dist-info/RECORD

@@ -1,13 +0,0 @@
-twd/__init__.py,sha256=76brvw44gXGskDSsajfwk5rvxoRjk4PT99d4qGUs_64,162
-twd/cli.py,sha256=m1Buh3_pDg4Yej-3v2cRlB2m-1jz55cLnPx63TJgb4s,4247
-twd/config.py,sha256=pGAaurguz1Bv6NxjwKbLBbvJ9tuAVJx_l7tcvd0B84I,1996
-twd/data.py,sha256=8GmBk5VOfmvJJa16H2jywi06_0wRNYjjkseqgM17Hdk,3861
-twd/modals.py,sha256=NWeOu87DlVxYERUqKfulxRXlb1Bs1BYxs_Q8tih-WZM,2601
-twd/tui.py,sha256=XksMYTDgOL5sZg4Cn0LjnNVYvOkgKHsUlve1KZZNmyo,7403
-twd/tui.tcss,sha256=GVEtk-fUcAaaGP3I-VjTFUzZocPAEcASDCBNGVoUBWw,778
-twd/utils.py,sha256=xsMa69vAotpNMd3Vp5_F7ELwZCwT-sd45taN7PRI9pE,1201
-twd_m4sc0-3.1.0.dist-info/METADATA,sha256=ZzuIkcbhHTraVKyx3u_aNymjTYxQv8Fl577mjuiozpE,437
-twd_m4sc0-3.1.0.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-twd_m4sc0-3.1.0.dist-info/entry_points.txt,sha256=KeIDpaQx0GSqgJFYql14wmT3yj_JHTwq7rRsm-mKckc,36
-twd_m4sc0-3.1.0.dist-info/top_level.txt,sha256=B93Li7fIZ4uWoKq8rKVuGPU_MtzyjxxDb0NF96oGZ0o,4
-twd_m4sc0-3.1.0.dist-info/RECORD,,