jnav 1.0.0__py3-none-any.whl

jnav-1.0.0.dist-info/METADATA

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: jnav
+Version: 1.0.0
+Summary: Interactive JSON log viewer with jq filtering for the terminal
+Keywords: json,log,viewer,jq,tui,terminal
+Author: Tibo Clausen
+License-Expression: GPL-3.0-only
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: System :: Logging
+Classifier: Topic :: Utilities
+Requires-Dist: textual>=1.0.0
+Requires-Dist: click>=8.1.0
+Requires-Dist: jq>=1.8.0
+Requires-Dist: python-json-logger>=4.0.0
+Requires-Dist: aioreactive>=0.20.0
+Requires-Dist: orjson>=3.11.8
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: platformdirs>=4.0.0
+Requires-Python: >=3.14
+Project-URL: Repository, https://github.com/XenotriX/jnav
+Description-Content-Type: text/markdown
+
+<p>
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://github.com/XenotriX/jnav/blob/d28e3701ec1fa795958db0da7293169ff2887e58/docs/logo/jnav_logo_dark.svg">
+    <source media="(prefers-color-scheme: light)" srcset="https://github.com/XenotriX/jnav/blob/d28e3701ec1fa795958db0da7293169ff2887e58/docs/logo/jnav_logo_light.svg">
+    <img alt="jnav" src="https://github.com/XenotriX/jnav/blob/d28e3701ec1fa795958db0da7293169ff2887e58/docs/logo/jnav_logo_dark.svg">
+  </picture>
+</p>
+
+Interactive JSON log viewer with [jq](https://jqlang.github.io/jq/) filtering. Navigate, search, filter, and inspect structured logs in the terminal.
+
+![screenshot](https://raw.githubusercontent.com/XenotriX/jnav/360911e954d91e267616508384ca2e7814c22913/screenshot.png)
+
+## Install
+
+```bash
+uv tool install jnav
+```
+
+or
+
+```bash
+pipx install jnav
+```
+
+## Usage
+
+```bash
+# Open a log file
+$ jnav app.log
+
+# Follow the file for new entries (like tail -f)
+$ jnav --follow app.log
+
+# Pipe JSONL from stdin
+$ cat logs.jsonl | jnav
+```
+
+## Features
+
+### Filtering
+
+Filters use jq expressions. Clauses are organized in a tree of AND/OR groups, which gets compiled into a single jq expression used to evaluate each entry.
+
+```python
+.level == "error"                                   # exact match
+.data.user_id | IN("abc123", "def456", "ghi789")    # match any of
+.message | contains("timeout")                      # substring
+.message | test("connection (refused|reset)")       # regex
+.status >= 500                                      # numeric comparison
+.items | any(.name == "widget")                     # list predicate
+```
+
+https://github.com/user-attachments/assets/4c5fa668-7c37-4b59-97f5-4962aeb12504
+
+### Selected Fields
+
+Selectors are jq expressions evaluated per entry, rendered inline next to the summary. They can index arrays, aggregate, or reshape strings.
+
+```python
+.status                                # plain field
+.items[0].name                         # array index
+.items | length                        # computed
+.items | map("\(.name): \(.qty)")      # string interpolation over a list
+.build | split("-")[1] | tonumber      # extract a number from a string
+.request.headers.user_agent            # deep path
+```
+
+Add from the detail panel with `s`, or open the selectors manager with `S` to add, edit, reorder, and toggle them.
+
+
+https://github.com/user-attachments/assets/a9e93048-c3e8-44e6-9f82-727b8e9f8d10
+
+### JSON String Expansion
+
+Values that are JSON-encoded strings (e.g. `"data": "{\"key\": \"value\"}"`) are automatically parsed and displayed as nested objects. The tree view shows `"{}"` in italic to distinguish them from real objects. Filters and selectors work through expanded JSON strings transparently.
+
+### Live Tailing
+
+With `--follow`, jnav watches the file for new lines (like `tail -f`). New entries are parsed, filtered, and appended to the view. If you're at the bottom of the list, it auto-scrolls to show new entries.
+
+### Session Persistence
+
+Filters, selected fields, scroll position, panel state, and search terms are saved when you quit and restored when reopening the same file. State is stored in `~/.local/share/jnav/`.
+
+## Keybindings
+
+### Navigation
+
+| Key                 | Action                      |
+| ------------------- | --------------------------- |
+| `j` / `k`           | Move up/down                |
+| `gg` / `G`          | Jump to first/last entry    |
+| `Ctrl+D` / `Ctrl+U` | Half-page scroll            |
+| `h` / `l`           | Focus list / detail panel   |
+| `Enter`             | Inspect entry (open detail) |
+| `Escape`            | Back                        |
+
+### Search and Filter
+
+| Key       | Action                                             |
+| --------- | -------------------------------------------------- |
+| `/`       | Search (highlights matches, does not hide entries) |
+| `n` / `N` | Next / previous search match                       |
+| `F`       | Filter manager (jq expressions)                    |
+| `ft`      | Quick text filter                                  |
+| `fp`      | Pause / resume filters                             |
+| `Escape`  | Clear search                                       |
+| `r`       | Reset filters, fields, and search                  |
+
+### Display
+
+| Key  | Action                                   |
+| ---- | ---------------------------------------- |
+| `S`  | Selected fields manager                  |
+| `vi` | Toggle inline expanded tree in list rows |
+| `d`  | Toggle detail panel                      |
+| `?`  | Help                                     |
+| `q`  | Quit                                     |
+
+### Detail Panel
+
+| Key  | Action                                   |
+| ---- | ---------------------------------------- |
+| `s`  | Select (or deselect) the field           |
+| `ff` | Filter by value of the highlighted field |
+| `fn` | Filter: entries that have this field     |
+| `ve` | View the value in `$EDITOR`              |
+| `vo` | Show only selected fields                |
+
+### Filter Manager
+
+| Key             | Action                     |
+| --------------- | -------------------------- |
+| `a`             | Add filter clause          |
+| `g`             | Add group                  |
+| `e`             | Edit clause                |
+| `d` / `y` / `p` | Cut / yank / paste         |
+| `t`             | Enable / disable           |
+| `o`             | Toggle AND / OR on a group |
+| `n`             | Negate                     |
+| `c`             | Flatten group              |
+| `r`             | Rename                     |
+| `Escape`        | Close                      |
+
+### Selected Fields Manager
+
+| Key             | Action             |
+| --------------- | ------------------ |
+| `a`             | Add selector       |
+| `e`             | Edit selector      |
+| `d` / `y` / `p` | Cut / yank / paste |
+| `t`             | Enable / disable   |
+| `Escape`        | Close              |
+
+## Credits
+
+- [lnav](https://github.com/tstack/lnav): the main inspiration: an interactive log viewer with structured querying
+- [hl](https://github.com/pamburus/hl): shaped several design decisions around how JSON log entries should look
+- [Open Color](https://yeun.github.io/open-color/): the palette the theme is built on

jnav-1.0.0.dist-info/RECORD

@@ -0,0 +1,37 @@
+jnav/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+jnav/__main__.py,sha256=QOQsLe1gcri1Uxj4wzsWVzAdE5g2qqr0gDajClfHLa8,2966
+jnav/app.py,sha256=c5mE71O7WI9rX2MUoErDwtYL_a0EeyBcl6MYjd4rFU0,13765
+jnav/buffer.py,sha256=K4Mv970YDb3qmvSARLIGoRPnx75BIJN9f22B7bK8Bko,1673
+jnav/detail_tree.py,sha256=Oi6dl7QPUIM13b8DB9gZOzpfUUlI7cEhOVPjeedg-Zo,7956
+jnav/field_mapping.py,sha256=CO3IXGH5NtbjOimKKWtCbZaGLmR_MlAagDIkKWWRG-Y,3603
+jnav/filter_manager_screen.py,sha256=rs-voeCvsngD4b39zRelWGPOoIlJGV5JAuc_me6umHs,2792
+jnav/filter_provider.py,sha256=3xqBhQVS0yma72ic6dubBU_ZMgKbdCPz6kXNksPJa4Q,3350
+jnav/filter_tree.py,sha256=J-vYfTyphD0gD4vLusBp-5xeasRxf3QJ1yHOIbuR1Bc,11157
+jnav/filtering.py,sha256=vBehFDHOdJGrO3wGNqfZ3solnDv05PJwP2Nyw3iwN0k,5586
+jnav/header.py,sha256=yHWOlZMUPNND03Pm4EzcgrDewNna2US9zy04_y1n3f0,1166
+jnav/help_screen.py,sha256=kfHROpgxUmDxfftKGNhoA9rHceCgAmByqE4x34INBBM,2155
+jnav/inline_tree.py,sha256=0-7zRLIgGSF6yOeNpruOZOHQT3nZIhmcZNLQbk60zhc,2055
+jnav/key_sequences.py,sha256=1NL0LbKyyg8URxPVCC1-GT6JZbK0d58ARKiIh2SMtu4,7506
+jnav/log_entry_item.py,sha256=XjJMnC-FlsxxBJ0fZbRDIHWTGmiXJMEY8POkKSTeSGI,3187
+jnav/log_entry_renderer.py,sha256=gcgNvG0SaFRdSOBaOqhgNtV_bc7_zqg2fyTCEcylUi8,2595
+jnav/log_list_view.py,sha256=FVUKTlhRNDp9v7FNFH1HdZFXZHsKpJbc5FSwVeJT7NE,10443
+jnav/log_model.py,sha256=CLHfGwdTApDEm2huBCeSlc5ZGVYkUhRFZsV5n3uQjrQ,3616
+jnav/logging.py,sha256=yHyciDTaExPgzYY98NeIH1JeyBBfZvCk3IvPsJeK6Js,1531
+jnav/manager_screen_common.py,sha256=2NLx7KxB_Uc40HW0l0N2Wmw-ukcTFbHnKKCXzQK2d8o,775
+jnav/model.py,sha256=LNqYL6C6Mba8s938734eGQ802_7GqVXMS5iPUY3KYX8,316
+jnav/offset_group.py,sha256=GhafG2IF5sPXqBvsHGvq_RLBuJfXC42NVRxX8_2pF2U,926
+jnav/parsing.py,sha256=e7BPwst-WKVAsKPxxUQyHdf-kw7vzBwWo5ItzaMQ8zU,2882
+jnav/reading.py,sha256=_GYsENtilHN2k99Gcx7T6iCViHRK7BsivmiPxs1vSEg,1554
+jnav/role_mapper.py,sha256=KXuTvb0t-184HtU1TZ1tG_kp04MNic7RlhlzinyIs_w,1714
+jnav/scrollbar_overlay.py,sha256=9ZB1zKun_0wq2HSj-SffCDmVUhtHbWnIXjNdNSKeiKs,2735
+jnav/search_engine.py,sha256=q7zcvgO8mBrGTGOw9hfnBaEFA7p-YPAR1_wDdOCbqoM,2505
+jnav/selector_manager_screen.py,sha256=fWlWQS_0PwuvuTLJuyTjcFeYwUW2_l09PkjQBp03xIw,6053
+jnav/selector_provider.py,sha256=Y4vSi1VF1VQFB0RCiNZZmefSFcagljulxnd7HN_XP1w,2065
+jnav/store.py,sha256=v2bGRTF-Cza1n-FqlujDKu23pykDVKUcjIPD07feIDE,982
+jnav/text_input_screen.py,sha256=0Qfdaq-iOzBdkyBNI5FmQfmbQI5a9Y52zt_Qex5T_0Y,1693
+jnav/tree_rendering.py,sha256=B7Ql99Q4IDjKECSzHUsac4BpnAa3azN7o89utfRA7-s,6515
+jnav/virtual_list_view.py,sha256=3ZBbeuLeRU-07aymn4HMnND_nI5nCeqfWNFQkgnfCSQ,12568
+jnav-1.0.0.dist-info/WHEEL,sha256=eh7sammvW2TypMMMGKgsM83HyA_3qQ5Lgg3ynoecH3M,79
+jnav-1.0.0.dist-info/entry_points.txt,sha256=iKyF9p2eMdUVndwBC7RLIReTlIC9xG7M5ySMbsUdHQk,45
+jnav-1.0.0.dist-info/METADATA,sha256=NnSibuis_IcOShNhexuMSPF42W6RDOf3POnAIutnJ9M,7276
+jnav-1.0.0.dist-info/RECORD,,

jnav-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.8.24
+Root-Is-Purelib: true
+Tag: py3-none-any

jnav-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+jnav = jnav.__main__:main
+