arty-mc 0.1.0__tar.gz

arty_mc-0.1.0/LICENSE

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

arty_mc-0.1.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+recursive-include arty_mc *.py
+recursive-include media *.png

arty_mc-0.1.0/PKG-INFO

@@ -0,0 +1,304 @@
+Metadata-Version: 2.4
+Name: arty-mc
+Version: 0.1.0
+Summary: Dual-pane terminal file manager for Artifactory
+Home-page: https://github.com/tino-waldner/arty-mc
+Author: Tino Waldner
+Author-email: tino.waldner@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: textual
+Requires-Dist: requests
+Requires-Dist: dohq-artifactory
+Requires-Dist: pyyaml
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# arty-mc
+
+![Python](https://img.shields.io/badge/python-3.9+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Platform](https://img.shields.io/badge/platform-linux-lightgrey.svg)
+![Status](https://img.shields.io/badge/status-experimental-orange.svg)
+
+```text
+         o                      o                            o          o             
+        <|>                    <|>                          <|\        /|>            
+        / \                    < >                          / \\o    o// \            
+      o/   \o       \o__ __o    |       o      o            \o/ v\  /v \o/      __o__ 
+     <|__ __|>       |     |>   o__/_  <|>    <|>  _\__o__   |   <\/>   |      />  \  
+     /       \      / \   < >   |      < >    < >       \   / \        / \   o/       
+   o/         \o    \o/         |       \o    o/            \o/        \o/  <|        
+  /v           v\    |          o        v\  /v              |          |    \\       
+ />             <\  / \         <\__      <\/>              / \        / \    _\o__</ 
+                                           /                                          
+                                          o                                           
+                                       __/>                                           
+
+```
+
+**arty-mc** is a **Python package** providing a terminal file manager for JFrog Artifactory.
+
+It provides a **dual-pane interface similar to Midnight Commander**, allowing you to **browse, filter, copy and delete** files and folders between **the local filesystem and Artifactory repositories** directly from the terminal.
+
+It uses **Textual** for the terminal interface and **dohq-artifactory** for interacting with Artifactory repositories.
+
+---
+
+# Why arty-mc?
+
+Managing artifacts in Artifactory is often done through the web UI, generic tools like `curl` or the `jf-cli`.
+For developers who prefer working directly in the terminal, this can be inconvenient.
+
+---
+
+# Features
+
+* Dual-pane terminal interface
+* Browse/Filer local filesystem and Artifactory repositories
+* Copy files between panes
+* Delete artifacts
+* Simple YAML configuration
+
+---
+
+# Screenshot
+![arty-mc_screenshot](/media/arty-mc1.png)
+
+---
+
+# Requirements
+
+* Python **3.9+**
+* Access to an **Artifactory server**
+* Artifactory **API token**
+
+---
+
+# Installation
+
+## 1. Clone the Repository
+
+```bash
+git clone https://github.com/tino-waldner/arty-mc.git
+cd arty-mc
+```
+
+---
+
+## 2. Python Package
+
+```bash
+mkdir .venv
+python3 -m venv .venv
+source .venv/bin/activate
+pip install .
+```
+
+---
+
+## 3. Create Configuration File
+
+Create a configuration file in your home directory:
+
+```text
+~/.arty-mc.yml
+```
+
+Example configuration:
+
+```yaml
+server: https://artifactory.company.com/artifactory
+user: myuser
+token: ********************************************
+```
+
+### Configuration Fields
+
+| Field  | Description                        |
+| ------ | ---------------------------------- |
+| server | Base URL of the Artifactory server |
+| user   | Artifactory username               |
+| token  | Artifactory API token              |
+
+---
+
+# Running arty-mc
+
+Run the tool directly:
+
+```bash
+python -m arty_mc <repository>
+```
+
+Example:
+
+```bash
+python -m arty_mc libs-release-local
+```
+
+This starts the **dual-pane interface** where you can browse your local filesystem and the selected repository.
+
+---
+
+# Typical Workflow
+
+1. Start **arty-mc** with a repository
+2. Navigate the **local filesystem** in one pane
+3. Browse the **Artifactory repository** in the other pane
+4. Copy files between panes
+5. Delete artifacts if needed
+
+⚠ **Warning:** Deleting artifacts from repositories may be irreversible.
+
+---
+
+# Keyboard Shortcuts
+
+| Key   | Action           |
+| ----- | ---------------- |
+| ↑ ↓   | Navigate         |
+| Enter | Open directory   |
+| Tab   | Switch pane      |
+| F2    | Cancel Operation |
+| F5    | Copy             |
+| F8    | Delete           |
+| F10   | Quit             |
+
+---
+
+# Building an Executable with Pyinstaller
+
+You can build a binary using **PyInstaller**.
+
+Install PyInstaller:
+
+```bash
+pip install pyinstaller
+```
+
+Build the binary:
+
+**-—onefile:** slower startup caused by runtime extraction
+
+```bash
+pyinstaller --onefile --distpath dist --name arty-mc arty_mc/arty_mc.py
+```
+**-—onedir:** faster after initial startup
+
+```bash
+pyinstaller --onedir --distpath dist --name arty-mc arty_mc/arty_mc.py
+```
+
+The compiled executable will appear in:
+
+```text
+dist/arty-mc/
+```
+
+You can run it without a Python environment.
+
+---
+
+# Packaging and uploading the arty-mc Python library
+
+You can also build this python package
+
+```bash
+git clone https://github.com/tino-waldner/arty-mc.git
+cd arty-mc
+mkdir .venv
+python3 -m venv .venv
+source .venv/bin/activate
+pip install build twine
+python -m build
+twine check dist/*
+twine upload dist/*
+```
+
+---
+
+# Building an Executable with Pyinstaller
+
+```bash
+mkdir .venv
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+Install PyInstaller:
+
+```bash
+pip install pyinstaller
+```
+
+Build the binary:
+
+**-—onefile:** slower startup caused by runtime extraction
+
+```bash
+pyinstaller --onefile --distpath dist --name arty-mc arty_mc/arty_mc.py
+```
+**-—onedir:** faster after initial startup
+
+```bash
+pyinstaller --onedir --distpath dist --name arty-mc arty_mc/arty_mc.py
+```
+
+The compiled executable will appear in:
+
+```text
+arty_mc/dist/arty-mc/
+```
+
+You can run it without a Python environment.
+
+---
+
+# Security Notes
+
+* Do **not** commit your `.arty-mc.yml` file
+* Protect your **API token**
+* Prefer **API tokens instead of passwords**
+
+---
+
+# Demo
+
+[![Demo Cast](https://asciinema.org/a/WHdbkcCi2WBvoTrX.svg)](https://asciinema.org/a/WHdbkcCi2WBvoTrX)
+
+---
+
+# Disclaimer
+
+This software is provided **"as is" without warranty of any kind**.
+
+The tool may contain **bugs or incomplete functionality** and should be used **at your own risk**.
+The author assumes **no responsibility or liability for any damage, data loss, system malfunction, or unintended modifications** caused by the use of this software.
+
+Always verify actions such as **uploading, deleting, or overwriting artifacts**, especially when working with production repositories.
+
+This project is **not affiliated with or endorsed by JFrog**.
+
+JFrog and Artifactory are trademarks of JFrog Ltd.
+
+---
+
+# License
+
+MIT License
+

arty_mc-0.1.0/README.md

@@ -0,0 +1,274 @@
+# arty-mc
+
+![Python](https://img.shields.io/badge/python-3.9+-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Platform](https://img.shields.io/badge/platform-linux-lightgrey.svg)
+![Status](https://img.shields.io/badge/status-experimental-orange.svg)
+
+```text
+         o                      o                            o          o             
+        <|>                    <|>                          <|\        /|>            
+        / \                    < >                          / \\o    o// \            
+      o/   \o       \o__ __o    |       o      o            \o/ v\  /v \o/      __o__ 
+     <|__ __|>       |     |>   o__/_  <|>    <|>  _\__o__   |   <\/>   |      />  \  
+     /       \      / \   < >   |      < >    < >       \   / \        / \   o/       
+   o/         \o    \o/         |       \o    o/            \o/        \o/  <|        
+  /v           v\    |          o        v\  /v              |          |    \\       
+ />             <\  / \         <\__      <\/>              / \        / \    _\o__</ 
+                                           /                                          
+                                          o                                           
+                                       __/>                                           
+
+```
+
+**arty-mc** is a **Python package** providing a terminal file manager for JFrog Artifactory.
+
+It provides a **dual-pane interface similar to Midnight Commander**, allowing you to **browse, filter, copy and delete** files and folders between **the local filesystem and Artifactory repositories** directly from the terminal.
+
+It uses **Textual** for the terminal interface and **dohq-artifactory** for interacting with Artifactory repositories.
+
+---
+
+# Why arty-mc?
+
+Managing artifacts in Artifactory is often done through the web UI, generic tools like `curl` or the `jf-cli`.
+For developers who prefer working directly in the terminal, this can be inconvenient.
+
+---
+
+# Features
+
+* Dual-pane terminal interface
+* Browse/Filer local filesystem and Artifactory repositories
+* Copy files between panes
+* Delete artifacts
+* Simple YAML configuration
+
+---
+
+# Screenshot
+![arty-mc_screenshot](/media/arty-mc1.png)
+
+---
+
+# Requirements
+
+* Python **3.9+**
+* Access to an **Artifactory server**
+* Artifactory **API token**
+
+---
+
+# Installation
+
+## 1. Clone the Repository
+
+```bash
+git clone https://github.com/tino-waldner/arty-mc.git
+cd arty-mc
+```
+
+---
+
+## 2. Python Package
+
+```bash
+mkdir .venv
+python3 -m venv .venv
+source .venv/bin/activate
+pip install .
+```
+
+---
+
+## 3. Create Configuration File
+
+Create a configuration file in your home directory:
+
+```text
+~/.arty-mc.yml
+```
+
+Example configuration:
+
+```yaml
+server: https://artifactory.company.com/artifactory
+user: myuser
+token: ********************************************
+```
+
+### Configuration Fields
+
+| Field  | Description                        |
+| ------ | ---------------------------------- |
+| server | Base URL of the Artifactory server |
+| user   | Artifactory username               |
+| token  | Artifactory API token              |
+
+---
+
+# Running arty-mc
+
+Run the tool directly:
+
+```bash
+python -m arty_mc <repository>
+```
+
+Example:
+
+```bash
+python -m arty_mc libs-release-local
+```
+
+This starts the **dual-pane interface** where you can browse your local filesystem and the selected repository.
+
+---
+
+# Typical Workflow
+
+1. Start **arty-mc** with a repository
+2. Navigate the **local filesystem** in one pane
+3. Browse the **Artifactory repository** in the other pane
+4. Copy files between panes
+5. Delete artifacts if needed
+
+⚠ **Warning:** Deleting artifacts from repositories may be irreversible.
+
+---
+
+# Keyboard Shortcuts
+
+| Key   | Action           |
+| ----- | ---------------- |
+| ↑ ↓   | Navigate         |
+| Enter | Open directory   |
+| Tab   | Switch pane      |
+| F2    | Cancel Operation |
+| F5    | Copy             |
+| F8    | Delete           |
+| F10   | Quit             |
+
+---
+
+# Building an Executable with Pyinstaller
+
+You can build a binary using **PyInstaller**.
+
+Install PyInstaller:
+
+```bash
+pip install pyinstaller
+```
+
+Build the binary:
+
+**-—onefile:** slower startup caused by runtime extraction
+
+```bash
+pyinstaller --onefile --distpath dist --name arty-mc arty_mc/arty_mc.py
+```
+**-—onedir:** faster after initial startup
+
+```bash
+pyinstaller --onedir --distpath dist --name arty-mc arty_mc/arty_mc.py
+```
+
+The compiled executable will appear in:
+
+```text
+dist/arty-mc/
+```
+
+You can run it without a Python environment.
+
+---
+
+# Packaging and uploading the arty-mc Python library
+
+You can also build this python package
+
+```bash
+git clone https://github.com/tino-waldner/arty-mc.git
+cd arty-mc
+mkdir .venv
+python3 -m venv .venv
+source .venv/bin/activate
+pip install build twine
+python -m build
+twine check dist/*
+twine upload dist/*
+```
+
+---
+
+# Building an Executable with Pyinstaller
+
+```bash
+mkdir .venv
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+```
+Install PyInstaller:
+
+```bash
+pip install pyinstaller
+```
+
+Build the binary:
+
+**-—onefile:** slower startup caused by runtime extraction
+
+```bash
+pyinstaller --onefile --distpath dist --name arty-mc arty_mc/arty_mc.py
+```
+**-—onedir:** faster after initial startup
+
+```bash
+pyinstaller --onedir --distpath dist --name arty-mc arty_mc/arty_mc.py
+```
+
+The compiled executable will appear in:
+
+```text
+arty_mc/dist/arty-mc/
+```
+
+You can run it without a Python environment.
+
+---
+
+# Security Notes
+
+* Do **not** commit your `.arty-mc.yml` file
+* Protect your **API token**
+* Prefer **API tokens instead of passwords**
+
+---
+
+# Demo
+
+[![Demo Cast](https://asciinema.org/a/WHdbkcCi2WBvoTrX.svg)](https://asciinema.org/a/WHdbkcCi2WBvoTrX)
+
+---
+
+# Disclaimer
+
+This software is provided **"as is" without warranty of any kind**.
+
+The tool may contain **bugs or incomplete functionality** and should be used **at your own risk**.
+The author assumes **no responsibility or liability for any damage, data loss, system malfunction, or unintended modifications** caused by the use of this software.
+
+Always verify actions such as **uploading, deleting, or overwriting artifacts**, especially when working with production repositories.
+
+This project is **not affiliated with or endorsed by JFrog**.
+
+JFrog and Artifactory are trademarks of JFrog Ltd.
+
+---
+
+# License
+
+MIT License
+

arty_mc-0.1.0/arty_mc/__init__.py

@@ -0,0 +1,3 @@
+from .arty_mc import main
+
+__all__ = ["main"]

arty_mc-0.1.0/arty_mc/__main__.py

@@ -0,0 +1,4 @@
+from .arty_mc import main
+
+if __name__ == "__main__":
+    main()

arty_mc-0.1.0/arty_mc/arty_mc.py

@@ -0,0 +1,40 @@
+import sys
+
+from textual.app import App  # type: ignore
+
+from arty_mc.config import load_config
+from arty_mc.ui.commander_screen import CommanderScreen
+
+
+class ArtyMc(App):
+    TITLE = "Arty-Mc"
+
+    def __init__(self, repo):
+        super().__init__()
+        self.repo = repo
+
+    def on_mount(self):
+        config = load_config()
+        config["default_repo"] = self.repo
+        self.push_screen(CommanderScreen(config))
+
+
+def print_usage():
+    print("Usage:")
+    print("     arty-mc <repository>")
+    print("Options:")
+    print("     --help        Show this help message")
+
+
+def main():
+    if len(sys.argv) < 2 or sys.argv[1] in ("-h", "--help"):
+        print_usage()
+        sys.exit(0)
+
+    repo = sys.argv[1]
+    app = ArtyMc(repo)
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

arty_mc-0.1.0/arty_mc/auth.py

@@ -0,0 +1,18 @@
+import requests  # type: ignore
+
+
+class AuthSession:
+    def __init__(self, base, user, token):
+        self.base = base.rstrip("/")
+        self.session = requests.Session()
+        self.session.auth = (user, token)
+
+    def get(self, url):
+        r = self.session.get(self.base + url)
+        r.raise_for_status()
+        return r.json()
+
+    def post(self, url, data):
+        r = self.session.post(self.base + url, data=data)
+        r.raise_for_status()
+        return r.json()

arty_mc-0.1.0/arty_mc/config.py

@@ -0,0 +1,42 @@
+import re
+from pathlib import Path
+
+import yaml  # type: ignore
+
+DEFAULT_CONFIG = {
+    "server": None,
+    "user": None,
+    "token": None,
+}
+
+
+def is_valid_url(url: str) -> bool:
+    pattern = re.compile(
+        r"^(https?://)"
+        r"(([a-zA-Z0-9.-]+)|"
+        r"(\d{1,3}(\.\d{1,3}){3}))"
+        r"(:\d+)?"
+        r"(/.*)?$"
+    )
+    return bool(pattern.match(url))
+
+
+def load_config():
+    path = Path.home() / ".arty-mc.yml"
+
+    if not path.exists():
+        raise RuntimeError("Config file missing: ~/.arty-mc.yml")
+
+    with open(path) as f:
+        data = yaml.safe_load(f)
+
+    cfg = {**DEFAULT_CONFIG, **data}
+
+    server = cfg.get("server")
+    if not server:
+        raise RuntimeError("Config error: 'server' not defined")
+
+    if not is_valid_url(server):
+        raise RuntimeError(f"Config error: server '{server}' is not a valid URL.")
+
+    return cfg