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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ssh-to-code
3
- Version: 1.0.1
3
+ Version: 1.0.2
4
4
  Summary: Terminal-based SSH directory browser with VS Code integration
5
5
  Author-email: Rajesh <rajesh-cs18@users.noreply.github.com>
6
6
  License-Expression: MIT
@@ -64,13 +64,28 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
64
64
  pip install ssh-to-code
65
65
  ```
66
66
 
67
- ### 2. Verify CLI installation
67
+ ### 2. Linux/Ubuntu (recommended): install with pipx
68
+
69
+ Ubuntu and other modern Debian-based systems may block global `pip` installs with PEP 668 (`externally-managed-environment`).
70
+ For CLI tools like `ssh-to-code`, `pipx` is the safest option:
71
+
72
+ ```bash
73
+ sudo apt update
74
+ sudo apt install -y pipx
75
+ pipx ensurepath
76
+
77
+ # Restart terminal, then:
78
+ pipx install ssh-to-code
79
+ ssh-browse --help
80
+ ```
81
+
82
+ ### 3. Verify CLI installation
68
83
 
69
84
  ```bash
70
85
  ssh-browse --help
71
86
  ```
72
87
 
73
- ### 3. (Optional) Install from source for development
88
+ ### 4. (Optional) Install from source for development
74
89
 
75
90
  ```bash
76
91
  git clone <repository-url>
@@ -78,7 +93,7 @@ cd ssh-to-code
78
93
  pip install -e .
79
94
  ```
80
95
 
81
- ### 4. (Source install only) Install dependencies manually
96
+ ### 5. (Source install only) Install dependencies manually
82
97
 
83
98
  ```bash
84
99
  pip install paramiko
@@ -90,13 +105,13 @@ Or use the provided requirements file:
90
105
  pip install -r requirements.txt
91
106
  ```
92
107
 
93
- ### 5. (Source install only) Make the script executable
108
+ ### 6. (Source install only) Make the script executable
94
109
 
95
110
  ```bash
96
111
  chmod +x ssh_dir_browser.py
97
112
  ```
98
113
 
99
- ### 6. (Optional, source install only) Add to PATH
114
+ ### 7. (Optional, source install only) Add to PATH
100
115
 
101
116
  For easy access from anywhere:
102
117
 
@@ -328,6 +343,16 @@ Install the required dependency:
328
343
  pip install ssh-to-code
329
344
  ```
330
345
 
346
+ ### Externally Managed Environment (Ubuntu/Debian)
347
+
348
+ If you see `externally-managed-environment`, use `pipx` instead of system `pip`:
349
+
350
+ ```bash
351
+ sudo apt install -y pipx
352
+ pipx ensurepath
353
+ pipx install ssh-to-code
354
+ ```
355
+
331
356
  ## Advanced Features
332
357
 
333
358
  ### Adding Custom SSH Config
@@ -31,13 +31,28 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
31
31
  pip install ssh-to-code
32
32
  ```
33
33
 
34
- ### 2. Verify CLI installation
34
+ ### 2. Linux/Ubuntu (recommended): install with pipx
35
+
36
+ Ubuntu and other modern Debian-based systems may block global `pip` installs with PEP 668 (`externally-managed-environment`).
37
+ For CLI tools like `ssh-to-code`, `pipx` is the safest option:
38
+
39
+ ```bash
40
+ sudo apt update
41
+ sudo apt install -y pipx
42
+ pipx ensurepath
43
+
44
+ # Restart terminal, then:
45
+ pipx install ssh-to-code
46
+ ssh-browse --help
47
+ ```
48
+
49
+ ### 3. Verify CLI installation
35
50
 
36
51
  ```bash
37
52
  ssh-browse --help
38
53
  ```
39
54
 
40
- ### 3. (Optional) Install from source for development
55
+ ### 4. (Optional) Install from source for development
41
56
 
42
57
  ```bash
43
58
  git clone <repository-url>
@@ -45,7 +60,7 @@ cd ssh-to-code
45
60
  pip install -e .
46
61
  ```
47
62
 
48
- ### 4. (Source install only) Install dependencies manually
63
+ ### 5. (Source install only) Install dependencies manually
49
64
 
50
65
  ```bash
51
66
  pip install paramiko
@@ -57,13 +72,13 @@ Or use the provided requirements file:
57
72
  pip install -r requirements.txt
58
73
  ```
59
74
 
60
- ### 5. (Source install only) Make the script executable
75
+ ### 6. (Source install only) Make the script executable
61
76
 
62
77
  ```bash
63
78
  chmod +x ssh_dir_browser.py
64
79
  ```
65
80
 
66
- ### 6. (Optional, source install only) Add to PATH
81
+ ### 7. (Optional, source install only) Add to PATH
67
82
 
68
83
  For easy access from anywhere:
69
84
 
@@ -295,6 +310,16 @@ Install the required dependency:
295
310
  pip install ssh-to-code
296
311
  ```
297
312
 
313
+ ### Externally Managed Environment (Ubuntu/Debian)
314
+
315
+ If you see `externally-managed-environment`, use `pipx` instead of system `pip`:
316
+
317
+ ```bash
318
+ sudo apt install -y pipx
319
+ pipx ensurepath
320
+ pipx install ssh-to-code
321
+ ```
322
+
298
323
  ## Advanced Features
299
324
 
300
325
  ### Adding Custom SSH Config
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "ssh-to-code"
7
- version = "1.0.1"
7
+ version = "1.0.2"
8
8
  description = "Terminal-based SSH directory browser with VS Code integration"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.7"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: ssh-to-code
3
- Version: 1.0.1
3
+ Version: 1.0.2
4
4
  Summary: Terminal-based SSH directory browser with VS Code integration
5
5
  Author-email: Rajesh <rajesh-cs18@users.noreply.github.com>
6
6
  License-Expression: MIT
@@ -64,13 +64,28 @@ A terminal-based directory browser that lets you SSH into a remote server, navig
64
64
  pip install ssh-to-code
65
65
  ```
66
66
 
67
- ### 2. Verify CLI installation
67
+ ### 2. Linux/Ubuntu (recommended): install with pipx
68
+
69
+ Ubuntu and other modern Debian-based systems may block global `pip` installs with PEP 668 (`externally-managed-environment`).
70
+ For CLI tools like `ssh-to-code`, `pipx` is the safest option:
71
+
72
+ ```bash
73
+ sudo apt update
74
+ sudo apt install -y pipx
75
+ pipx ensurepath
76
+
77
+ # Restart terminal, then:
78
+ pipx install ssh-to-code
79
+ ssh-browse --help
80
+ ```
81
+
82
+ ### 3. Verify CLI installation
68
83
 
69
84
  ```bash
70
85
  ssh-browse --help
71
86
  ```
72
87
 
73
- ### 3. (Optional) Install from source for development
88
+ ### 4. (Optional) Install from source for development
74
89
 
75
90
  ```bash
76
91
  git clone <repository-url>
@@ -78,7 +93,7 @@ cd ssh-to-code
78
93
  pip install -e .
79
94
  ```
80
95
 
81
- ### 4. (Source install only) Install dependencies manually
96
+ ### 5. (Source install only) Install dependencies manually
82
97
 
83
98
  ```bash
84
99
  pip install paramiko
@@ -90,13 +105,13 @@ Or use the provided requirements file:
90
105
  pip install -r requirements.txt
91
106
  ```
92
107
 
93
- ### 5. (Source install only) Make the script executable
108
+ ### 6. (Source install only) Make the script executable
94
109
 
95
110
  ```bash
96
111
  chmod +x ssh_dir_browser.py
97
112
  ```
98
113
 
99
- ### 6. (Optional, source install only) Add to PATH
114
+ ### 7. (Optional, source install only) Add to PATH
100
115
 
101
116
  For easy access from anywhere:
102
117
 
@@ -328,6 +343,16 @@ Install the required dependency:
328
343
  pip install ssh-to-code
329
344
  ```
330
345
 
346
+ ### Externally Managed Environment (Ubuntu/Debian)
347
+
348
+ If you see `externally-managed-environment`, use `pipx` instead of system `pip`:
349
+
350
+ ```bash
351
+ sudo apt install -y pipx
352
+ pipx ensurepath
353
+ pipx install ssh-to-code
354
+ ```
355
+
331
356
  ## Advanced Features
332
357
 
333
358
  ### Adding Custom SSH Config
File without changes
File without changes
File without changes
File without changes