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) # {} ``` 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." + ] +}