pnbp 0.9.0

pnbp = "pretty notebook parser"

0.9.0: The published package supports the Python library and pnbp command-line interface on Python 3.11 or newer. Install it with python -m pip install pnbp==0.9.0. See the release notes for migration and support details.

pnbp provides programmatic access to a notebook via :

• > pnbp/models : models and methods.
  • access notes and their individual (regex established) components in the python repl, scripts, and your own shell commands.
• > pnbp/commands : shell commands.
  • run pre-defined function against a notebook in the terminal directly, or, scheduled.

---

a pretty notebook is the collection of markdown files in a specific directory. a pretty note is a single .md file within the notebook directory.

links ( [[link]] , ![[link.jpg]] ), tags ( #tag ), codeblocks ( ```py print("Hello World")``` ), and urls ( [goog](https://google.com) ) are the main components outside of additional render syntax of a .md note using an extended linking and tagging markdown.

https://obsidian.md/ is the best example of this in action.

quickstart guide :

(0) -> update pip, then install the exact release

python -m pip install --upgrade pip
python -m pip install pnbp==0.9.0

(1) -> access via the Notebook model

(2) -> cli commands

(3) -> web application / api (supported only in the documented single-worker, single-notebook topology; not included in the pnbp wheel)

(4) -> “pnano” (experimental/unsupported in 0.9.0)

(-1) -> git clone the repo.

git clone https://github.com/outside-labs/Pretty-Notebook/ pnbp
cd pnbp/
python -m pip install --editable . # development checkout, including the pnbp CLI

(2) -> set environment variables.

NOTE_NESTED

• "flat" - by default, pnbp assumes that every .md note exist within the base directory level of NOTE_PATH/.
• "single" - if you want pnbp to search for .md notes within additional (non-hidden) directory level up.
• "recurs" - if you want .md notes to be found through all (non-hidden) directory levels up.
• "all" - if you want even hidden (non- .git, .obsidian) directories traversed recursively up.

PNBP_SETTINGS

• without PNBP_SETTINGS="off", "NOTE_PATH/pnbp_settings.json" will be nagged for.
• Notebook can generate one at the python prompt that you can edit later ->

( ... on Windows? Environment Variable(s) can be set here. Also, recall that in most places you'll also need to escape the "\" within any path strings (e.g. "IMG_PATH": "\\Users\\alice\\notebook\\imgs") used; the drive letter (e.g. "D:\\Media\imgs") is optional if it's your %HOMEDRIVE%. )

(3) -> access your notes in python3.11+ !

>>> import pnbp
>>> nb = pnbp.Notebook()
...