[](https://github.com/asottile/babi/actions/workflows/main.yml)
[](https://results.pre-commit.ci/latest/github/asottile/babi/main)
babi
====
a text editor, eventually...
### installation
```bash
pip install babi
```
babi works best in a virtualenv
### why is it called babi?
I used to use the text editor `nano`, frequently I typo this. on a qwerty
keyboard, when the right hand is shifted left by one, `nano` becomes `babi`.
### babi vs. nano
here is a youtube video where I discuss the motivation for creating and using
`babi` instead of `nano`:
[](https://youtu.be/WyR1hAGmR3g)
### quitting babi
currently you can quit `babi` by using <kbd>^X</kbd> (or via <kbd>esc</kbd> +
<kbd>:q</kbd>).
### key combinations
these are all of the current key bindings in babi
- <kbd>^S</kbd>: save
- <kbd>^O</kbd>: save as
- <kbd>^X</kbd>: quit
- <kbd>^P</kbd>: open file
- arrow keys: movement
- <kbd>^A</kbd> / <kbd>home</kbd>: move to beginning of line
- <kbd>^E</kbd> / <kbd>end</kbd>: move to end of line
- <kbd>^Y</kbd> / <kbd>pageup</kbd>: move up one page
- <kbd>^V</kbd> / <kbd>pagedown</kbd>: move down one page
- <kbd>^-left</kbd> / <kbd>^-right</kbd>: jump by word
- <kbd>^-home</kbd> / <kbd>^-end</kbd>: jump to beginning / end of file
- <kbd>M-Up</kbd> / <kbd>M-Down</kbd>: jump to previous / next paragraph
- <kbd>^_</kbd>: jump to line number
- selection: <kbd>shift</kbd> + ...: extend the current selection
- arrow keys
- <kbd>home</kbd> / <kbd>end</kdb>
- <kbd>pageup</kbd> / <kbd>pagedown</kbd>
- <kbd>^-left</kbd> / <kbd>^-right</kbd>
- <kbd>^-end</kbd> / <kbd>^-home</kbd>
- <kbd>tab</kbd> / <kbd>shift-tab</kbd>: indent or dedent current line (or
selection)
- <kbd>^K</kbd> / <kbd>^U</kbd>: cut and uncut the current line (or selection)
- <kbd>M-u</kbd> / <kbd>M-U</kbd> or <kbd>M-e</kbd>: undo / redo
- <kbd>^W</kbd>: search
- <kbd>^\\</kbd>: search and replace
- <kbd>^C</kbd>: show the current position in the file
- <kbd>^-up</kbd> / <kbd>^-down</kbd>: scroll screen by a single line
- <kbd>M-left</kbd> / <kbd>M-right</kbd>: go to previous / next file
- <kbd>^Z</kbd>: background
- <kbd>^T</kbd>: run linter
- by default, runs `pre-commit run --files <filename>`
- outside of a git repo will run `flake8 <filename>` for python files
- <kbd>^-S-Up</kbd>, <kbd>^-S-Down</kbd>: navigate to previous / next error
- <kbd>M-t</kbd> focus the linting panel
- <kbd>^C</kbd>, <kbd>^X</kbd>: clear and close the linting panel
- <kbd>Esc</kbd>, <kbd>M-t</kdb>: unfocus the linting panel
- arrow keys: movement inside the linting panel
- <kbd>esc</kbd>: open the command mode
- <kbd>:q</kbd>: quit
- <kbd>:w</kbd>: write the file
- <kbd>:wq</kbd>: write the file and quit
- <kbd>:qall</kbd>: quit every open file
- <kbd>:comment</kbd>: comment out the current line / selection
- <kbd>:reload</kbd>: reload the file contents
- <kbd>:sort</kbd>: sort the file (or selection)
- <kbd>:tabsize X</kbd>: set the tabsize
in prompts (search, search replace, command):
- <kbd>^C</kbd>: cancel
- <kbd>^K</kbd>: cut to end
- <kbd>^R</kbd>: reverse search
### setting up syntax highlighting
syntax highlighting should work out of the box!
if you want a custom theme find a visual studio code theme, convert it to
json (if it is not already json) and put it at `~/.config/babi/theme.json`.
a helper script is provided to make this easier: `./bin/download-theme NAME URL`
### keyboard shortcuts on macos
to get the most out of babi's built in keyboard shortcuts, a few settings must
be changed on macos with Terminal.app:
- in **System Preferences**: **Keyboard** > **Shortcuts** >
**Mission Control**: disable or rebind "Move left a space" and
"Move right a space" (the defaults `⌃ →` and `⌃ ←` conflict)
- in **Terminal.app**: **Terminal** > **Preferences** > **Profiles** >
**Keyboard**:
- check **Use Option as Meta key**
- ensure the following keys are enabled:
- `⌃ →`: `\033[1;5C`
- `⌃ ←`: `\033[1;5D`
- `⇧ ↑`: `\033[1;2A`
- `⇧ ↓`: `\033[1;2B`
- `⇧ →`: `\033[1;2C`
- `⇧ ←`: `\033[1;2D`
## demos
most things work! here's a few screenshots
### file view
this opens the file, displays it, and can be edited and can save! unknown keys
are displayed as errors in the status bar. babi will scroll if the cursor
goes off screen either from resize events or from movement. babi can edit
multiple files. babi has a command mode (so you can quit it like vim
<kbd>:q</kbd>!). babi also supports syntax highlighting
Raw data
{
"_id": null,
"home_page": "https://github.com/asottile/babi",
"name": "babi",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": null,
"author": "Anthony Sottile",
"author_email": "asottile@umich.edu",
"download_url": "https://files.pythonhosted.org/packages/42/29/92b587041cfdb3e741cbdeffbc569ac43cc91066e6ca3103762cad2b2e43/babi-1.6.0.tar.gz",
"platform": null,
"description": "[](https://github.com/asottile/babi/actions/workflows/main.yml)\n[](https://results.pre-commit.ci/latest/github/asottile/babi/main)\n\n\n\nbabi\n====\n\na text editor, eventually...\n\n### installation\n\n```bash\npip install babi\n```\n\nbabi works best in a virtualenv\n\n### why is it called babi?\n\nI used to use the text editor `nano`, frequently I typo this. on a qwerty\nkeyboard, when the right hand is shifted left by one, `nano` becomes `babi`.\n\n### babi vs. nano\n\nhere is a youtube video where I discuss the motivation for creating and using\n`babi` instead of `nano`:\n\n[](https://youtu.be/WyR1hAGmR3g)\n\n### quitting babi\n\ncurrently you can quit `babi` by using <kbd>^X</kbd> (or via <kbd>esc</kbd> +\n<kbd>:q</kbd>).\n\n### key combinations\n\nthese are all of the current key bindings in babi\n\n- <kbd>^S</kbd>: save\n- <kbd>^O</kbd>: save as\n- <kbd>^X</kbd>: quit\n- <kbd>^P</kbd>: open file\n- arrow keys: movement\n- <kbd>^A</kbd> / <kbd>home</kbd>: move to beginning of line\n- <kbd>^E</kbd> / <kbd>end</kbd>: move to end of line\n- <kbd>^Y</kbd> / <kbd>pageup</kbd>: move up one page\n- <kbd>^V</kbd> / <kbd>pagedown</kbd>: move down one page\n- <kbd>^-left</kbd> / <kbd>^-right</kbd>: jump by word\n- <kbd>^-home</kbd> / <kbd>^-end</kbd>: jump to beginning / end of file\n- <kbd>M-Up</kbd> / <kbd>M-Down</kbd>: jump to previous / next paragraph\n- <kbd>^_</kbd>: jump to line number\n- selection: <kbd>shift</kbd> + ...: extend the current selection\n - arrow keys\n - <kbd>home</kbd> / <kbd>end</kdb>\n - <kbd>pageup</kbd> / <kbd>pagedown</kbd>\n - <kbd>^-left</kbd> / <kbd>^-right</kbd>\n - <kbd>^-end</kbd> / <kbd>^-home</kbd>\n- <kbd>tab</kbd> / <kbd>shift-tab</kbd>: indent or dedent current line (or\n selection)\n- <kbd>^K</kbd> / <kbd>^U</kbd>: cut and uncut the current line (or selection)\n- <kbd>M-u</kbd> / <kbd>M-U</kbd> or <kbd>M-e</kbd>: undo / redo\n- <kbd>^W</kbd>: search\n- <kbd>^\\\\</kbd>: search and replace\n- <kbd>^C</kbd>: show the current position in the file\n- <kbd>^-up</kbd> / <kbd>^-down</kbd>: scroll screen by a single line\n- <kbd>M-left</kbd> / <kbd>M-right</kbd>: go to previous / next file\n- <kbd>^Z</kbd>: background\n- <kbd>^T</kbd>: run linter\n - by default, runs `pre-commit run --files <filename>`\n - outside of a git repo will run `flake8 <filename>` for python files\n - <kbd>^-S-Up</kbd>, <kbd>^-S-Down</kbd>: navigate to previous / next error\n - <kbd>M-t</kbd> focus the linting panel\n - <kbd>^C</kbd>, <kbd>^X</kbd>: clear and close the linting panel\n - <kbd>Esc</kbd>, <kbd>M-t</kdb>: unfocus the linting panel\n - arrow keys: movement inside the linting panel\n- <kbd>esc</kbd>: open the command mode\n - <kbd>:q</kbd>: quit\n - <kbd>:w</kbd>: write the file\n - <kbd>:wq</kbd>: write the file and quit\n - <kbd>:qall</kbd>: quit every open file\n - <kbd>:comment</kbd>: comment out the current line / selection\n - <kbd>:reload</kbd>: reload the file contents\n - <kbd>:sort</kbd>: sort the file (or selection)\n - <kbd>:tabsize X</kbd>: set the tabsize\n\nin prompts (search, search replace, command):\n- <kbd>^C</kbd>: cancel\n- <kbd>^K</kbd>: cut to end\n- <kbd>^R</kbd>: reverse search\n\n### setting up syntax highlighting\n\nsyntax highlighting should work out of the box!\n\nif you want a custom theme find a visual studio code theme, convert it to\njson (if it is not already json) and put it at `~/.config/babi/theme.json`.\na helper script is provided to make this easier: `./bin/download-theme NAME URL`\n\n### keyboard shortcuts on macos\n\nto get the most out of babi's built in keyboard shortcuts, a few settings must\nbe changed on macos with Terminal.app:\n\n- in **System Preferences**: **Keyboard** > **Shortcuts** >\n **Mission Control**: disable or rebind \"Move left a space\" and\n \"Move right a space\" (the defaults `\u2303 \u2192` and `\u2303 \u2190` conflict)\n- in **Terminal.app**: **Terminal** > **Preferences** > **Profiles** >\n **Keyboard**:\n - check **Use Option as Meta key**\n - ensure the following keys are enabled:\n - `\u2303 \u2192`: `\\033[1;5C`\n - `\u2303 \u2190`: `\\033[1;5D`\n - `\u21e7 \u2191`: `\\033[1;2A`\n - `\u21e7 \u2193`: `\\033[1;2B`\n - `\u21e7 \u2192`: `\\033[1;2C`\n - `\u21e7 \u2190`: `\\033[1;2D`\n\n## demos\n\nmost things work! here's a few screenshots\n\n### file view\n\nthis opens the file, displays it, and can be edited and can save! unknown keys\nare displayed as errors in the status bar. babi will scroll if the cursor\ngoes off screen either from resize events or from movement. babi can edit\nmultiple files. babi has a command mode (so you can quit it like vim\n<kbd>:q</kbd>!). babi also supports syntax highlighting\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "a text editor",
"version": "1.6.0",
"project_urls": {
"Homepage": "https://github.com/asottile/babi"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "31902923641efd61dc8602b62c1b422aec06b355a8f967825d7928be23eb910f",
"md5": "e5c07163112c12520a64999088612248",
"sha256": "05c6fc3373a198423bd604fac1938e28e89278b335657bc6157153d7a0f5bcb1"
},
"downloads": -1,
"filename": "babi-1.6.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "e5c07163112c12520a64999088612248",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": ">=3.10",
"size": 53482,
"upload_time": "2024-10-24T22:08:17",
"upload_time_iso_8601": "2024-10-24T22:08:17.863266Z",
"url": "https://files.pythonhosted.org/packages/31/90/2923641efd61dc8602b62c1b422aec06b355a8f967825d7928be23eb910f/babi-1.6.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "422992b587041cfdb3e741cbdeffbc569ac43cc91066e6ca3103762cad2b2e43",
"md5": "e04f16c574e3ebc293fbdf8407ea98c8",
"sha256": "ae18d95e227a7f8a52613aac909522f0f0ea0fa217a944f9df1c3d09e6bc9a9d"
},
"downloads": -1,
"filename": "babi-1.6.0.tar.gz",
"has_sig": false,
"md5_digest": "e04f16c574e3ebc293fbdf8407ea98c8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 46574,
"upload_time": "2024-10-24T22:08:19",
"upload_time_iso_8601": "2024-10-24T22:08:19.100087Z",
"url": "https://files.pythonhosted.org/packages/42/29/92b587041cfdb3e741cbdeffbc569ac43cc91066e6ca3103762cad2b2e43/babi-1.6.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-24 22:08:19",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "asottile",
"github_project": "babi",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "babi"
}
JSON
