nbcat 0.9.0__py3-none-any.whl → 0.9.3__py3-none-any.whl

nbcat/__init__.py

@@ -1 +1 @@
-__version__ = "0.9.0"
+__version__ = "0.9.3"

nbcat/main.py

@@ -26,7 +26,7 @@ from .schemas import Cell, Notebook
 console = Console()
 
 
-def read_notebook(fp: str) -> Notebook:
+def read_notebook(fp: str, debug: bool = False) -> Notebook:
     """
     Load and parse a Jupyter notebook from a local file or remote URL.
 
@@ -61,6 +61,8 @@ def read_notebook(fp: str) -> Notebook:
     try:
         return Notebook.model_validate_json(content)
     except ValidationError as e:
+        if not debug:
+            raise InvalidNotebookFormatError("Failed to read notebook")
         raise InvalidNotebookFormatError(f"Invalid notebook: {e}")
 
 
@@ -84,19 +86,16 @@ def render_cell(cell: Cell) -> list[tuple[str | None, RenderableType]]:
         return Markdown(input)
 
     def _render_code(input: str) -> Panel:
-        return Panel(Syntax(input, "python", line_numbers=True, theme="ansi_dark"), box=box.SQUARE)
+        return Panel(Syntax(input, "python", theme="ansi_dark"), box=box.SQUARE)
 
     def _render_raw(input: str) -> Text:
         return Text(input)
 
-    def _render_heading(input: str) -> Text:
-        return Text(input)
-
     RENDERERS = {
         CellType.MARKDOWN: _render_markdown,
         CellType.CODE: _render_code,
         CellType.RAW: _render_raw,
-        CellType.HEADING: _render_heading,
+        CellType.HEADING: _render_markdown,
     }
 
     rows: list[tuple[str | None, RenderableType]] = []
@@ -159,11 +158,14 @@ def main():
         action="version",
         version=__version__,
     )
+    parser.add_argument(
+        "--debug", help="enable extended error output", action="store_true", default=False
+    )
 
     try:
         argcomplete.autocomplete(parser)
         args = parser.parse_args()
-        notebook = read_notebook(args.file)
+        notebook = read_notebook(args.file, debug=args.debug)
         print_notebook(notebook)
     except Exception as e:
         sys.exit(f"nbcat: {e}")

nbcat/schemas.py

@@ -70,7 +70,7 @@ class Cell(BaseModel):
     @property
     def input(self) -> str:
         if self.cell_type == CellType.HEADING and self.level is not None:
-            return f"{'#' * self.level} {self.source}"
+            return f"{'#' * self.level} {''.join(self.source)}"
 
         if isinstance(self.source, list):
             return "".join(self.source)
@@ -87,7 +87,7 @@ class Notebook(BaseModel):
     def handle_format_versions(cls, data: dict[str, Any]) -> dict[str, Any]:
         if data.get("worksheets"):
             try:
-                data["cells"] = data.get("worksheets")[0].get("cells", [])
+                data["cells"] = data.get("worksheets", [{"cells": []}])[0].get("cells", [])
             except (KeyError, IndexError, TypeError) as e:
                 print(e)
                 raise InvalidNotebookFormatError(f"Invalid v3 notebook structure: {e}")

{nbcat-0.9.0.dist-info → nbcat-0.9.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nbcat
-Version: 0.9.0
+Version: 0.9.3
 Summary: cat for jupyter notebooks
 Project-URL: Homepage, https://github.com/akopdev/nbcat
 Project-URL: Repository, https://github.com/akopdev/nbcat
@@ -43,48 +43,39 @@ Description-Content-Type: text/markdown
 
 # 📦 nbcat
 
-cat for jupyter notebooks
-
-[![License](https://img.shields.io/github/license/akopdev/nbcat)](./LICENSE)
-[![Build](https://github.com/akopdev/nbcat/actions/workflows/ci.yml/badge.svg)](https://github.com/akopdev/nbcat/actions)
-
----
+`nbcat` lets you preview Jupyter notebooks directly in your terminal. Think of it as `cat`, but for `.ipynb` files.
 
 ## 🚀 Features
 
-- ✅ Clean, minimal API
-- 🧰 Easily extensible
-- 🧪 Fully tested and type-annotated
-- ⚡ Fast and lightweight
-- 📦 Available on PyPI
-
----
+- Fast and lightweight with minimal external dependencies
+- Preview remote notebooks without downloading them
+- Supports for all Jupyter notebook versions - including legacy formats 
 
 ## 📦 Installation
 
-Install with [uv](https://github.com/astral-sh/uv)
+From the command line using pip:
 
 ```bash
-uv pip install nbcat
+pip install nbcat
 ```
 
-To install the latest development version:
+## 🛠️ Quickstart
 
 ```bash
-uv pip install git+https://github.com/akopdev/nbcat.git
+$ nbcat notebook.ipynb
 ```
 
----
-
-## 🛠️ Quickstart
+You can pass URLs as well.
 
-```python
-# example of using the package
+```bash
+$ nbcat https://raw.githubusercontent.com/akopdev/nbcat/refs/heads/main/tests/assets/test4.ipynb
 ```
 
-For more examples, check out the [`examples/`](./examples/) folder.
+Example use case with `fzf` command that lists all `.ipynb` files and uses `nbcat` for previewing them:
 
----
+```bash
+find . -type f -name "*.ipynb" | fzf --preview 'nbcat {}'
+```
 
 ## 🧪 Testing & Development
 
@@ -97,29 +88,17 @@ make test
 Check code quality:
 
 ```bash
-make lint
-```
-
-Format code:
-
-```bash
-make format
+make format lint
 ```
 
----
-
 ## 🙌 Contributing
 
 Contributions are welcome! Please open an issue or [pull request](https://github.com/akopdev/nbcat/pulls).
 
----
-
 ## 📄 License
 
 Distributed under the MIT License. See [`LICENSE`](./LICENSE) for more information.
 
----
-
 ## 🔗 Useful Links
 
 - 📘 Documentation: _coming soon_
@@ -128,4 +107,4 @@ Distributed under the MIT License. See [`LICENSE`](./LICENSE) for more informati
 
 ---
 
-> Made with ❤️ by [Akop Kesheshyan](https://github.com/akopdev)
+Made with ❤️ by [Akop Kesheshyan](https://github.com/akopdev)

nbcat-0.9.3.dist-info/RECORD

@@ -0,0 +1,11 @@
+nbcat/__init__.py,sha256=xKd3pzbczuMsdB08eLAOqZDUd_q1IRxwZ_ccAFL4c4A,22
+nbcat/enums.py,sha256=ZsuOwYLF0D4PVwSkS74LwoXY0y0DkeBToLBWnmiS97Y,300
+nbcat/exceptions.py,sha256=Ho7LQz9K70VtIMDNtAwuAtGmb-lFKxGxSj7MN3-EpDA,321
+nbcat/main.py,sha256=X1UbLxXF9Y9V4Z8vE_pUz5cG22zx2oBMMlvpJVWITD0,5236
+nbcat/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nbcat/schemas.py,sha256=IK1l2a4UcP6Ivh8xRBzV5BIQTbeES1b1cCH-6goEq8Q,2366
+nbcat-0.9.3.dist-info/METADATA,sha256=IQV8OPxQ0sQFu1BdLK9g6z5-nSv4j36rUhaMJYv0FQ0,3376
+nbcat-0.9.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nbcat-0.9.3.dist-info/entry_points.txt,sha256=io_GRDsecAkYuCZALsjyea3VBq91VCoSznqlZEAJshY,42
+nbcat-0.9.3.dist-info/licenses/LICENSE,sha256=7GjUnahXdd5opdvlpJdb1BisLbiXt2iOFhzIUduhdkE,1072
+nbcat-0.9.3.dist-info/RECORD,,

nbcat-0.9.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-nbcat/__init__.py,sha256=H9NWRZb7NbeRRPLP_V1fARmLNXranorVM-OOY-8_2ug,22
-nbcat/enums.py,sha256=ZsuOwYLF0D4PVwSkS74LwoXY0y0DkeBToLBWnmiS97Y,300
-nbcat/exceptions.py,sha256=Ho7LQz9K70VtIMDNtAwuAtGmb-lFKxGxSj7MN3-EpDA,321
-nbcat/main.py,sha256=YwFqpt_wZLwqFzlxr9Hon_9QbWYEpAaDzLDsi2t-U3s,5072
-nbcat/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nbcat/schemas.py,sha256=F5Wl0ZWa5j8RK4H98nDJm69h3oecEuP6wu62823Cxyg,2340
-nbcat-0.9.0.dist-info/METADATA,sha256=CVTz2g79Sr9_moJraY6pkks5gXqTZMdvFMqszPBnqMY,3412
-nbcat-0.9.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-nbcat-0.9.0.dist-info/entry_points.txt,sha256=io_GRDsecAkYuCZALsjyea3VBq91VCoSznqlZEAJshY,42
-nbcat-0.9.0.dist-info/licenses/LICENSE,sha256=7GjUnahXdd5opdvlpJdb1BisLbiXt2iOFhzIUduhdkE,1072
-nbcat-0.9.0.dist-info/RECORD,,