grass-editor 0.1.0__tar.gz

grass_editor-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mukund Jha
+
+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.

grass_editor-0.1.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: grass-editor
+Version: 0.1.0
+Summary: A calm, zero-config terminal editor — beautiful by default, hackable in an afternoon.
+Author: Mukund Jha
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/mukundzha/grass
+Project-URL: Repository, https://github.com/mukundzha/grass
+Project-URL: Issues, https://github.com/mukundzha/grass/issues
+Keywords: editor,terminal,tui,curses,text-editor,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Environment :: Console :: Curses
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Text Editors
+Classifier: Topic :: Text Editors :: Text Processing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pygments>=2.6
+Dynamic: license-file
+
+# Grass
+
+A minimal, beautiful, zero-config terminal code editor.
+
+No modes. No config files. Just type.
+
+## Install
+
+```bash
+pip install grass-editor
+```
+
+On Windows, install curses support first:
+
+```bash
+pip install windows-curses
+```
+
+## Run
+
+```bash
+grass hello.py
+```
+
+Or without installing:
+
+```bash
+python -m grass hello.py
+```
+
+Check the identity:
+
+```bash
+grass --version
+```
+
+## Theme
+
+Grass ships with one hand-tuned theme: **Meadow**.
+
+A calm, forest-inspired dark palette — warm parchment text, sage-green
+keywords, golden function names, aqua class names, and a layered
+forest-dark status bar. Comments and docstrings sit quietly in muted
+green-gray so code reads like a clearing at dusk.
+
+- A two-tone wordmark splash greets you on launch — meadow green above,
+  sage shadow below — over the line `❧ a calm terminal editor`, signed
+  `v0.1.0 · Meadow`, and fades the moment you type.
+- The status bar keeps the file name on the left and live line,column
+  position on the right.
+- An amber dot beside the file name marks unsaved changes, then
+  disappears the moment you save.
+- Your terminal tab lives and breathes with you: `grass · file.py`,
+  gaining a ` •` while there are unsaved changes.
+- Feedback speaks in color: saves flash leaf green, problems turn
+  warm red.
+- A floating scrollbar on the right edge tracks your place in the file.
+- The cursor line glows softly; the gutter stays a shade darker.
+- Search matches glow olive-green, and the match you are on turns warm gold.
+- Prompts sit behind a green `❯` marker.
+
+Meadow assumes a dark terminal with 256 colors. Terminals with only
+basic colors fall back gracefully.
+
+## Keys
+
+| Key | Action |
+| --- | --- |
+| type | edit |
+| arrows, Home, End, PageUp, PageDown | move |
+| Enter | new line, with auto-indent |
+| Tab | insert 4 spaces |
+| Backspace, Delete | delete |
+| Ctrl-F | find (jumps to matches as you type) |
+| Ctrl-P | open a file by fuzzy search |
+| Ctrl-K | cut line |
+| Ctrl-U | paste line |
+| Ctrl-S | save |
+| Ctrl-Z | undo |
+| Ctrl-R | redo |
+| Ctrl-Q | quit |
+
+## Notes
+
+- Grass is always in typing mode, like nano.
+- A file without a trailing newline stays that way, and the status bar says `no newline`.
+- The theme is designed for dark terminal backgrounds.
+- Tabs in opened files are converted to 4 spaces.
+- Large files re-highlight fully on every edit; normal files stay fast.
+- Wide characters (CJK) and long wrapped lines are not fully supported yet.

grass_editor-0.1.0/README.md

@@ -0,0 +1,90 @@
+# Grass
+
+A minimal, beautiful, zero-config terminal code editor.
+
+No modes. No config files. Just type.
+
+## Install
+
+```bash
+pip install grass-editor
+```
+
+On Windows, install curses support first:
+
+```bash
+pip install windows-curses
+```
+
+## Run
+
+```bash
+grass hello.py
+```
+
+Or without installing:
+
+```bash
+python -m grass hello.py
+```
+
+Check the identity:
+
+```bash
+grass --version
+```
+
+## Theme
+
+Grass ships with one hand-tuned theme: **Meadow**.
+
+A calm, forest-inspired dark palette — warm parchment text, sage-green
+keywords, golden function names, aqua class names, and a layered
+forest-dark status bar. Comments and docstrings sit quietly in muted
+green-gray so code reads like a clearing at dusk.
+
+- A two-tone wordmark splash greets you on launch — meadow green above,
+  sage shadow below — over the line `❧ a calm terminal editor`, signed
+  `v0.1.0 · Meadow`, and fades the moment you type.
+- The status bar keeps the file name on the left and live line,column
+  position on the right.
+- An amber dot beside the file name marks unsaved changes, then
+  disappears the moment you save.
+- Your terminal tab lives and breathes with you: `grass · file.py`,
+  gaining a ` •` while there are unsaved changes.
+- Feedback speaks in color: saves flash leaf green, problems turn
+  warm red.
+- A floating scrollbar on the right edge tracks your place in the file.
+- The cursor line glows softly; the gutter stays a shade darker.
+- Search matches glow olive-green, and the match you are on turns warm gold.
+- Prompts sit behind a green `❯` marker.
+
+Meadow assumes a dark terminal with 256 colors. Terminals with only
+basic colors fall back gracefully.
+
+## Keys
+
+| Key | Action |
+| --- | --- |
+| type | edit |
+| arrows, Home, End, PageUp, PageDown | move |
+| Enter | new line, with auto-indent |
+| Tab | insert 4 spaces |
+| Backspace, Delete | delete |
+| Ctrl-F | find (jumps to matches as you type) |
+| Ctrl-P | open a file by fuzzy search |
+| Ctrl-K | cut line |
+| Ctrl-U | paste line |
+| Ctrl-S | save |
+| Ctrl-Z | undo |
+| Ctrl-R | redo |
+| Ctrl-Q | quit |
+
+## Notes
+
+- Grass is always in typing mode, like nano.
+- A file without a trailing newline stays that way, and the status bar says `no newline`.
+- The theme is designed for dark terminal backgrounds.
+- Tabs in opened files are converted to 4 spaces.
+- Large files re-highlight fully on every edit; normal files stay fast.
+- Wide characters (CJK) and long wrapped lines are not fully supported yet.

grass_editor-0.1.0/grass/__init__.py

@@ -0,0 +1 @@
+VERSION = "0.1.0"

grass_editor-0.1.0/grass/__main__.py

@@ -0,0 +1,3 @@
+from grass.main import main
+
+main()