suplemon-editor 0.3.1__tar.gz → 0.3.2__tar.gz

{suplemon_editor-0.3.1/suplemon_editor.egg-info → suplemon_editor-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: suplemon-editor
-Version: 0.3.1
+Version: 0.3.2
 Summary: Console text editor with multi cursor support. Maintained fork of Suplemon.
 Home-page: https://github.com/leancode/suplemon/
 Author: Richard Lewis
@@ -183,6 +183,28 @@ externally managed (PEP 668) and will refuse `sudo pip install` outright.
     suplemon [filename:row:col]... # Open one or more files at a specific row or column (optional)
 
 
+### Editing a root-owned file
+
+`sudo suplemon /etc/hosts` will say `command not found`. That is sudo, not
+Suplemon: sudo replaces `$PATH` with its own `secure_path`, which never
+includes `~/.local/bin`, so it cannot see the launcher. Give it the full
+path instead:
+
+    sudo ~/.local/bin/suplemon /etc/hosts
+
+That works because the launcher hard-codes an absolute path to the source
+tree. `$HOME` is root's under sudo, so a launcher written in terms of
+`$HOME` would look for the interpreter in the wrong place.
+
+If you do this often, either add `~/.local/bin` to `secure_path` in
+`visudo`, or use `sudoedit`, which copies the file to a temporary location,
+opens it as you rather than as root, and copies it back:
+
+    SUDO_EDITOR=~/.local/bin/suplemon sudoedit /etc/hosts
+
+`sudoedit` is the safer of the two: the editor never runs as root.
+
+
 ### Notes
  - **Python 3.8 or higher.** Python 2 is not supported.
  - *The master branch is considered stable.*

{suplemon_editor-0.3.1 → suplemon_editor-0.3.2}/README.md

@@ -142,6 +142,28 @@ externally managed (PEP 668) and will refuse `sudo pip install` outright.
     suplemon [filename:row:col]... # Open one or more files at a specific row or column (optional)
 
 
+### Editing a root-owned file
+
+`sudo suplemon /etc/hosts` will say `command not found`. That is sudo, not
+Suplemon: sudo replaces `$PATH` with its own `secure_path`, which never
+includes `~/.local/bin`, so it cannot see the launcher. Give it the full
+path instead:
+
+    sudo ~/.local/bin/suplemon /etc/hosts
+
+That works because the launcher hard-codes an absolute path to the source
+tree. `$HOME` is root's under sudo, so a launcher written in terms of
+`$HOME` would look for the interpreter in the wrong place.
+
+If you do this often, either add `~/.local/bin` to `secure_path` in
+`visudo`, or use `sudoedit`, which copies the file to a temporary location,
+opens it as you rather than as root, and copies it back:
+
+    SUDO_EDITOR=~/.local/bin/suplemon sudoedit /etc/hosts
+
+`sudoedit` is the safer of the two: the editor never runs as root.
+
+
 ### Notes
  - **Python 3.8 or higher.** Python 2 is not supported.
  - *The master branch is considered stable.*

{suplemon_editor-0.3.1 → suplemon_editor-0.3.2}/suplemon/main.py

@@ -18,7 +18,7 @@ from .logger import logger
 from .config import Config
 from .editor import Editor
 
-__version__ = "0.3.1"
+__version__ = "0.3.2"
 
 
 class App:

{suplemon_editor-0.3.1 → suplemon_editor-0.3.2/suplemon_editor.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: suplemon-editor
-Version: 0.3.1
+Version: 0.3.2
 Summary: Console text editor with multi cursor support. Maintained fork of Suplemon.
 Home-page: https://github.com/leancode/suplemon/
 Author: Richard Lewis
@@ -183,6 +183,28 @@ externally managed (PEP 668) and will refuse `sudo pip install` outright.
     suplemon [filename:row:col]... # Open one or more files at a specific row or column (optional)
 
 
+### Editing a root-owned file
+
+`sudo suplemon /etc/hosts` will say `command not found`. That is sudo, not
+Suplemon: sudo replaces `$PATH` with its own `secure_path`, which never
+includes `~/.local/bin`, so it cannot see the launcher. Give it the full
+path instead:
+
+    sudo ~/.local/bin/suplemon /etc/hosts
+
+That works because the launcher hard-codes an absolute path to the source
+tree. `$HOME` is root's under sudo, so a launcher written in terms of
+`$HOME` would look for the interpreter in the wrong place.
+
+If you do this often, either add `~/.local/bin` to `secure_path` in
+`visudo`, or use `sudoedit`, which copies the file to a temporary location,
+opens it as you rather than as root, and copies it back:
+
+    SUDO_EDITOR=~/.local/bin/suplemon sudoedit /etc/hosts
+
+`sudoedit` is the safer of the two: the editor never runs as root.
+
+
 ### Notes
  - **Python 3.8 or higher.** Python 2 is not supported.
  - *The master branch is considered stable.*