gnurlies 0.1.0

Python-Markdown extension for gnurlies — Questache and Attaché inline AI collaboration syntax

gnurlies — Python-Markdown extension

A Python-Markdown extension that parses questache and attaché syntax — inline calls-to-action for human–AI document collaboration.

For background on the convention, see the gnurlies whitepaper.

Install

pip install gnurlies

Usage

import markdown
from gnurlies import GnurliesExtension

md = markdown.Markdown(extensions=[GnurliesExtension()])
result = md.convert('The {? glue, bridge, handshake ?} between layers.')

Or by name:

md = markdown.Markdown(extensions=['gnurlies'])

The extension adds two inline element types to the parse tree:

Element	Attributes	Meaning
<questache>	hints — comma-separated hint string	Ask for names or verbiage
<attache>	action, hints	Request a concrete insertion

Questache

The {? glue, bridge, handshake ?} between the canvas layer and the stroke model
is resolved at render time.

Produces <questache hints="glue,bridge,handshake">...</questache> in the element tree.

Attaché

See [here]({! insert: image of Garfield being lazy !}) for a vivid illustration.

Produces <attache action="insert" hints="image of Garfield being lazy">...</attache>.

Escaping

Prefix with a backslash to emit literal text:

\{? this will not be parsed ?}
\{! neither will this !}

Gnurlies inside fenced code blocks are never parsed.

Block suppression

<!-- gnurlies-off -->
{? ignored ?} and {! also ignored !}
<!-- gnurlies-on -->

Post-processing

The extension emits raw XML elements. To act on them — rendering suggestions, fulfilling attachés, stripping markers — register a Treeprocessor that walks the element tree and handles questache and attache tags.

Requirements

• Python 3.9+
• Markdown >= 3.0

License

MIT