notispf 1.0.0__py3-none-any.whl

notispf-1.0.0.dist-info/METADATA

@@ -0,0 +1,229 @@
+Metadata-Version: 2.4
+Name: notispf
+Version: 1.0.0
+Summary: A terminal text editor inspired by the ISPF editor from z/OS
+Author-email: mrthock <m64357@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/mrthock/notispf
+Project-URL: Repository, https://github.com/mrthock/notispf
+Project-URL: Bug Tracker, https://github.com/mrthock/notispf/issues
+Keywords: editor,ispf,terminal,tui,mainframe,zos
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Editors
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# notispf
+
+A terminal text editor for Linux and macOS inspired by the ISPF editor from z/OS mainframes.
+Runs in your terminal like vim or nano, with the prefix command area that ISPF users know and love.
+
+## Installation
+
+### Download a binary (no Python required)
+
+Go to the [Releases page](https://github.com/mrthock/notispf/releases) and download the binary for your platform:
+
+| Platform | File |
+|----------|------|
+| Linux    | `notispf-linux` |
+| macOS    | `notispf-macos` |
+| Windows  | `notispf-windows.exe` |
+
+**Linux / macOS:**
+```bash
+chmod +x notispf-linux   # or notispf-macos
+./notispf-linux myfile.txt
+```
+
+Optionally move it somewhere on your PATH:
+```bash
+mv notispf-linux ~/.local/bin/notispf
+```
+
+**macOS note:** macOS will warn that the binary is from an unidentified developer. To clear the warning:
+```bash
+xattr -d com.apple.quarantine ./notispf-macos
+```
+Then run it normally.
+
+### Via pip
+
+```bash
+pip install notispf
+```
+
+### From source
+
+```bash
+git clone https://github.com/mrthock/notispf
+cd notispf
+pip install -e .
+```
+
+## Usage
+
+```bash
+notispf <file>
+```
+
+## Screen Layout
+
+```
+ notispf  filename.txt                              Line 1/42
+000001|This is the first line of your file
+000002|Second line here
+000003|Third line
+      |~
+      |~
+Type prefix command, Enter to execute, Esc to cancel
+```
+
+- **Status bar** (top) — filename, modified flag `[+]`, current line/total
+- **Prefix column** (left, 6 chars) — shows line numbers; type commands here
+- **Text area** (right of `|`) — edit your file
+- **Message/command line** (bottom) — status messages and command input
+
+## Navigation
+
+| Key | Action |
+|-----|--------|
+| Arrow keys | Move cursor |
+| Page Up / Page Down | Scroll |
+| Home / Ctrl+A | Beginning of line |
+| End / Ctrl+E | End of line |
+
+## Switching Between Text and Prefix Area
+
+| Key | Action |
+|-----|--------|
+| Tab | text(N) → prefix(N+1) |
+| Tab | prefix(N) → text(N) |
+| Shift+Tab | text(N) → prefix(N) |
+| Shift+Tab | prefix(N) → text(N-1) |
+
+## Prefix Commands
+
+Type a command into the prefix column, then press **Enter** to execute.
+You can stage commands on multiple lines before pressing Enter — they all execute at once.
+
+### Single-Line Commands
+
+| Command | Action |
+|---------|--------|
+| `D` | Delete line |
+| `Dn` | Delete n lines (e.g. `D5` deletes 5) |
+| `I` | Insert blank line after |
+| `In` | Insert n blank lines |
+| `R` | Repeat line |
+| `Rn` | Repeat line n times |
+| `C` | Copy line to clipboard |
+| `Cn` | Copy n lines to clipboard |
+| `M` | Move line (cut to clipboard) |
+| `Mn` | Move n lines |
+| `A` | Paste clipboard **after** this line |
+| `B` | Paste clipboard **before** this line |
+
+### Block Commands
+
+Type the command on the **first** line of the block, then again on the **last** line.
+
+| Command | Action |
+|---------|--------|
+| `DD` | Delete block |
+| `CC` | Copy block to clipboard |
+| `MM` | Move block (cut to clipboard) |
+| `RR` | Repeat block (insert a copy below) |
+
+Use `A` or `B` on a third line to place the clipboard after copying or moving.
+
+**Example — move lines 3–6 to after line 10:**
+1. Tab to line 3 prefix → type `MM`
+2. Arrow down to line 6 → type `MM`
+3. Arrow down to line 10 → type `A`
+4. Press Enter
+
+### Prefix Mode Controls
+
+| Key | Action |
+|-----|--------|
+| Enter | Execute all staged prefix commands |
+| Escape | Cancel all staged commands and exit prefix mode |
+| ↑ / ↓ | Move between lines (keeps staged commands) |
+
+## Command Line
+
+Press **`=`** or **`F6`** to open the command line, then type a command and press Enter.
+
+### File Commands
+
+| Command | Action |
+|---------|--------|
+| `SAVE` | Save file |
+| `FILE` | Save and exit |
+| `CANCEL` or `QUIT` | Exit without saving |
+
+### Find and Change
+
+```
+FIND "text"
+CHANGE "old" "new"
+CHANGE "old" "new" ALL
+CHANGE "old" "new" ALL .labelA .labelB
+```
+
+- `FIND` — locate next occurrence (case-insensitive by default)
+- `CHANGE` — replace next occurrence
+- `CHANGE ... ALL` — replace all occurrences in file
+- `CHANGE ... ALL .A .B` — replace all occurrences between labeled lines
+
+### Labels
+
+Type `.A`, `.B` etc. in the prefix column to assign a label to a line.
+Labels are used to define ranges for `CHANGE ... ALL .A .B`.
+
+## Function Keys
+
+| Key | Action |
+|-----|--------|
+| F3 | Save and exit |
+| F5 | Save without exiting |
+| F6 | Open command line |
+| F12 | Exit without saving |
+
+## Contributing
+
+notispf is designed to be easy to extend. Adding a new prefix command takes three steps:
+
+1. Write a handler function in `notispf/commands/line_cmds.py`:
+
+```python
+def cmd_trim(buffer: Buffer, line_idx: int, count: int) -> EditorResult:
+    for i in range(line_idx, min(line_idx + count, len(buffer))):
+        buffer.replace_line(i, buffer.lines[i].text.rstrip())
+    return EditorResult(success=True)
+```
+
+2. Register it in the same file's `register()` function:
+
+```python
+registry.register_line_cmd(CommandSpec("T", cmd_trim, description="Trim trailing whitespace"))
+```
+
+3. Add tests in `tests/test_line_cmds.py`.
+
+That's it — no changes to the prefix state machine, display, or app controller needed.
+
+See [ARCHITECTURE.md](ARCHITECTURE.md) for a deeper overview of the codebase.
+
+## License
+
+MIT

notispf-1.0.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+notispf/__init__.py,sha256=J-j-u0itpEFT6irdmWmixQqYMadNl1X91TxUmoiLHMI,22
+notispf/__main__.py,sha256=TolmJ7HzJmAP5u-feY-QepjpWSPALuMgIGOJo_dJBOc,219
+notispf/app.py,sha256=1Uh57eRp25WV6WFFDq2iw1C96bBe3hczR6w92ixuzZg,24110
+notispf/buffer.py,sha256=nGuKkhugf46CgNl7CLrJT36P_rvDccCiKpoaLBSCgTU,6279
+notispf/display.py,sha256=k28ictzmn0t-Yd20xCHmXNCHyC80jrxiA-rZUJa16Dg,17233
+notispf/find_change.py,sha256=NYn4v5NhEG19mo4j5tMtYNYzT7HOvR9Z6QdLY1BF1Dc,7913
+notispf/prefix.py,sha256=f40L5EnFPmngVyRm7m9dCVjtwLPQGo-zduVofP4HgTo,3697
+notispf/commands/__init__.py,sha256=zVwQaeQ4l-o9BM1HILSgR2frqA11zSsJLlzFCpqt-2A,171
+notispf/commands/block_cmds.py,sha256=UHbdv4_cu9nl4vpko2c8t7K6RJj8oTn2zcWkIorE_-c,2678
+notispf/commands/exclude_cmds.py,sha256=x2gzuOWzfsqNekVJmLyrNPzW48hz9PHEXzhNXZJyK2o,1819
+notispf/commands/line_cmds.py,sha256=XlvGVNASPtGpziqddnZK8-l_1znpNCKGMitkOS04QMA,4164
+notispf/commands/registry.py,sha256=-0FrbxbqF8fjkifpK53oMsVU5ATChiSED7A6gsUy60w,1842
+notispf-1.0.0.dist-info/METADATA,sha256=SQl4RwAMtEYrsr2BrRjNvt4RX6F5YYchqUJAU2aYOV4,6163
+notispf-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+notispf-1.0.0.dist-info/entry_points.txt,sha256=Rsi-6inasK_yW3mcCMbbJJ7gvA3hlF6QuKHT5Jqhjbo,50
+notispf-1.0.0.dist-info/top_level.txt,sha256=ZoBj5R4otBltJJyVEdpI8BeNFBxf8Bdp0o5FTYi2my0,8
+notispf-1.0.0.dist-info/RECORD,,

notispf-1.0.0.dist-info/WHEEL

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

notispf-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+notispf = notispf.__main__:main

notispf-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+notispf