From 22c2eb9b4302854e92b8b79bbea6021478726abb Mon Sep 17 00:00:00 2001 From: Rob Lauer Date: Wed, 11 Nov 2026 10:34:39 -0600 Subject: [PATCH 1/2] feat: add context7.json so Context7 indexes the usage docs Context7 is the docs index coding agents query through its MCP server. This file limits it to the README, API.md, and the example READMEs, keeps the outdated Doxygen export in docs/ out of the index, and gives agents rules for installing, opening a port, Transaction(), and the fluent helpers. The url and public_key fields claim the library for the Blues Context7 account. Co-Authored-By: Claude Opus 5.5 --- context7.json | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) create mode 100644 context7.json diff --git a/context7.json b/context7.json new file mode 100644 index 0000000..f83308e --- /dev/null +++ b/context7.json @@ -0,0 +1,29 @@ +{ + "$schema": "https://context7.com/schema/context7.json", + "url": "https://context7.com/blues/note-python", + "public_key": "pk_nVFOrz6sC1j4Aqx8A32xw", + "projectTitle": "note-python: Python library for Blues Notecard", + "description": "Python library for communicating with Blues Notecard over Serial or I2C from CPython (desktop and Raspberry Pi), MicroPython, and CircuitPython. It sends Notecard API requests as Python dicts and includes optional fluent helper modules (card, hub, note, env, file, and others) generated from the Notecard API schema.", + "excludeFolders": [ + ".github", + "docs", + "test", + "mpy_board", + "scripts" + ], + "excludeFiles": [ + "CONTRIBUTING.md", + "CODE_OF_CONDUCT.md" + ], + "rules": [ + "Install with pip install note-python but import it as notecard. On MicroPython and CircuitPython, copy the repo's notecard directory to lib/notecard on the device instead of using pip.", + "On Linux and macOS CPython, import notecard requires the python-periphery package even for Serial, but note-python does not declare it as a dependency. Install it, plus pyserial for Serial ports.", + "Create the port and pass it in: notecard.OpenSerial(port) with serial.Serial, busio.UART, or machine.UART; notecard.OpenI2C(port, 0, 0) with periphery.I2C, busio.I2C, or machine.I2C (0, 0 selects address 0x17 and the default max transfer).", + "nCard.Transaction(req) sends a dict with a \"req\" key and returns the response dict. Notecard errors arrive in the response's \"err\" field, not as exceptions; Transaction raises an Exception only when transport or I/O fails.", + "Call fluent helpers with the Notecard object first and other arguments by keyword: hub.set(nCard, product=productUID, mode=\"continuous\"); hub.set's second positional parameter is align. Don't name the Notecard object card; it shadows the card module.", + "Fluent helper names camelCase the rest of the request (card.location.mode is card.locationMode, file.changes.pending is file.changesPending). Arguments that are Python keywords take a trailing underscore: hub.sync(nCard, in_=True).", + "Copy Notecard request and argument names exactly from the Notecard API reference; do not invent requests, arguments, or response fields.", + "Before expecting data in Notehub, set the Notehub project's ProductUID on the Notecard with the \"product\" argument of hub.set.", + "When the Blues Expert MCP server is connected, check generated Notecard JSON requests with its api_validate tool before using them." + ] +} From a8639e3253e9f8fad57c8ddd49bb189409305f9f Mon Sep 17 00:00:00 2001 From: Rob Lauer Date: Wed, 11 Nov 2026 10:34:39 -0600 Subject: [PATCH 2/2] docs: pass the ProductUID to hub.set by keyword and update API.md The README called hub.set(nCard, productUID, ...), which passes the ProductUID as align, the second positional parameter. API.md listed file.pendingChanges for file.changesPending and marked the dfu, env.template, ntn, var, and web helpers NOT IMPLEMENTED though they exist; dfu.set is not a Notecard request, so that row is now dfu.status. Co-Authored-By: Claude Opus 5.5 --- API.md | 37 ++++++++++++++++++++++--------------- README.md | 2 +- 2 files changed, 23 insertions(+), 16 deletions(-) diff --git a/API.md b/API.md index 1ab07b1..e3443fd 100644 --- a/API.md +++ b/API.md @@ -46,10 +46,12 @@ ## DFU Commands +`from notecard import dfu` + | Notecard API | Python Library API | | ------------ | ------------------ | -| `dfu.get` | NOT IMPLEMENTED | -| `dfu.set` | NOT IMPLEMENTED | +| `dfu.get` | dfu.get | +| `dfu.status` | dfu.status | ## Env Commands @@ -61,7 +63,7 @@ | `env.get` | env.get | | `env.modified` | env.modified | | `env.set` | env.set | -| `env.template` | NOT IMPLEMENTED | +| `env.template` | env.template | ## File Commands @@ -72,7 +74,7 @@ | `file.changes` | file.changes | | `file.delete` | file.delete | | `file.stats` | file.stats | -| `file.changes.pending` | file.pendingChanges | +| `file.changes.pending` | file.changesPending | ## Hub Commands @@ -106,24 +108,29 @@ | Notecard API | Python Library API | | ------------ | ------------------ | -| `ntn.gps` | NOT IMPLEMENTED | -| `ntn.reset` | NOT IMPLEMENTED | -| `ntn.status` | NOT IMPLEMENTED | +| `ntn.config` | ntn.config | +| `ntn.gps` | ntn.gps | +| `ntn.reset` | ntn.reset | +| `ntn.status` | ntn.status | ## Var Commands +`from notecard import var` + | Notecard API | Python Library API | | ------------ | ------------------ | -| `var.delete` | NOT IMPLEMENTED | -| `var.get` | NOT IMPLEMENTED | -| `var.set` | NOT IMPLEMENTED | +| `var.delete` | var.delete | +| `var.get` | var.get | +| `var.set` | var.set | ## Web Commands +`from notecard import web` + | Notecard API | Python Library API | | ------------ | ------------------ | -| `web.get` | NOT IMPLEMENTED | -| `web.post` | NOT IMPLEMENTED | -| `web.put` | NOT IMPLEMENTED | -| `web.delete` | NOT IMPLEMENTED | -| `web` | NOT IMPLEMENTED | +| `web.get` | web.get | +| `web.post` | web.post | +| `web.put` | web.put | +| `web.delete` | web.delete | +| `web` | web.web | diff --git a/README.md b/README.md index 8bb28f6..afb26ab 100644 --- a/README.md +++ b/README.md @@ -121,7 +121,7 @@ port = busio.I2C(board.SCL, board.SDA) nCard = notecard.OpenI2C(port, 0, 0, debug=True) productUID = "com.blues.brandon.tester" -rsp = hub.set(nCard, productUID, mode="continuous", sync=True) +rsp = hub.set(nCard, product=productUID, mode="continuous", sync=True) print(rsp) # {} ```