ssh-to-code 1.0.0__tar.gz → 1.0.2__tar.gz

{ssh_to_code-1.0.0 → ssh_to_code-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-to-code
-Version: 1.0.0
+Version: 1.0.2
 Summary: Terminal-based SSH directory browser with VS Code integration
 Author-email: Rajesh <rajesh-cs18@users.noreply.github.com>
 License-Expression: MIT
@@ -33,7 +33,7 @@ Dynamic: license-file
 
 # SSH Directory Browser
 
-A terminal-based directory browser that lets you SSH into a remote server, navigate through directories interactively, and open selected directories directly in VS Code using the Remote-SSH extension.
+A terminal-based directory browser that lets you SSH into a remote server, navigate through directories interactively, and open selected directories or `.code-workspace` files directly in VS Code using the Remote-SSH extension.
 
 ![Terminal UI](https://img.shields.io/badge/Terminal-Based-blue)
 ![Python](https://img.shields.io/badge/Python-3.7+-green)
@@ -46,6 +46,7 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
 - 🔐 **Secure SSH Connection** - Support for key-based and password authentication
 - 📂 **Visual File Browser** - Clear indicators for directories, files, executables, and symlinks
 - 💻 **VS Code Integration** - Open any remote directory directly in VS Code with one keystroke
+- 🧩 **Workspace File Support** - Open remote `.code-workspace` files directly in VS Code
 - ⚙️ **Configuration Management** - Save frequently used SSH hosts for quick access
 - 🎨 **Keyboard Navigation** - Fast and efficient navigation using arrow keys
 
@@ -57,14 +58,42 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
 
 ## Installation
 
-### 1. Clone the repository
+### 1. Install from PyPI (recommended)
+
+```bash
+pip install ssh-to-code
+```
+
+### 2. Linux/Ubuntu (recommended): install with pipx
+
+Ubuntu and other modern Debian-based systems may block global `pip` installs with PEP 668 (`externally-managed-environment`).
+For CLI tools like `ssh-to-code`, `pipx` is the safest option:
+
+```bash
+sudo apt update
+sudo apt install -y pipx
+pipx ensurepath
+
+# Restart terminal, then:
+pipx install ssh-to-code
+ssh-browse --help
+```
+
+### 3. Verify CLI installation
+
+```bash
+ssh-browse --help
+```
+
+### 4. (Optional) Install from source for development
 
 ```bash
 git clone <repository-url>
 cd ssh-to-code
+pip install -e .
 ```
 
-### 2. Install Python dependencies
+### 5. (Source install only) Install dependencies manually
 
 ```bash
 pip install paramiko
@@ -76,13 +105,13 @@ Or use the provided requirements file:
 pip install -r requirements.txt
 ```
 
-### 3. Make the script executable
+### 6. (Source install only) Make the script executable
 
 ```bash
 chmod +x ssh_dir_browser.py
 ```
 
-### 4. (Optional) Add to PATH
+### 7. (Optional, source install only) Add to PATH
 
 For easy access from anywhere:
 
@@ -101,42 +130,41 @@ sudo ln -s /path/to/ssh-to-code/ssh_dir_browser.py /usr/local/bin/ssh-browse
 Connect to a remote server and start browsing:
 
 ```bash
-# Option 1: Use the wrapper script (automatically activates venv)
-./ssh-browse user@hostname
+# Installed from PyPI or pip install -e .
+ssh-browse user@hostname
 
-# Option 2: Activate venv manually
-source venv/bin/activate
+# If running directly from source without install:
 python ssh_dir_browser.py user@hostname
 ```
 
 ### With Custom Port
 
 ```bash
-./ssh-browse user@hostname -p 2222
+ssh-browse user@hostname -p 2222
 ```
 
 ### With SSH Key
 
 ```bash
-./ssh-browse user@hostname -i ~/.ssh/my_key
+ssh-browse user@hostname -i ~/.ssh/my_key
 ```
 
 ### Start in Specific Directory
 
 ```bash
-./ssh-browse user@hostname --start-path /var/www
+ssh-browse user@hostname --start-path /var/www
 ```
 
 ### Password Authentication
 
 ```bash
-./ssh-browse user@hostname --password
+ssh-browse user@hostname --password
 ```
 
 ### AWS EC2 Example
 
 ```bash
-./ssh-browse ubuntu@ec2-12-34-56-78.compute.amazonaws.com -i ~/Downloads/aws-key.pem
+ssh-browse ubuntu@ec2-12-34-56-78.compute.amazonaws.com -i ~/Downloads/aws-key.pem
 ```
 
 ## Usage
@@ -147,7 +175,7 @@ python ssh_dir_browser.py user@hostname
 |-----|--------|
 | `↑` / `↓` | Navigate up/down |
 | `Enter` | Open directory |
-| `o` | Open current directory in VS Code |
+| `o` | Open current directory, or selected `.code-workspace` file, in VS Code |
 | `n` | Create new folder |
 | `h` | Go to home directory |
 | `r` | Refresh directory listing |
@@ -160,14 +188,15 @@ python ssh_dir_browser.py user@hostname
 3. Select `..` to go to parent directory
 4. Press `n` to create a new folder in the current directory
 5. Press `r` to refresh the directory contents
-6. Press `o` when you want to open the current directory in VS Code
+6. Press `o` to open the current directory in VS Code
+7. Select a `.code-workspace` file and press `o` to open that workspace in VS Code
 
 ### VS Code Integration
 
 When you press `o`, the application will:
 1. Open VS Code
 2. Connect to the remote server via Remote-SSH
-3. Open the selected directory
+3. Open the current directory, or the selected `.code-workspace` file
 4. Exit the browser
 
 Make sure you have:
@@ -311,7 +340,17 @@ Install it from VS Code:
 Install the required dependency:
 
 ```bash
-pip install paramiko
+pip install ssh-to-code
+```
+
+### Externally Managed Environment (Ubuntu/Debian)
+
+If you see `externally-managed-environment`, use `pipx` instead of system `pip`:
+
+```bash
+sudo apt install -y pipx
+pipx ensurepath
+pipx install ssh-to-code
 ```
 
 ## Advanced Features

{ssh_to_code-1.0.0 → ssh_to_code-1.0.2}/README.md

@@ -1,6 +1,6 @@
 # SSH Directory Browser
 
-A terminal-based directory browser that lets you SSH into a remote server, navigate through directories interactively, and open selected directories directly in VS Code using the Remote-SSH extension.
+A terminal-based directory browser that lets you SSH into a remote server, navigate through directories interactively, and open selected directories or `.code-workspace` files directly in VS Code using the Remote-SSH extension.
 
 ![Terminal UI](https://img.shields.io/badge/Terminal-Based-blue)
 ![Python](https://img.shields.io/badge/Python-3.7+-green)
@@ -13,6 +13,7 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
 - 🔐 **Secure SSH Connection** - Support for key-based and password authentication
 - 📂 **Visual File Browser** - Clear indicators for directories, files, executables, and symlinks
 - 💻 **VS Code Integration** - Open any remote directory directly in VS Code with one keystroke
+- 🧩 **Workspace File Support** - Open remote `.code-workspace` files directly in VS Code
 - ⚙️ **Configuration Management** - Save frequently used SSH hosts for quick access
 - 🎨 **Keyboard Navigation** - Fast and efficient navigation using arrow keys
 
@@ -24,14 +25,42 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
 
 ## Installation
 
-### 1. Clone the repository
+### 1. Install from PyPI (recommended)
+
+```bash
+pip install ssh-to-code
+```
+
+### 2. Linux/Ubuntu (recommended): install with pipx
+
+Ubuntu and other modern Debian-based systems may block global `pip` installs with PEP 668 (`externally-managed-environment`).
+For CLI tools like `ssh-to-code`, `pipx` is the safest option:
+
+```bash
+sudo apt update
+sudo apt install -y pipx
+pipx ensurepath
+
+# Restart terminal, then:
+pipx install ssh-to-code
+ssh-browse --help
+```
+
+### 3. Verify CLI installation
+
+```bash
+ssh-browse --help
+```
+
+### 4. (Optional) Install from source for development
 
 ```bash
 git clone <repository-url>
 cd ssh-to-code
+pip install -e .
 ```
 
-### 2. Install Python dependencies
+### 5. (Source install only) Install dependencies manually
 
 ```bash
 pip install paramiko
@@ -43,13 +72,13 @@ Or use the provided requirements file:
 pip install -r requirements.txt
 ```
 
-### 3. Make the script executable
+### 6. (Source install only) Make the script executable
 
 ```bash
 chmod +x ssh_dir_browser.py
 ```
 
-### 4. (Optional) Add to PATH
+### 7. (Optional, source install only) Add to PATH
 
 For easy access from anywhere:
 
@@ -68,42 +97,41 @@ sudo ln -s /path/to/ssh-to-code/ssh_dir_browser.py /usr/local/bin/ssh-browse
 Connect to a remote server and start browsing:
 
 ```bash
-# Option 1: Use the wrapper script (automatically activates venv)
-./ssh-browse user@hostname
+# Installed from PyPI or pip install -e .
+ssh-browse user@hostname
 
-# Option 2: Activate venv manually
-source venv/bin/activate
+# If running directly from source without install:
 python ssh_dir_browser.py user@hostname
 ```
 
 ### With Custom Port
 
 ```bash
-./ssh-browse user@hostname -p 2222
+ssh-browse user@hostname -p 2222
 ```
 
 ### With SSH Key
 
 ```bash
-./ssh-browse user@hostname -i ~/.ssh/my_key
+ssh-browse user@hostname -i ~/.ssh/my_key
 ```
 
 ### Start in Specific Directory
 
 ```bash
-./ssh-browse user@hostname --start-path /var/www
+ssh-browse user@hostname --start-path /var/www
 ```
 
 ### Password Authentication
 
 ```bash
-./ssh-browse user@hostname --password
+ssh-browse user@hostname --password
 ```
 
 ### AWS EC2 Example
 
 ```bash
-./ssh-browse ubuntu@ec2-12-34-56-78.compute.amazonaws.com -i ~/Downloads/aws-key.pem
+ssh-browse ubuntu@ec2-12-34-56-78.compute.amazonaws.com -i ~/Downloads/aws-key.pem
 ```
 
 ## Usage
@@ -114,7 +142,7 @@ python ssh_dir_browser.py user@hostname
 |-----|--------|
 | `↑` / `↓` | Navigate up/down |
 | `Enter` | Open directory |
-| `o` | Open current directory in VS Code |
+| `o` | Open current directory, or selected `.code-workspace` file, in VS Code |
 | `n` | Create new folder |
 | `h` | Go to home directory |
 | `r` | Refresh directory listing |
@@ -127,14 +155,15 @@ python ssh_dir_browser.py user@hostname
 3. Select `..` to go to parent directory
 4. Press `n` to create a new folder in the current directory
 5. Press `r` to refresh the directory contents
-6. Press `o` when you want to open the current directory in VS Code
+6. Press `o` to open the current directory in VS Code
+7. Select a `.code-workspace` file and press `o` to open that workspace in VS Code
 
 ### VS Code Integration
 
 When you press `o`, the application will:
 1. Open VS Code
 2. Connect to the remote server via Remote-SSH
-3. Open the selected directory
+3. Open the current directory, or the selected `.code-workspace` file
 4. Exit the browser
 
 Make sure you have:
@@ -278,7 +307,17 @@ Install it from VS Code:
 Install the required dependency:
 
 ```bash
-pip install paramiko
+pip install ssh-to-code
+```
+
+### Externally Managed Environment (Ubuntu/Debian)
+
+If you see `externally-managed-environment`, use `pipx` instead of system `pip`:
+
+```bash
+sudo apt install -y pipx
+pipx ensurepath
+pipx install ssh-to-code
 ```
 
 ## Advanced Features

{ssh_to_code-1.0.0 → ssh_to_code-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ssh-to-code"
-version = "1.0.0"
+version = "1.0.2"
 description = "Terminal-based SSH directory browser with VS Code integration"
 readme = "README.md"
 requires-python = ">=3.7"

{ssh_to_code-1.0.0 → ssh_to_code-1.0.2}/ssh_dir_browser.py

@@ -122,20 +122,30 @@ class DirectoryBrowser:
             host = self.ssh_handler.hostname
             user = self.ssh_handler.username
             port = self.ssh_handler.port
-            
-            # VS Code Remote-SSH URI format
-            # vscode://vscode-remote/ssh-remote+user@host:port/path
-            remote_uri = f"vscode://vscode-remote/ssh-remote+{user}@{host}"
+
+            # By default open the current directory. If a .code-workspace file is
+            # selected, open that workspace file instead.
+            target_path = self.current_path
+            target_label = "directory"
+            if self.items and 0 <= self.selected_index < len(self.items):
+                selected_name, selected_type = self.items[self.selected_index]
+                if selected_type == "file" and selected_name.endswith('.code-workspace'):
+                    target_path = os.path.join(self.current_path, selected_name)
+                    target_label = "workspace"
+
+            ssh_target = f"{user}@{host}"
             if port != 22:
-                remote_uri += f":{port}"
-            remote_uri += self.current_path
-            
+                ssh_target += f":{port}"
+
             # Open VS Code
-            subprocess.Popen(['code', '--remote', f'ssh-remote+{user}@{host}', self.current_path],
+            subprocess.Popen(['code', '--remote', f'ssh-remote+{ssh_target}', target_path],
                            stdout=subprocess.DEVNULL, 
                            stderr=subprocess.DEVNULL)
-            
-            return True, f"Opening {self.current_path} in VS Code..."
+
+            if target_label == "workspace":
+                return True, f"Opening workspace {target_path} in VS Code..."
+
+            return True, f"Opening {target_path} in VS Code..."
         except Exception as e:
             return False, f"Error opening VS Code: {str(e)}"
     
@@ -153,7 +163,7 @@ class DirectoryBrowser:
         stdscr.addstr(1, 0, path_line[:width-1], curses.A_BOLD)
         
         # Help line
-        help_text = "↑/↓: Navigate | Enter: Open | 'o': VS Code | 'n': New Folder | 'r': Refresh | 'q': Quit"
+        help_text = "↑/↓: Navigate | Enter: Open | 'o': VS Code (dir/.code-workspace) | 'n': New Folder | 'r': Refresh | 'q': Quit"
         stdscr.addstr(2, 0, help_text[:width-1], curses.A_DIM)
         
         # Separator
@@ -183,6 +193,9 @@ class DirectoryBrowser:
             elif item_type == "link":
                 display = f"🔗 {name}@"
                 attr = curses.A_DIM
+            elif name.endswith('.code-workspace'):
+                display = f"🧩 {name}"
+                attr = curses.A_NORMAL
             else:
                 display = f"📄 {name}"
                 attr = curses.A_NORMAL
@@ -246,7 +259,10 @@ class DirectoryBrowser:
                         self.navigate_to(name)
                         self.status_message = ""
                     else:
-                        self.status_message = f"'{name}' is not a directory"
+                        if name.endswith('.code-workspace'):
+                            self.status_message = f"Select 'o' to open workspace: {name}"
+                        else:
+                            self.status_message = f"'{name}' is not a directory"
             elif key == ord('o') or key == ord('O'):
                 # Open in VS Code
                 success, message = self.open_in_vscode()

{ssh_to_code-1.0.0 → ssh_to_code-1.0.2}/ssh_to_code.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ssh-to-code
-Version: 1.0.0
+Version: 1.0.2
 Summary: Terminal-based SSH directory browser with VS Code integration
 Author-email: Rajesh <rajesh-cs18@users.noreply.github.com>
 License-Expression: MIT
@@ -33,7 +33,7 @@ Dynamic: license-file
 
 # SSH Directory Browser
 
-A terminal-based directory browser that lets you SSH into a remote server, navigate through directories interactively, and open selected directories directly in VS Code using the Remote-SSH extension.
+A terminal-based directory browser that lets you SSH into a remote server, navigate through directories interactively, and open selected directories or `.code-workspace` files directly in VS Code using the Remote-SSH extension.
 
 ![Terminal UI](https://img.shields.io/badge/Terminal-Based-blue)
 ![Python](https://img.shields.io/badge/Python-3.7+-green)
@@ -46,6 +46,7 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
 - 🔐 **Secure SSH Connection** - Support for key-based and password authentication
 - 📂 **Visual File Browser** - Clear indicators for directories, files, executables, and symlinks
 - 💻 **VS Code Integration** - Open any remote directory directly in VS Code with one keystroke
+- 🧩 **Workspace File Support** - Open remote `.code-workspace` files directly in VS Code
 - ⚙️ **Configuration Management** - Save frequently used SSH hosts for quick access
 - 🎨 **Keyboard Navigation** - Fast and efficient navigation using arrow keys
 
@@ -57,14 +58,42 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
 
 ## Installation
 
-### 1. Clone the repository
+### 1. Install from PyPI (recommended)
+
+```bash
+pip install ssh-to-code
+```
+
+### 2. Linux/Ubuntu (recommended): install with pipx
+
+Ubuntu and other modern Debian-based systems may block global `pip` installs with PEP 668 (`externally-managed-environment`).
+For CLI tools like `ssh-to-code`, `pipx` is the safest option:
+
+```bash
+sudo apt update
+sudo apt install -y pipx
+pipx ensurepath
+
+# Restart terminal, then:
+pipx install ssh-to-code
+ssh-browse --help
+```
+
+### 3. Verify CLI installation
+
+```bash
+ssh-browse --help
+```
+
+### 4. (Optional) Install from source for development
 
 ```bash
 git clone <repository-url>
 cd ssh-to-code
+pip install -e .
 ```
 
-### 2. Install Python dependencies
+### 5. (Source install only) Install dependencies manually
 
 ```bash
 pip install paramiko
@@ -76,13 +105,13 @@ Or use the provided requirements file:
 pip install -r requirements.txt
 ```
 
-### 3. Make the script executable
+### 6. (Source install only) Make the script executable
 
 ```bash
 chmod +x ssh_dir_browser.py
 ```
 
-### 4. (Optional) Add to PATH
+### 7. (Optional, source install only) Add to PATH
 
 For easy access from anywhere:
 
@@ -101,42 +130,41 @@ sudo ln -s /path/to/ssh-to-code/ssh_dir_browser.py /usr/local/bin/ssh-browse
 Connect to a remote server and start browsing:
 
 ```bash
-# Option 1: Use the wrapper script (automatically activates venv)
-./ssh-browse user@hostname
+# Installed from PyPI or pip install -e .
+ssh-browse user@hostname
 
-# Option 2: Activate venv manually
-source venv/bin/activate
+# If running directly from source without install:
 python ssh_dir_browser.py user@hostname
 ```
 
 ### With Custom Port
 
 ```bash
-./ssh-browse user@hostname -p 2222
+ssh-browse user@hostname -p 2222
 ```
 
 ### With SSH Key
 
 ```bash
-./ssh-browse user@hostname -i ~/.ssh/my_key
+ssh-browse user@hostname -i ~/.ssh/my_key
 ```
 
 ### Start in Specific Directory
 
 ```bash
-./ssh-browse user@hostname --start-path /var/www
+ssh-browse user@hostname --start-path /var/www
 ```
 
 ### Password Authentication
 
 ```bash
-./ssh-browse user@hostname --password
+ssh-browse user@hostname --password
 ```
 
 ### AWS EC2 Example
 
 ```bash
-./ssh-browse ubuntu@ec2-12-34-56-78.compute.amazonaws.com -i ~/Downloads/aws-key.pem
+ssh-browse ubuntu@ec2-12-34-56-78.compute.amazonaws.com -i ~/Downloads/aws-key.pem
 ```
 
 ## Usage
@@ -147,7 +175,7 @@ python ssh_dir_browser.py user@hostname
 |-----|--------|
 | `↑` / `↓` | Navigate up/down |
 | `Enter` | Open directory |
-| `o` | Open current directory in VS Code |
+| `o` | Open current directory, or selected `.code-workspace` file, in VS Code |
 | `n` | Create new folder |
 | `h` | Go to home directory |
 | `r` | Refresh directory listing |
@@ -160,14 +188,15 @@ python ssh_dir_browser.py user@hostname
 3. Select `..` to go to parent directory
 4. Press `n` to create a new folder in the current directory
 5. Press `r` to refresh the directory contents
-6. Press `o` when you want to open the current directory in VS Code
+6. Press `o` to open the current directory in VS Code
+7. Select a `.code-workspace` file and press `o` to open that workspace in VS Code
 
 ### VS Code Integration
 
 When you press `o`, the application will:
 1. Open VS Code
 2. Connect to the remote server via Remote-SSH
-3. Open the selected directory
+3. Open the current directory, or the selected `.code-workspace` file
 4. Exit the browser
 
 Make sure you have:
@@ -311,7 +340,17 @@ Install it from VS Code:
 Install the required dependency:
 
 ```bash
-pip install paramiko
+pip install ssh-to-code
+```
+
+### Externally Managed Environment (Ubuntu/Debian)
+
+If you see `externally-managed-environment`, use `pipx` instead of system `pip`:
+
+```bash
+sudo apt install -y pipx
+pipx ensurepath
+pipx install ssh-to-code
 ```
 
 ## Advanced Features