dockerpal 0.0.16__py3-none-any.whl

dockerpal/__init__.py

@@ -0,0 +1,2 @@
+
+__version__ = '0.0.16'

dockerpal/__main__.py

@@ -0,0 +1,6 @@
+
+from dockerpal.cli import main
+
+
+if __name__ == '__main__':
+    main()

dockerpal/app.py

@@ -0,0 +1,113 @@
+from textual.app import App, ComposeResult
+from textual.containers import Grid
+from textual.widgets import DataTable, Footer, Header, Static, Label, Button, TextArea, ListView, ListItem
+from textual.color import Color
+from textual.theme import Theme
+from textual import events
+from textual.screen import Screen, ModalScreen
+from textual._context import active_app
+from textual.reactive import reactive
+from textual.containers import Horizontal, VerticalGroup, Vertical, VerticalScroll, Container
+from textual.binding import Binding
+from textual import on, work
+from time import monotonic
+from rich.text import Text
+from rich.style import Style
+
+import docker
+
+from dockerpal.fsm import ScreenFSM, SplashScreen
+
+
+arctic_theme = Theme(
+    name="arctic",
+    primary="#88C0D0",
+    secondary="#81A1C1",
+    accent="#B48EAD",
+    foreground="#D8DEE9",
+    background="#2E3440",
+    success="#A3BE8C",
+    warning="#EBCB8B",
+    error="#BF616A",
+    surface="#3B4252",
+    panel="#434C5E",
+    dark=True,
+    variables={
+        "block-cursor-text-style": "none",
+        "footer-key-foreground": "#88C0D0",
+        "input-selection-background": "#81a1c1 35%",
+    },
+)
+
+
+class DockerPalApp(App):
+    CSS = """
+    DataTable {
+        # margin-bottom: 1;  /* Leave space for footer */
+    }
+    
+    #table-footer {
+        dock: bottom;
+        height: 2;
+        background: $panel;
+        # border-top: solid $primary;
+        # padding: 0 1;
+        align: center middle;
+    }
+
+    #table-footer Label {
+        margin-right: 2;
+    }
+
+    #sidebar {
+        margin-top: 1;
+        dock: left;
+        width: 15;
+        height: 100%;
+        # color: #0f2b41;
+        display: none;
+        # background: dodgerblue;
+    }
+
+    #initializing-label,#not-implemented-label {
+        column-span: 2;
+        height: 1fr;
+        width: 1fr;
+        content-align: center middle;
+    }    
+    """
+
+    def __init__(self):
+        super().__init__()
+        active_app.set(self)
+
+        cli = docker.from_env()
+        self.__fsm = ScreenFSM(cli)
+
+
+    def on_key(self, event: events.Key):
+        match event.key:
+            case 'q':
+                self.exit()
+
+        self.__fsm.on_state_key(event)
+
+
+    async def on_mount(self):
+        self.title = 'DockerPal'
+        self.register_theme(arctic_theme)
+        self.theme = 'arctic'
+        self.push_screen(SplashScreen())
+
+        # loop = asyncio.get_running_loop()
+        # images_list =  await loop.run_in_executor(None, lambda: self.__docker_cli.images.list())
+        self.__fsm.set_images_screen()
+
+
+    def action_toggle_dark(self):
+        self.theme = "textual-dark" if self.theme == "textual-light" else "textual-light"    
+
+
+def app():
+    app = DockerPalApp()
+    app.run()

dockerpal/cli.py

@@ -0,0 +1,22 @@
+
+from dockerpal.app import app
+
+from argparse import ArgumentParser, RawDescriptionHelpFormatter
+import sys
+
+
+def cli(args=sys.argv[1:]):
+    parser = ArgumentParser(description='dockerpal description goes here')
+    parser.add_argument('--change-me', default='An option sample', required=False, 
+        help='Just an option sample of your cli to be substituted by real ones')
+
+    return parser.parse_args(args)
+
+
+def main():
+    args = cli()
+    app()
+
+
+if __name__ == '__main__':
+    main()

dockerpal/fsm.py

@@ -0,0 +1,463 @@
+import docker
+from textual.containers import Grid
+from textual.widgets import DataTable, Footer, Header, Label, Button, TextArea, ListView, ListItem
+from textual import events
+from textual.screen import Screen, ModalScreen
+from textual._context import active_app
+from textual.containers import Horizontal
+from textual.binding import Binding
+from textual.css.query import NoMatches
+from time import monotonic
+from rich.text import Text
+from rich.style import Style
+
+import json
+
+
+def compose_sidebar():
+    with ListView(id='sidebar'):
+        yield ListItem(Label('Images'), id='images-sidebar-item')
+        yield ListItem(Label('Containers'), id='containers-sidebar-item')
+        yield ListItem(Label('Networks'), id='networks-sidebar-item')
+        yield ListItem(Label('Volumens'), id='volumens-sidebar-item')
+
+
+class ScreenStateBase:
+    def __init__(self, ctx):
+        super().__init__()
+        self.__ctx = ctx
+
+    def on_state_key(self, event: events.Key):
+        pass
+
+    def on_state_enter(self, data=None):
+        pass
+
+    def on_state_exit(self):
+        pass
+
+    def render(self):
+        pass
+
+    def context(self):
+        return self.__ctx
+
+
+class ScreenFSM:
+    def __init__(self, docker_cli):
+        self.__state = None
+        self.__docker_cli = docker_cli
+
+
+    def set_images_screen(self, images_list=None):
+        self.set_state(ImagesScreen(self, self.__docker_cli))
+
+
+    def set_image_details_screen(self, image):
+        self.set_state(ImageDetailsScreen(self, image))
+
+
+    def set_state(self, state, data=None):
+        if self.__state is not None:
+            self.__state.on_state_exit()
+        self.__state = state
+        self.__state.on_state_enter(data)
+
+
+    def state(self):
+        return self.__state
+    
+
+    def compose(self):
+        return self.__state.compose()
+
+
+    def on_state_key(self, event: events.Key):
+        try:
+            self.__state.on_state_key(event)
+        except NoMatches:
+            # Workaround when textual tray is open
+            pass
+        except Exception as e:
+            self.notify(str(e), severity='error')
+
+
+    def send_event(self, event):
+        self.__event_bus.publish(event)
+
+    
+    def set_subtitle(self, subtitle):
+        self.__app().sub_title = subtitle
+
+
+    def switch_screen(self, screen):
+        self.__app().switch_screen(screen)
+    
+
+    def notify(self, message, severity='information'):
+        self.__app().notify(message, severity=severity)
+
+
+    def toggle_sidebar(self):
+        app = self.__app()
+        sidebar = app.get_child_by_id('sidebar')
+        if sidebar.styles.display == 'none':
+            sidebar.styles.display = 'block'
+            if sidebar.can_focus:
+                sidebar.focus()
+        else:
+            sidebar.styles.display = 'none'
+
+        return sidebar.styles.display == 'block'
+
+
+    def is_sidebar_visible(self):
+        app = self.__app()
+        sidebar = app.get_child_by_id('sidebar')
+        return sidebar.styles.display != 'none'
+
+
+    def exit(self):
+        self.__app().exit()
+
+
+    def app(self):
+        return self.__app()
+
+
+    def __app(self):
+        return active_app.get()
+
+
+class ImagesScreen(Screen, ScreenStateBase):
+    current_row = None
+    SELECTED_SYMBOL = '[✓]'
+
+    BINDINGS = [
+        Binding("d,delete", "delete", "Delete"),
+        Binding("r", "refresh", "Refresh"),
+        Binding("space", "select_row", "Select row"),
+        # Binding("enter", "image_details", "Details"),
+        Binding("+", "select_all", "Select all"),
+        Binding("-", "deselect_all", "Deselect all"),
+        Binding("*", "invert_selection", "Invert selection"),
+        Binding("s", "sidebar", "Sidebar"),
+        Binding("q,escape", "exit", "Exit"),
+        Binding("j", "down", "Down", show=False),
+        Binding("k", "up", "Up", show=False),
+        Binding("f", "page_down", "Page down", show=False),
+        Binding("b", "page_up", "Page up", show=False),
+        Binding("g", "go_up", "Go up (double press)", show=False),
+        Binding("G", "go_down", "Go down", show=False),
+    ]
+
+    def __init__(self, ctx, docker_cli, images_list=None):
+        Screen.__init__(self, id='images-screen')
+        ScreenStateBase.__init__(self, ctx)
+        self.__cli = docker_cli
+        table = DataTable(id='images-table', cursor_type='row', zebra_stripes=False)
+        table.add_column(label='Short ID')
+        table.add_column('Tags')
+        self.__double_press = dict()
+        self.__table = table
+        self.__num_space_pad = 0
+        self.__selected_rows = set()
+        self.__total_label = Label()
+        self.__selected_label = Label()
+        self.renew(images_list)
+
+
+    def renew(self, images_list=None):
+        def tag(image):
+            return ', '.join(image.tags) if image.tags else '<None>'
+
+        def short_id(image):
+            return image.short_id.split(':')[1]
+
+        def full_id(image):
+            return image.id.split(':')[1]
+
+        images = self.__cli.images.list() if images_list is None else images_list
+        table = self.__table
+        table.clear()
+        pad = self.__num_space_pad = len(str(len(images))) + len(self.SELECTED_SYMBOL) + 2
+        {table.add_row(short_id(image), tag(image), key=full_id(image), label=f'{i: <{pad}}'): image for i, image in enumerate(images, 1)}
+        self.__update_footer()
+
+
+    def compose(self):
+        yield from compose_sidebar()
+        yield Header(name='Images')
+        yield self.__table
+        # yield Horizontal(self.__total_label, self.__selected_label, id='table-footer')
+        with Horizontal(id="table-footer"):
+            yield self.__total_label
+            yield self.__selected_label
+        yield Footer()
+
+
+    def on_state_enter(self, data=None):
+        self.context().set_subtitle('Images')
+        self.context().switch_screen(self)
+        if ImagesScreen.current_row is not None:
+            self.__set_cursor_row(ImagesScreen.current_row)
+
+
+    def on_state_key(self, event: events.Key):
+        table = self.__table
+        context = self.context()
+        match event.key:
+            case 'escape' | 'q':
+                context.exit()
+            case 'enter':
+                if context.is_sidebar_visible():
+                     sidebar = context.app().get_child_by_id('sidebar')
+                     match sidebar.highlighted_child.id:
+                        case 'images-sidebar-item':
+                            pass
+                        case 'containers-sidebar-item':
+                            context.notify('Not implemented yet.', severity='warning')
+                        case 'networks-sidebar-item':
+                            context.notify('Not implemented yet.', severity='warning')
+                        case 'volumens-sidebar-item':
+                            context.notify('Not implemented yet.', severity='warning')
+                     
+                else:
+                    ImagesScreen.current_row = table.cursor_row
+                    context.set_image_details_screen(self.__get_row_image(table.cursor_row))
+
+    
+    def action_select_all(self):
+        table = self.__table
+        sel_rows = self.__selected_rows
+        sel_rows.clear()
+        for i in range(len(table.rows)):
+            self.__toggle_row_sel(i, move_cursor=False)
+        self.__update_selected_label()
+
+
+    def action_deselect_all(self):
+        table = self.__table
+        self.__selected_rows = {i for i in range(len(table.rows))}
+        for i in range(len(table.rows)):
+            self.__toggle_row_sel(i, move_cursor=False)
+        self.__update_selected_label()
+
+
+    def action_invert_selection(self):
+        table = self.__table
+        for i in range(len(table.rows)):
+            self.__toggle_row_sel(i, move_cursor=False)
+        self.__update_selected_label()
+
+
+    def action_select_row(self):
+        self.__toggle_row_sel()
+        self.__update_selected_label()
+
+
+    def action_down(self):
+        self.__table.action_cursor_down()
+
+   
+    def action_up(self):
+        self.__table.action_cursor_up()
+
+
+    def action_page_down(self):
+        self.__table.action_page_down()
+
+
+    def action_page_up(self):
+        self.__table.action_page_up()
+
+
+    def action_go_up(self):
+        table = self.__table
+        dp = self.__double_press
+        before = dp.get('g')
+        if before is None:
+            dp['g'] = monotonic()
+            return
+        
+        now = monotonic()
+        if now - dp.get('g') < 0.2:
+            table.action_scroll_top()
+            dp.pop('g', None)
+            return
+        
+        dp['g'] = now
+
+
+    def action_go_down(self):
+        self.__table.action_scroll_bottom()
+
+
+    def action_delete(self):
+        def remove_image(row_index):
+            rows = tuple(table.rows.items())
+            row_key, _ = rows[row_index]
+            self.__cli.images.remove(row_key.value)
+
+        table = self.__table
+        sel_rows = self.__selected_rows
+        cursor_row = table.cursor_row
+        try:
+            if not sel_rows:
+                remove_image(cursor_row)
+            else:
+                for i in sel_rows:
+                    remove_image(i)
+                sel_rows.clear()
+        except docker.errors.APIError as e:
+            self.context().notify(e.explanation, severity='error')
+        else:
+            self.renew()
+            self.__set_cursor_row(cursor_row)
+            self.__update_selected_label()
+
+
+    def action_refresh(self):
+        self.renew()
+
+
+    def action_sidebar(self):
+        self.context().toggle_sidebar()
+
+
+    def on_mount(self):
+        self.get_child_by_id('images-table').focus()
+
+
+    def __set_cursor_row(self, row_index):
+        table = self.__table
+        if table.row_count > row_index:
+            table.move_cursor(row=row_index)
+        elif table.row_count > 0:
+            table.move_cursor(row=table.row_count - 1)
+
+    
+    def __update_footer(self):
+        self.__total_label.update(f'Total: {len(self.__cli.images.list())}')
+        self.__selected_label.update(f'Selected: {len(self.__selected_rows)}')
+
+
+    def __update_selected_label(self):
+        self.__selected_label.update(f'Selected: {len(self.__selected_rows)}')
+
+
+    def __toggle_row_sel(self, cursor_row=None, move_cursor=True):
+        if cursor_row is None:
+            cursor_row = self.__table.cursor_row
+
+        table = self.__table
+        rows = tuple(table.rows.items())
+        row_key, row = rows[cursor_row]
+        col_key, _ = next(iter(table.columns.items()))
+        
+        sel_rows = self.__selected_rows
+        if cursor_row in sel_rows:
+            sel_rows.remove(cursor_row)
+            row.label = Text(f'{cursor_row + 1: <{self.__num_space_pad}}')
+        else:
+            sel_rows.add(cursor_row)
+            row.label.style = Style(color='#FA8072')
+            row.label.set_length(len(self.SELECTED_SYMBOL))
+            row.label.append('[✓]')
+        
+        cell_val = table.get_cell(row_key, col_key)
+        table.update_cell(row_key, col_key, cell_val, update_width=True)
+        if move_cursor:
+            table.action_cursor_down()
+
+    
+    def __get_row_image(self, row_index):
+        rows = tuple(self.__table.rows.items())
+        row_key, _ = rows[row_index]
+        return self.__cli.images.get(row_key.value)
+
+
+class ImageDetailsScreen(Screen, ScreenStateBase):
+    BINDINGS = [
+        Binding("escape", "exit", "Go back"),
+    ]
+
+    def __init__(self, ctx, image):
+        Screen.__init__(self, id='image-details-screen')
+        ScreenStateBase.__init__(self, ctx)
+        self.__image = image
+
+
+    def on_mount(self):
+        self.get_child_by_id('image-details').focus()
+
+
+    def on_state_enter(self, data=None):
+        if data is not None:
+            self.__image = data
+
+        self.context().set_subtitle('Image details')
+        self.context().switch_screen(self)
+
+
+    def compose(self):
+        try:        
+            yield from compose_sidebar()
+            yield Header()
+            yield Footer()
+            details = json.dumps(self.__image.attrs, indent=4)
+            yield TextArea(details, read_only=True, language='json', id='image-details')
+        except json.JSONDecodeError as e:
+            yield TextArea(f'Unable to parse image details: {e}', read_only=True, language='html', id='image-details')
+            self.context().notify(f'Unable to parse image details: {e}', severity='error')
+        except Exception as e:
+            yield TextArea(f'Unable to parse image details: {e}', read_only=True, language='html', id='image-details')
+            self.context().notify(str(e), severity='error')
+
+
+    def on_state_key(self, event: events.Key):
+        context = self.context()
+        match event.key:
+            case 'enter':
+                sidebar = context.app().get_child_by_id('sidebar')
+                match sidebar.highlighted_child.id:
+                    case 'images-sidebar-item':
+                        pass
+                    case 'containers-sidebar-item':
+                        context.notify('Not implemented yet.', severity='warning')
+                    case 'networks-sidebar-item':
+                        context.notify('Not implemented yet.', severity='warning')
+                    case 'volumens-sidebar-item':
+                        context.notify('Not implemented yet.', severity='warning')
+            case 'escape':
+                context.set_images_screen()
+            case 's':
+                context.toggle_sidebar()
+
+
+class SplashScreen(Screen):
+    def compose(self):
+        yield Grid(Label("Initializing...", id='initializing-label'), id="splash-screen")
+
+
+class NotImplementedScreen(Screen):
+    def compose(self):
+        yield Grid(Label("Not Implemented", id='not-implemented-label'), id="not-implemented-screen")
+
+
+class QuitScreen(ModalScreen):
+    """Screen with a dialog to quit."""
+
+    def compose(self):
+        yield Grid(
+            Label("Are you sure you want to quit?", id="question"),
+            Button("Quit", variant="error", id="quit"),
+            Button("Cancel", variant="primary", id="cancel"),
+            id="dialog",
+        )
+
+    def on_button_pressed(self, event: Button.Pressed) -> None:
+        if event.button.id == "quit":
+            self.app.exit()
+        else:
+            self.app.pop_screen()

dockerpal-0.0.16.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: dockerpal
+Version: 0.0.16
+Summary: Docker images cleaner and inspector tui app
+Home-page: https://github.com/yell0w4x/dockerpal
+Author: yell0w4x
+Author-email: yell0w4x@gmail.com
+License: MIT
+Project-URL: Bug Tracker, https://github.com/yell0w4x/dockerpal/issues
+Keywords: docker images cleaner inspector tui
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: certifi==2025.11.12
+Requires-Dist: charset-normalizer==3.4.4
+Requires-Dist: docker==7.1.0
+Requires-Dist: idna==3.11
+Requires-Dist: linkify-it-py==2.0.3
+Requires-Dist: markdown-it-py==4.0.0
+Requires-Dist: mdit-py-plugins==0.5.0
+Requires-Dist: mdurl==0.1.2
+Requires-Dist: platformdirs==4.5.1
+Requires-Dist: Pygments==2.19.2
+Requires-Dist: requests==2.32.5
+Requires-Dist: rich==14.2.0
+Requires-Dist: textual==6.12.0
+Requires-Dist: tree-sitter==0.25.2
+Requires-Dist: tree-sitter-bash==0.25.1
+Requires-Dist: tree-sitter-css==0.25.0
+Requires-Dist: tree-sitter-go==0.25.0
+Requires-Dist: tree-sitter-html==0.23.2
+Requires-Dist: tree-sitter-java==0.23.5
+Requires-Dist: tree-sitter-javascript==0.25.0
+Requires-Dist: tree-sitter-json==0.24.8
+Requires-Dist: tree-sitter-markdown==0.5.1
+Requires-Dist: tree-sitter-python==0.25.0
+Requires-Dist: tree-sitter-regex==0.25.0
+Requires-Dist: tree-sitter-rust==0.24.0
+Requires-Dist: tree-sitter-sql==0.3.11
+Requires-Dist: tree-sitter-toml==0.7.0
+Requires-Dist: tree-sitter-xml==0.7.0
+Requires-Dist: tree-sitter-yaml==0.7.2
+Requires-Dist: typing_extensions==4.15.0
+Requires-Dist: uc-micro-py==1.0.3
+Requires-Dist: urllib3==2.6.2
+Dynamic: license-file
+
+
+# Dockerpal
+
+![dockerpal](https://github.com/yell0w4x/assets/raw/main/dockerpal.png)
+
+```
+pip -m venv .venv
+source .venv/bin/activate
+pip install dockerpal
+dockerpal
+```
+
+Please note it's not even prealpha version.

dockerpal-0.0.16.dist-info/RECORD

@@ -0,0 +1,11 @@
+dockerpal/__init__.py,sha256=SEQmiS4ERzY67zW7H5L_Ea3qxmqoIOM_4seLSg90V0w,24
+dockerpal/__main__.py,sha256=0i65Yn6gXl6J-SMz6MUzAQ-bE1f3uzkCRENCVAy31Zg,72
+dockerpal/app.py,sha256=idNE77YepG7X16mRSXyTG-4TIRYKJV_38MTAuLphums,2748
+dockerpal/cli.py,sha256=Afzfa1vPYhI4ujVScaRltcg8tdY6dWynz5pmukRWzH0,495
+dockerpal/fsm.py,sha256=Mr3FSTcJlR5t2k_-fREXWv24O5Zd2smnyr5jOjkJVSk,14283
+dockerpal-0.0.16.dist-info/licenses/LICENSE,sha256=AmSIUu2oeurr3OgAepMDlmWip4IgS3qLkcybiElB-2c,1024
+dockerpal-0.0.16.dist-info/METADATA,sha256=8iwPgAiC9_1HpJTdQ_bFLa3AkWHPmXAcdUvPVXW5bXg,1928
+dockerpal-0.0.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+dockerpal-0.0.16.dist-info/entry_points.txt,sha256=joDG6au8Z6tmRjrRIB26oY8P6LxVibvdxD3mu9Z2a-E,49
+dockerpal-0.0.16.dist-info/top_level.txt,sha256=uV2VV8NjnavIHVyQDRJlgbK9jNAdhtAcl14YrFCOPlY,10
+dockerpal-0.0.16.dist-info/RECORD,,

dockerpal-0.0.16.dist-info/WHEEL

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

dockerpal-0.0.16.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+dockerpal = dockerpal.cli:main

dockerpal-0.0.16.dist-info/licenses/LICENSE

@@ -0,0 +1,6 @@
+
+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.

dockerpal-0.0.16.dist-info/top_level.txt

@@ -0,0 +1 @@
+dockerpal