bigyahu 0.1.0__tar.gz

bigyahu-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: bigyahu
+Version: 0.1.0
+Summary: Retrieve code snippets stored as ipynb notebooks via by.list() and by.get()
+Author: bigyahu
+Requires-Python: >=3.8

bigyahu-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bigyahu"
+version = "0.1.0"
+description = "Retrieve code snippets stored as ipynb notebooks via by.list() and by.get()"
+requires-python = ">=3.8"
+authors = [{ name = "bigyahu" }]
+dependencies = []
+
+[project.scripts]
+bigyahu = "bigyahu.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+bigyahu = ["codes/*.ipynb"]

bigyahu-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

bigyahu-0.1.0/src/bigyahu/__init__.py

@@ -0,0 +1,83 @@
+"""bigyahu - retrieve stored code snippets from ipynb notebooks.
+
+Usage::
+
+    import bigyahu as by
+    by.list()          # list available code snippet names
+    by.get("name")     # print the code of snippet "name" as-is
+"""
+
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import List
+
+# Capture the builtin list type before we shadow the name with our list() function.
+_builtin_list = list
+
+__version__ = "0.1.0"
+
+# Directory (relative to this package) that holds the stored .ipynb snippets.
+_CODES_DIR = Path(__file__).parent / "codes"
+
+
+def _notebook_path(name: str) -> Path:
+    """Resolve a snippet name to its .ipynb file path."""
+    # Accept names with or without the .ipynb extension.
+    if name.endswith(".ipynb"):
+        return _CODES_DIR / name
+    return _CODES_DIR / f"{name}.ipynb"
+
+
+def list() -> List[str]:
+    """Return the list of available code snippet names.
+
+    Each name corresponds to a ``.ipynb`` file inside the bundled
+    ``bigyahu/codes`` directory (extension stripped).
+    """
+    if not _CODES_DIR.is_dir():
+        return []
+    names = sorted(p.stem for p in _CODES_DIR.glob("*.ipynb"))
+    return names
+
+
+def _load_cells(name: str):
+    """Load and return the code cells of a notebook as a list of source strings."""
+    path = _notebook_path(name)
+    if not path.exists():
+        available = ", ".join(list()) or "(none)"
+        raise FileNotFoundError(
+            f"Notebook '{name}' not found. Available snippets: {available}"
+        )
+
+    with path.open("r", encoding="utf-8") as fh:
+        nb = json.load(fh)
+
+    cells = nb.get("cells", [])
+    code_cells = []
+    for cell in cells:
+        if cell.get("cell_type") != "code":
+            continue
+        source = cell.get("source", [])
+        if isinstance(source, _builtin_list):
+            code_cells.append("".join(source))
+        else:
+            code_cells.append(str(source))
+    return code_cells
+
+
+def get(name: str) -> str:
+    """Print the code of snippet ``name`` as it appears in the ipynb and return it.
+
+    Only code cells are included (markdown/raw cells are skipped). The code is
+    printed exactly as stored, cell by cell.
+    """
+    code_cells = _load_cells(name)
+    code = "\n\n# --- cell ---\n\n".join(code_cells)
+    print(code)
+    return code
+
+
+# Expose convenience aliases so both ``by.list()`` and ``by.get()`` work.
+__all__ = ["list", "get"]

bigyahu-0.1.0/src/bigyahu/__main__.py

@@ -0,0 +1,33 @@
+"""Command-line entry point for the bigyahu package."""
+
+import sys
+import bigyahu
+
+
+def main(argv=None) -> int:
+    argv = list(sys.argv[1:]) if argv is None else list(argv)
+
+    if not argv:
+        print("Usage: bigyahu list | get <name>")
+        return 1
+
+    command = argv[0].lower()
+    if command == "list":
+        for name in bigyahu.list():
+            print(name)
+        return 0
+
+    if command == "get":
+        if len(argv) < 2:
+            print("Usage: bigyahu get <name>")
+            return 1
+        bigyahu.get(argv[1])
+        return 0
+
+    print(f"Unknown command: {command}")
+    print("Usage: bigyahu list | get <name>")
+    return 1
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

bigyahu-0.1.0/src/bigyahu/_version.py

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

bigyahu-0.1.0/src/bigyahu/codes/example.ipynb

@@ -0,0 +1,50 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "example-hello",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "print(\"Hello from bigyahu!\")\n",
+    "x = 42\n",
+    "print(x)\n"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "example-md",
+   "metadata": {},
+   "source": [
+    "This markdown cell should be skipped by get().\n"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "example-second",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "def add(a, b):\n",
+    "    return a + b\n",
+    "\n",
+    "print(add(2, 3))\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "name": "python",
+   "version": "3.14.6"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

bigyahu-0.1.0/src/bigyahu.egg-info/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: bigyahu
+Version: 0.1.0
+Summary: Retrieve code snippets stored as ipynb notebooks via by.list() and by.get()
+Author: bigyahu
+Requires-Python: >=3.8

bigyahu-0.1.0/src/bigyahu.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+pyproject.toml
+src/bigyahu/__init__.py
+src/bigyahu/__main__.py
+src/bigyahu/_version.py
+src/bigyahu.egg-info/PKG-INFO
+src/bigyahu.egg-info/SOURCES.txt
+src/bigyahu.egg-info/dependency_links.txt
+src/bigyahu.egg-info/entry_points.txt
+src/bigyahu.egg-info/top_level.txt
+src/bigyahu/codes/example.ipynb

bigyahu-0.1.0/src/bigyahu.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bigyahu-0.1.0/src/bigyahu.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bigyahu = bigyahu.__main__:main

bigyahu-0.1.0/src/bigyahu.egg-info/top_level.txt

@@ -0,0 +1 @@
+bigyahu