jvim 0.1.0__tar.gz

jvim-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+.env
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/

jvim-0.1.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.4
+Name: jvim
+Version: 0.1.0
+Summary: A modal JSON editor built with Textual, featuring vim-style keybindings
+Project-URL: Homepage, https://github.com/k2hyun/jets
+Project-URL: Repository, https://github.com/k2hyun/jets
+Project-URL: Issues, https://github.com/k2hyun/jets/issues
+Author-email: Kihyun Kim <k2hyun@gmail.com>
+License-Expression: MIT
+Keywords: cli,editor,json,jsonl,textual,tui,vim
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Editors
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Requires-Dist: textual>=0.70.0
+Provides-Extra: dev
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: textual-dev>=1.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# jets
+
+**J**SON **E**ditor in **T**extual with vim-**S**tyle keybindings.
+
+[한국어](README.kr.md)
+
+## Features
+
+- **Vim-style modal editing** - Normal, Insert, Command, and Search modes
+- **Syntax highlighting** - JSON-aware colorization
+- **JSON validation** - Real-time validation with error reporting
+- **JSONPath search** - Search using JSONPath expressions (`$.foo.bar`)
+- **JSONL support** - Edit JSON Lines files with smart formatting
+- **Embedded JSON editing** - Edit JSON strings within JSON with nested level support
+- **Bracket matching** - Jump to matching brackets with `%`
+- **Undo/Redo** - Full undo history
+
+## Installation
+
+```bash
+pip install vim-json-editor
+```
+
+## Usage
+
+```bash
+# Open a file
+vj data.json
+
+# Open in read-only mode
+vj -R data.json
+
+# Create new file
+vj newfile.json
+```
+
+## JSONL Support
+
+vj provides special handling for JSON Lines (`.jsonl`) files:
+
+- **Pretty-printed editing**: Each JSONL record is automatically formatted with indentation for easy reading and editing
+- **Compact saving**: When you save, each record is minified back to a single line, preserving the JSONL format
+- **Record numbers**: A second column shows the record number (1, 2, 3...) for easy navigation
+- **Floating header**: When scrolling through a multi-line record, the physical line number stays visible at the top
+
+Example: A JSONL file with two records:
+```
+{"name": "Alice", "age": 30}
+{"name": "Bob", "age": 25}
+```
+
+Opens in vj as:
+```
+{
+    "name": "Alice",
+    "age": 30
+}
+{
+    "name": "Bob",
+    "age": 25
+}
+```
+
+And saves back to the original compact format.
+
+## Embedded JSON Editing
+
+JSON files often contain escaped JSON strings as values. vj lets you edit these nested JSON structures naturally.
+
+### How it works
+
+1. Position your cursor on a line containing a JSON string value
+2. Type `ej` in normal mode
+3. A new editor panel opens with the parsed and formatted JSON
+4. Edit the embedded JSON with full syntax highlighting and validation
+5. Save with `:w` to update the parent document (minified) or `:q` to cancel
+
+### Nested levels
+
+You can edit embedded JSON within embedded JSON:
+- The panel title shows the current nesting level: `Edit Embedded JSON (level 1)`
+- A `[+]` indicator appears when you have unsaved changes
+- `:w` saves and returns to the previous level
+- `:q!` discards changes and returns to the previous level
+
+### Example
+
+Given this JSON:
+```json
+{
+    "config": "{\"host\": \"localhost\", \"port\": 8080}"
+}
+```
+
+Using `ej` on the config line opens:
+```json
+{
+    "host": "localhost",
+    "port": 8080
+}
+```
+
+After editing and saving, the parent is updated with the minified result.
+
+## Keybindings
+
+### Movement
+| Key | Action |
+|-----|--------|
+| `h j k l` | Left/Down/Up/Right |
+| `w b` | Word forward/backward |
+| `0 $ ^` | Line start/end/first char |
+| `gg G` | File start/end |
+| `%` | Jump to matching bracket |
+| `PgUp PgDn` | Page up/down |
+| `Ctrl+d/u` | Half page down/up |
+
+### Search
+| Key | Action |
+|-----|--------|
+| `/` | Search forward |
+| `?` | Search backward |
+| `n N` | Next/previous match |
+| `$.` `$[` | JSONPath search (auto-detect) |
+| `\j` | JSONPath suffix for patterns |
+| `\c \C` | Case insensitive/sensitive |
+
+### Insert Mode
+| Key | Action |
+|-----|--------|
+| `i I` | Insert at cursor/line start |
+| `a A` | Append after cursor/line end |
+| `o O` | Open line below/above |
+
+### Editing
+| Key | Action |
+|-----|--------|
+| `x` | Delete char |
+| `dd` | Delete line |
+| `dw d$` | Delete word/to end |
+| `cw cc` | Change word/line |
+| `r{c}` | Replace char |
+| `J` | Join lines |
+| `yy p P` | Yank/paste after/before |
+| `u` | Undo |
+| `Ctrl+r` | Redo |
+| `.` | Repeat last edit |
+| `ej` | Edit embedded JSON string |
+
+### Commands
+| Command | Action |
+|---------|--------|
+| `:w` | Save |
+| `:w {file}` | Save as |
+| `:e {file}` | Open file |
+| `:fmt` | Format JSON |
+| `:q` | Quit |
+| `:q!` | Quit (discard changes) |
+| `:wq` | Save and quit |
+| `:help` | Toggle help panel |
+
+## License
+
+MIT

jvim-0.1.0/README.kr.md

@@ -0,0 +1,164 @@
+# jets
+
+**J**SON **E**ditor in **T**extual with vim-**S**tyle keybindings.
+
+[Textual](https://github.com/Textualize/textual) 기반의 vim 스타일 모달 JSON 편집기입니다.
+
+## 주요 기능
+
+- **Vim 스타일 모달 편집** - Normal, Insert, Command, Search 모드 지원
+- **구문 강조** - JSON 문법에 맞는 색상 표시
+- **JSON 검증** - 실시간 유효성 검사 및 오류 표시
+- **JSONPath 검색** - JSONPath 표현식으로 검색 (`$.foo.bar`)
+- **JSONL 지원** - JSON Lines 파일을 스마트하게 포맷팅하여 편집
+- **내장 JSON 편집** - JSON 내 문자열로 저장된 JSON을 중첩 레벨까지 편집
+- **괄호 매칭** - `%`로 짝이 맞는 괄호로 이동
+- **Undo/Redo** - 전체 실행 취소 기록 지원
+
+## 설치
+
+```bash
+pip install vim-json-editor
+```
+
+## 사용법
+
+```bash
+# 파일 열기
+vj data.json
+
+# 읽기 전용 모드로 열기
+vj -R data.json
+
+# 새 파일 생성
+vj newfile.json
+```
+
+## JSONL 지원
+
+vj는 JSON Lines (`.jsonl`) 파일을 특별하게 처리합니다:
+
+- **포맷팅된 편집**: 각 JSONL 레코드를 자동으로 들여쓰기하여 읽고 편집하기 쉽게 표시
+- **압축 저장**: 저장 시 각 레코드를 한 줄로 압축하여 JSONL 형식 유지
+- **레코드 번호**: 두 번째 열에 레코드 번호(1, 2, 3...)를 표시하여 쉽게 탐색
+- **플로팅 헤더**: 여러 줄에 걸친 레코드를 스크롤할 때 물리적 라인 번호가 상단에 표시
+
+예시: 두 개의 레코드가 있는 JSONL 파일:
+```
+{"name": "Alice", "age": 30}
+{"name": "Bob", "age": 25}
+```
+
+vj에서 열면:
+```
+{
+    "name": "Alice",
+    "age": 30
+}
+{
+    "name": "Bob",
+    "age": 25
+}
+```
+
+저장하면 원래의 압축된 형식으로 복원됩니다.
+
+## 내장 JSON 편집 (ej 모드)
+
+JSON 파일에는 종종 이스케이프된 JSON 문자열이 값으로 포함됩니다. vj는 이러한 중첩된 JSON 구조를 자연스럽게 편집할 수 있게 해줍니다.
+
+### 사용 방법
+
+1. JSON 문자열 값이 있는 라인에 커서를 위치
+2. Normal 모드에서 `ej` 입력
+3. 새 편집기 패널이 열리며 파싱되고 포맷팅된 JSON 표시
+4. 구문 강조와 유효성 검사가 적용된 상태로 내장 JSON 편집
+5. `:w`로 저장하여 부모 문서에 반영(압축됨) 또는 `:q`로 취소
+
+### 중첩 레벨
+
+내장 JSON 안의 내장 JSON도 편집할 수 있습니다:
+- 패널 제목에 현재 중첩 레벨 표시: `Edit Embedded JSON (level 1)`
+- 저장하지 않은 변경 사항이 있으면 `[+]` 표시
+- `:w`로 저장하고 이전 레벨로 복귀
+- `:q!`로 변경 사항을 버리고 이전 레벨로 복귀
+
+### 예시
+
+다음과 같은 JSON이 있을 때:
+```json
+{
+    "config": "{\"host\": \"localhost\", \"port\": 8080}"
+}
+```
+
+config 라인에서 `ej`를 사용하면:
+```json
+{
+    "host": "localhost",
+    "port": 8080
+}
+```
+
+편집 후 저장하면, 부모 문서에 압축된 결과가 반영됩니다.
+
+## 키 바인딩
+
+### 이동
+| 키 | 동작 |
+|-----|--------|
+| `h j k l` | 왼쪽/아래/위/오른쪽 |
+| `w b` | 단어 앞으로/뒤로 |
+| `0 $ ^` | 줄 시작/끝/첫 문자 |
+| `gg G` | 파일 시작/끝 |
+| `%` | 짝 괄호로 이동 |
+| `PgUp PgDn` | 페이지 위/아래 |
+| `Ctrl+d/u` | 반 페이지 아래/위 |
+
+### 검색
+| 키 | 동작 |
+|-----|--------|
+| `/` | 앞으로 검색 |
+| `?` | 뒤로 검색 |
+| `n N` | 다음/이전 매치 |
+| `$.` `$[` | JSONPath 검색 (자동 감지) |
+| `\j` | 패턴에 JSONPath 접미사 추가 |
+| `\c \C` | 대소문자 무시/구분 |
+
+### 삽입 모드
+| 키 | 동작 |
+|-----|--------|
+| `i I` | 커서 위치/줄 시작에 삽입 |
+| `a A` | 커서 뒤/줄 끝에 추가 |
+| `o O` | 아래/위에 새 줄 추가 |
+
+### 편집
+| 키 | 동작 |
+|-----|--------|
+| `x` | 문자 삭제 |
+| `dd` | 줄 삭제 |
+| `dw d$` | 단어/줄 끝까지 삭제 |
+| `cw cc` | 단어/줄 변경 |
+| `r{c}` | 문자 교체 |
+| `J` | 줄 합치기 |
+| `yy p P` | 복사/뒤에 붙여넣기/앞에 붙여넣기 |
+| `u` | 실행 취소 |
+| `Ctrl+r` | 다시 실행 |
+| `.` | 마지막 편집 반복 |
+| `ej` | 내장 JSON 문자열 편집 |
+
+### 명령어
+| 명령어 | 동작 |
+|---------|--------|
+| `:w` | 저장 |
+| `:w {file}` | 다른 이름으로 저장 |
+| `:e {file}` | 파일 열기 |
+| `:fmt` | JSON 포맷팅 |
+| `:q` | 종료 |
+| `:q!` | 변경 사항 버리고 종료 |
+| `:wq` | 저장하고 종료 |
+| `:help` | 도움말 패널 토글 |
+
+## 라이선스
+
+MIT

jvim-0.1.0/README.md

@@ -0,0 +1,164 @@
+# jets
+
+**J**SON **E**ditor in **T**extual with vim-**S**tyle keybindings.
+
+[한국어](README.kr.md)
+
+## Features
+
+- **Vim-style modal editing** - Normal, Insert, Command, and Search modes
+- **Syntax highlighting** - JSON-aware colorization
+- **JSON validation** - Real-time validation with error reporting
+- **JSONPath search** - Search using JSONPath expressions (`$.foo.bar`)
+- **JSONL support** - Edit JSON Lines files with smart formatting
+- **Embedded JSON editing** - Edit JSON strings within JSON with nested level support
+- **Bracket matching** - Jump to matching brackets with `%`
+- **Undo/Redo** - Full undo history
+
+## Installation
+
+```bash
+pip install vim-json-editor
+```
+
+## Usage
+
+```bash
+# Open a file
+vj data.json
+
+# Open in read-only mode
+vj -R data.json
+
+# Create new file
+vj newfile.json
+```
+
+## JSONL Support
+
+vj provides special handling for JSON Lines (`.jsonl`) files:
+
+- **Pretty-printed editing**: Each JSONL record is automatically formatted with indentation for easy reading and editing
+- **Compact saving**: When you save, each record is minified back to a single line, preserving the JSONL format
+- **Record numbers**: A second column shows the record number (1, 2, 3...) for easy navigation
+- **Floating header**: When scrolling through a multi-line record, the physical line number stays visible at the top
+
+Example: A JSONL file with two records:
+```
+{"name": "Alice", "age": 30}
+{"name": "Bob", "age": 25}
+```
+
+Opens in vj as:
+```
+{
+    "name": "Alice",
+    "age": 30
+}
+{
+    "name": "Bob",
+    "age": 25
+}
+```
+
+And saves back to the original compact format.
+
+## Embedded JSON Editing
+
+JSON files often contain escaped JSON strings as values. vj lets you edit these nested JSON structures naturally.
+
+### How it works
+
+1. Position your cursor on a line containing a JSON string value
+2. Type `ej` in normal mode
+3. A new editor panel opens with the parsed and formatted JSON
+4. Edit the embedded JSON with full syntax highlighting and validation
+5. Save with `:w` to update the parent document (minified) or `:q` to cancel
+
+### Nested levels
+
+You can edit embedded JSON within embedded JSON:
+- The panel title shows the current nesting level: `Edit Embedded JSON (level 1)`
+- A `[+]` indicator appears when you have unsaved changes
+- `:w` saves and returns to the previous level
+- `:q!` discards changes and returns to the previous level
+
+### Example
+
+Given this JSON:
+```json
+{
+    "config": "{\"host\": \"localhost\", \"port\": 8080}"
+}
+```
+
+Using `ej` on the config line opens:
+```json
+{
+    "host": "localhost",
+    "port": 8080
+}
+```
+
+After editing and saving, the parent is updated with the minified result.
+
+## Keybindings
+
+### Movement
+| Key | Action |
+|-----|--------|
+| `h j k l` | Left/Down/Up/Right |
+| `w b` | Word forward/backward |
+| `0 $ ^` | Line start/end/first char |
+| `gg G` | File start/end |
+| `%` | Jump to matching bracket |
+| `PgUp PgDn` | Page up/down |
+| `Ctrl+d/u` | Half page down/up |
+
+### Search
+| Key | Action |
+|-----|--------|
+| `/` | Search forward |
+| `?` | Search backward |
+| `n N` | Next/previous match |
+| `$.` `$[` | JSONPath search (auto-detect) |
+| `\j` | JSONPath suffix for patterns |
+| `\c \C` | Case insensitive/sensitive |
+
+### Insert Mode
+| Key | Action |
+|-----|--------|
+| `i I` | Insert at cursor/line start |
+| `a A` | Append after cursor/line end |
+| `o O` | Open line below/above |
+
+### Editing
+| Key | Action |
+|-----|--------|
+| `x` | Delete char |
+| `dd` | Delete line |
+| `dw d$` | Delete word/to end |
+| `cw cc` | Change word/line |
+| `r{c}` | Replace char |
+| `J` | Join lines |
+| `yy p P` | Yank/paste after/before |
+| `u` | Undo |
+| `Ctrl+r` | Redo |
+| `.` | Repeat last edit |
+| `ej` | Edit embedded JSON string |
+
+### Commands
+| Command | Action |
+|---------|--------|
+| `:w` | Save |
+| `:w {file}` | Save as |
+| `:e {file}` | Open file |
+| `:fmt` | Format JSON |
+| `:q` | Quit |
+| `:q!` | Quit (discard changes) |
+| `:wq` | Save and quit |
+| `:help` | Toggle help panel |
+
+## License
+
+MIT

jvim-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "jvim"
+version = "0.1.0"
+description = "A modal JSON editor built with Textual, featuring vim-style keybindings"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Kihyun Kim", email = "k2hyun@gmail.com" }
+]
+keywords = ["json", "editor", "vim", "tui", "textual", "jsonl", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Text Editors",
+    "Topic :: Utilities",
+]
+dependencies = [
+    "textual>=0.70.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-asyncio>=0.23",
+    "textual-dev>=1.0",
+]
+
+[project.scripts]
+vj = "jets.app:main"
+
+[project.urls]
+Homepage = "https://github.com/k2hyun/jets"
+Repository = "https://github.com/k2hyun/jets"
+Issues = "https://github.com/k2hyun/jets/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/jets"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

jvim-0.1.0/src/jets/__init__.py

@@ -0,0 +1,6 @@
+"""jets: JSON Editor in Textual."""
+
+from .editor import EditorMode, JsonEditor
+
+__all__ = ["EditorMode", "JsonEditor"]
+__version__ = "0.1.0"

jvim-0.1.0/src/jets/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running with `python -m jets`."""
+
+from .app import main
+
+main()