candat 0.1.1__tar.gz

candat-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Petr Novak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

candat-0.1.1/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: candat
+Version: 0.1.1
+Summary: A terminal IDE with emacs keybindings, built on Textual — editor, file tree, markdown preview, and a real PTY terminal
+Keywords: editor,ide,terminal,tui,emacs,textual,markdown
+Author: Petr Novak
+Author-email: Petr Novak <petr@umbr.cas.cz>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Editors :: Integrated Development Environments (IDE)
+Requires-Dist: pyte>=0.8.2
+Requires-Dist: textual[syntax]>=8.2.8
+Requires-Dist: tree-sitter-language-pack>=1.12.2
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/kavonrtep/candat
+Project-URL: Issues, https://github.com/kavonrtep/candat/issues
+Project-URL: Repository, https://github.com/kavonrtep/candat
+Description-Content-Type: text/markdown
+
+# candat
+
+A terminal IDE with emacs keybindings, built on [Textual](https://textual.textualize.io/).
+
+## Install
+
+From GitHub, as a standalone tool (recommended — gives you a global `candat`
+command in its own isolated environment):
+
+```sh
+uv tool install git+https://github.com/kavonrtep/candat
+# or, with pipx (needs Python >= 3.10):
+pipx install git+https://github.com/kavonrtep/candat
+```
+
+Or with plain pip into the environment of your choice:
+
+```sh
+pip install git+https://github.com/kavonrtep/candat
+```
+
+To try it once without installing anything permanently:
+
+```sh
+uvx --from git+https://github.com/kavonrtep/candat candat
+```
+
+Requires Python >= 3.10 and Linux.
+
+## Run
+
+```sh
+candat [FILE|DIR ...]
+```
+
+Passing a directory sets the file-tree root; files are opened in buffers.
+
+## Keys (so far)
+
+| Key | Action |
+| --- | --- |
+| `C-x C-f` | find file (opens new file if it doesn't exist) |
+| `C-x C-s` | save buffer |
+| `C-x C-w` | write buffer to another file |
+| `C-x k` | kill buffer |
+| `C-x b` | buffer list (Enter switches; next buffer preselected) |
+| `C-x o` | switch focus between tree and editor |
+| `C-x C-c` | quit (confirms if unsaved buffers) |
+| `C-x C-x` | exchange point and mark |
+| `C-x h` | mark whole buffer |
+| `C-x u`, `C-/`, `C-z` | undo |
+| `C-f` `C-b` `C-n` `C-p` `C-a` `C-e` | char/line movement |
+| `M-f` `M-b` | word movement |
+| `C-v` `M-v` | page down / up |
+| `M-<` `M->` | beginning / end of buffer |
+| `C-space` | set mark (movement extends region) |
+| `C-k` | kill line (consecutive kills accumulate) |
+| `C-w` / `M-w` | kill / copy region |
+| `C-y` / `M-y` | yank / yank-pop |
+| `M-d` / `M-backspace` | kill word forward / backward |
+| `M-up` / `M-down` | move current line (or marked block) up / down |
+| `C-s` / `C-r` | incremental search (smart case, wraps) |
+| `C-x t` | toggle terminal panel (keys pass through raw; only `C-x` is reserved) |
+| `Shift+PgUp/PgDn` | terminal scrollback (typing snaps back) |
+| `C-c C-v` | cycle markdown preview: split / preview-only / off |
+| `M-x`, `Ctrl+Shift+P` | command palette |
+| `C-g` / `Esc` | cancel chord / prompt / search / mark |
+
+`ESC` acts as the Meta prefix, so `ESC w` == `M-w`, `ESC x` == `M-x`, etc.
+`Tab` completes paths in the find-file and write-file prompts.
+
+The file tree opens files on selection. The default theme is `candat-light`
+(high-contrast dark-on-white). The markdown preview is linked: it follows
+the editor's scroll position.
+
+## Development
+
+```sh
+uv run pytest
+```
+
+## Roadmap
+
+1. ~~Skeleton: tree / tabs / status bar / C-x chords / open & save~~
+2. ~~Emacs editing: kill ring, C-s/C-r isearch, mark & region, M-x palette~~
+3. ~~Markdown mode: side-by-side live preview (debounced)~~
+4. ~~Terminal panel (full PTY: forkpty + pyte)~~
+5. ~~Polish: terminal scrollback, dirty-line rendering, path completion in
+   prompts, buffer list, scroll-synced preview, R/xml/html highlighting~~
+
+Syntax highlighting covers python, markdown, json, yaml, bash, html, xml,
+css, toml, js, sql, go, rust, java, and R (via tree-sitter-language-pack).

candat-0.1.1/README.md

@@ -0,0 +1,92 @@
+# candat
+
+A terminal IDE with emacs keybindings, built on [Textual](https://textual.textualize.io/).
+
+## Install
+
+From GitHub, as a standalone tool (recommended — gives you a global `candat`
+command in its own isolated environment):
+
+```sh
+uv tool install git+https://github.com/kavonrtep/candat
+# or, with pipx (needs Python >= 3.10):
+pipx install git+https://github.com/kavonrtep/candat
+```
+
+Or with plain pip into the environment of your choice:
+
+```sh
+pip install git+https://github.com/kavonrtep/candat
+```
+
+To try it once without installing anything permanently:
+
+```sh
+uvx --from git+https://github.com/kavonrtep/candat candat
+```
+
+Requires Python >= 3.10 and Linux.
+
+## Run
+
+```sh
+candat [FILE|DIR ...]
+```
+
+Passing a directory sets the file-tree root; files are opened in buffers.
+
+## Keys (so far)
+
+| Key | Action |
+| --- | --- |
+| `C-x C-f` | find file (opens new file if it doesn't exist) |
+| `C-x C-s` | save buffer |
+| `C-x C-w` | write buffer to another file |
+| `C-x k` | kill buffer |
+| `C-x b` | buffer list (Enter switches; next buffer preselected) |
+| `C-x o` | switch focus between tree and editor |
+| `C-x C-c` | quit (confirms if unsaved buffers) |
+| `C-x C-x` | exchange point and mark |
+| `C-x h` | mark whole buffer |
+| `C-x u`, `C-/`, `C-z` | undo |
+| `C-f` `C-b` `C-n` `C-p` `C-a` `C-e` | char/line movement |
+| `M-f` `M-b` | word movement |
+| `C-v` `M-v` | page down / up |
+| `M-<` `M->` | beginning / end of buffer |
+| `C-space` | set mark (movement extends region) |
+| `C-k` | kill line (consecutive kills accumulate) |
+| `C-w` / `M-w` | kill / copy region |
+| `C-y` / `M-y` | yank / yank-pop |
+| `M-d` / `M-backspace` | kill word forward / backward |
+| `M-up` / `M-down` | move current line (or marked block) up / down |
+| `C-s` / `C-r` | incremental search (smart case, wraps) |
+| `C-x t` | toggle terminal panel (keys pass through raw; only `C-x` is reserved) |
+| `Shift+PgUp/PgDn` | terminal scrollback (typing snaps back) |
+| `C-c C-v` | cycle markdown preview: split / preview-only / off |
+| `M-x`, `Ctrl+Shift+P` | command palette |
+| `C-g` / `Esc` | cancel chord / prompt / search / mark |
+
+`ESC` acts as the Meta prefix, so `ESC w` == `M-w`, `ESC x` == `M-x`, etc.
+`Tab` completes paths in the find-file and write-file prompts.
+
+The file tree opens files on selection. The default theme is `candat-light`
+(high-contrast dark-on-white). The markdown preview is linked: it follows
+the editor's scroll position.
+
+## Development
+
+```sh
+uv run pytest
+```
+
+## Roadmap
+
+1. ~~Skeleton: tree / tabs / status bar / C-x chords / open & save~~
+2. ~~Emacs editing: kill ring, C-s/C-r isearch, mark & region, M-x palette~~
+3. ~~Markdown mode: side-by-side live preview (debounced)~~
+4. ~~Terminal panel (full PTY: forkpty + pyte)~~
+5. ~~Polish: terminal scrollback, dirty-line rendering, path completion in
+   prompts, buffer list, scroll-synced preview, R/xml/html highlighting~~
+
+Syntax highlighting covers python, markdown, json, yaml, bash, html, xml,
+css, toml, js, sql, go, rust, java, and R (via tree-sitter-language-pack).

candat-0.1.1/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "candat"
+version = "0.1.1"
+description = "A terminal IDE with emacs keybindings, built on Textual — editor, file tree, markdown preview, and a real PTY terminal"
+readme = "README.md"
+authors = [
+    { name = "Petr Novak", email = "petr@umbr.cas.cz" }
+]
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+keywords = ["editor", "ide", "terminal", "tui", "emacs", "textual", "markdown"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Text Editors :: Integrated Development Environments (IDE)",
+]
+dependencies = [
+    "pyte>=0.8.2",
+    "textual[syntax]>=8.2.8",
+    "tree-sitter-language-pack>=1.12.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/kavonrtep/candat"
+Repository = "https://github.com/kavonrtep/candat"
+Issues = "https://github.com/kavonrtep/candat/issues"
+
+[project.scripts]
+candat = "candat:main"
+
+[build-system]
+requires = ["uv_build>=0.9.24,<0.10.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "pytest>=9.1.1",
+    "pytest-asyncio>=1.4.0",
+]
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+filterwarnings = [
+    "ignore:This process.*is multi-threaded, use of forkpty:DeprecationWarning",
+]

candat-0.1.1/src/candat/__init__.py

@@ -0,0 +1,5 @@
+"""Candat: a terminal IDE with emacs keybindings."""
+
+from .app import CandatApp, main
+
+__all__ = ["CandatApp", "main"]