ogar-render-askama: render_python — Python import-shape emit PoC

The Python counterpart of render_osm: same ruff → OGAR substrate, a
language-pluggable emit back-end. Proves OGAR is a bidirectional
per-class transpiler whose pull-back side is not Rust-specific.

Emits under python/osm/:
- models.py   — one @DataClass per THINK class; associations become typed
                id fields (belongs_to/has_one → Optional[int], has_many/
                habtm → List[int]); each grounded model carries its CLASS_ID.
- <part_of>.py — the DO arm: `osm.node.show(inp)` free functions (part_of =
                module, is_a = function), never methods on the model; all
                colliding source controllers cited.
- __init__.py — package re-exports + CLASS_IDS map.

Plus python/ogar_sdk.py — the substrate-pull SDK (Python mirror of Rust
lance_graph_contract::ogar_codebook): CODEBOOK dict + class_id(concept) +
render_classid(concept, prefix) (canon-high `(concept<<16)|prefix`). Ships
OSM (0x0F) AND odoo/commerce (0x02) concepts — the pull is domain-agnostic,
so `osm`/`odoo` come out of the same substrate the same way.

Verified: example builds clean; py_compile green on the package + SDK;
functional smoke — class_id('osm_node')=0xf01, render_classid('account_move',
0x0002)=0x2020002, Node.CLASS_ID=0xf01, osm.node.show({}) raises
NotImplementedError('port Api::NodesController#show').

Note: container module names inherit main's naïve singulariser
(capabilitie.py / companie.py); the real inflector is PR #153
(claude/osm-render-ergonomics) — regen after both merge cleans the names.
Typed params (dict Input → typed) remain the ruff param-harvest brick.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EYvNjD8M8LMNYbRy3gq2FP

Author: claude

.claude/harvest/osm-website-rs/python/.gitignore

@@ -0,0 +1,2 @@
+__pycache__/
+*.pyc

.claude/harvest/osm-website-rs/python/ogar_sdk.py

@@ -0,0 +1,41 @@
+"""ogar_sdk — thin Python client over the OGAR codebook substrate.
+
+The Python mirror of Rust `lance_graph_contract::ogar_codebook`: pull a concept's
+stable classid, or compose a render-classid with an app prefix. Domain-agnostic —
+OSM (0x0F) and odoo/commerce (0x02) pull identically.
+
+    >>> from ogar_sdk import class_id, render_classid
+    >>> class_id("osm_node")
+    3841
+    >>> hex(render_classid("account_move", 0x0002))   # odoo, canon-high
+    '0x2020002'
+"""
+from typing import Optional
+
+# The pulled substrate — a subset of ogar-vocab's CODEBOOK (concept -> u16 id).
+CODEBOOK = {
+    # 0x0F — Geo (OpenStreetMap)
+    "osm_node": 0x0F01, "osm_way": 0x0F02, "osm_relation": 0x0F03,
+    "osm_changeset": 0x0F04, "osm_element_tag": 0x0F05, "osm_relation_member": 0x0F06,
+    "osm_way_node": 0x0F07, "osm_note": 0x0F08, "osm_gpx_trace": 0x0F09, "osm_user": 0x0F0A,
+    # 0x02 — Commerce (odoo / ERP) — same pull, different domain
+    "commercial_document": 0x0202, "product": 0x0207, "accounting_account": 0x0208,
+}
+# Convenience alias used in the odoo docstring example.
+CODEBOOK["account_move"] = CODEBOOK["commercial_document"]
+
+
+def class_id(concept: str) -> Optional[int]:
+    """Resolve a canonical-concept string to its stable u16 codebook id."""
+    return CODEBOOK.get(concept)
+
+
+def render_classid(concept: str, app_prefix: int) -> Optional[int]:
+    """Compose a 32-bit render classid: canon (concept) HIGH, custom (prefix) LOW.
+
+    Mirrors the post-2026-07-02 canon-high flip: `(concept << 16) | prefix`.
+    """
+    cid = class_id(concept)
+    if cid is None:
+        return None
+    return (cid << 16) | (app_prefix & 0xFFFF)

.claude/harvest/osm-website-rs/python/osm/__init__.py

@@ -0,0 +1,119 @@
+"""@generated OSM package (ruff → OGAR, Python import shape).
+Models: `from osm.models import Node`. DO arm: `import osm.node; osm.node.show(inp)`.
+"""
+from . import models as models
+from . import account as account
+from . import active_list as active_list
+from . import advanced_preference as advanced_preference
+from . import api as api
+from . import application as application
+from . import basic_preference as basic_preference
+from . import capabilitie as capabilitie
+from . import changeset as changeset
+from . import changeset_comment as changeset_comment
+from . import changeset_subscription as changeset_subscription
+from . import close as close
+from . import companie as companie
+from . import confirmation as confirmation
+from . import dashboard as dashboard
+from . import data as data
+from . import deletion as deletion
+from . import description as description
+from . import diary_comment as diary_comment
+from . import diary_entrie as diary_entrie
+from . import direction as direction
+from . import download as download
+from . import error as error
+from . import export as export
+from . import feature_querie as feature_querie
+from . import feed as feed
+from . import follow as follow
+from . import heatmap as heatmap
+from . import home as home
+from . import icon as icon
+from . import image as image
+from . import inboxe as inboxe
+from . import issue as issue
+from . import issue_comment as issue_comment
+from . import issued_block as issued_block
+from . import languages_pane as languages_pane
+from . import latlon_querie as latlon_querie
+from . import layers_pane as layers_pane
+from . import legend_pane as legend_pane
+from . import link as link
+from . import list as list
+from . import location as location
+from . import mailboxe as mailboxe
+from . import map as map
+from . import message as message
+from . import mute as mute
+from . import muted_inboxe as muted_inboxe
+from . import node as node
+from . import nominatim_querie as nominatim_querie
+from . import nominatim_reverse_querie as nominatim_reverse_querie
+from . import note as note
+from . import note_subscription as note_subscription
+from . import notification_preference as notification_preference
+from . import oauth2_application as oauth2_application
+from . import old_element as old_element
+from . import old_node as old_node
+from . import old_relation as old_relation
+from . import old_relation_member as old_relation_member
+from . import old_way as old_way
+from . import outboxe as outboxe
+from . import password as password
+from . import pd_declaration as pd_declaration
+from . import permission as permission
+from . import picture as picture
+from . import preference as preference
+from . import profile_section as profile_section
+from . import querie as querie
+from . import read_mark as read_mark
+from . import received_block as received_block
+from . import redaction as redaction
+from . import relation as relation
+from . import relation_member as relation_member
+from . import replie as replie
+from . import report as report
+from . import reporter as reporter
+from . import searche as searche
+from . import session as session
+from . import share_pane as share_pane
+from . import site as site
+from . import statuse as statuse
+from . import term as term
+from . import trace as trace
+from . import tracepoint as tracepoint
+from . import upload as upload
+from . import user as user
+from . import user_block as user_block
+from . import user_mute as user_mute
+from . import user_preference as user_preference
+from . import user_role as user_role
+from . import version as version
+from . import visibilitie as visibilitie
+from . import way as way
+from . import webgl_error_pane as webgl_error_pane
+
+CLASS_IDS = {
+    "Changeset": 0x0F04,
+    "Node": 0x0F01,
+    "NodeTag": 0x0F05,
+    "Note": 0x0F08,
+    "OldNode": 0x0F01,
+    "OldNodeTag": 0x0F05,
+    "OldRelation": 0x0F03,
+    "OldRelationMember": 0x0F06,
+    "OldRelationTag": 0x0F05,
+    "OldWay": 0x0F02,
+    "OldWayNode": 0x0F07,
+    "OldWayTag": 0x0F05,
+    "Relation": 0x0F03,
+    "RelationMember": 0x0F06,
+    "RelationTag": 0x0F05,
+    "Trace": 0x0F09,
+    "User": 0x0F0A,
+    "Way": 0x0F02,
+    "WayNode": 0x0F07,
+    "WayTag": 0x0F05,
+}

.claude/harvest/osm-website-rs/python/osm/account.py

@@ -0,0 +1,21 @@
+"""@generated DO-arm — `osm.account.<is_a>(inp)` free functions.
+part_of = this module, is_a = the function (standalone, not methods on
+the model — per OGAR's ActionDef rule). Call: `osm.account.show(inp)`.
+"""
+from typing import Any
+
+Input = dict   # the Rails params bag; typed params are the next ruff brick
+Output = Any
+
+def delete(inp: Input) -> Output:
+    """`account:delete` — DO arm. Source: AccountsController#destroy."""
+    raise NotImplementedError("port AccountsController#destroy")
+
+def show(inp: Input) -> Output:
+    """`account:show` — DO arm. Source: AccountsController#show."""
+    raise NotImplementedError("port AccountsController#show")
+
+def update(inp: Input) -> Output:
+    """`account:update` — DO arm. Source: AccountsController#update."""
+    raise NotImplementedError("port AccountsController#update")
+

.claude/harvest/osm-website-rs/python/osm/active_list.py

@@ -0,0 +1,13 @@
+"""@generated DO-arm — `osm.active_list.<is_a>(inp)` free functions.
+part_of = this module, is_a = the function (standalone, not methods on
+the model — per OGAR's ActionDef rule). Call: `osm.active_list.show(inp)`.
+"""
+from typing import Any
+
+Input = dict   # the Rails params bag; typed params are the next ruff brick
+Output = Any
+
+def show(inp: Input) -> Output:
+    """`active_list:show` — DO arm. Source: Api::UserBlocks::ActiveListsController#show."""
+    raise NotImplementedError("port Api::UserBlocks::ActiveListsController#show")
+

.claude/harvest/osm-website-rs/python/osm/advanced_preference.py

@@ -0,0 +1,13 @@
+"""@generated DO-arm — `osm.advanced_preference.<is_a>(inp)` free functions.
+part_of = this module, is_a = the function (standalone, not methods on
+the model — per OGAR's ActionDef rule). Call: `osm.advanced_preference.show(inp)`.
+"""
+from typing import Any
+
+Input = dict   # the Rails params bag; typed params are the next ruff brick
+Output = Any
+
+def update_preferences(inp: Input) -> Output:
+    """`advanced_preference:update_preferences` — DO arm. Source: Preferences::AdvancedPreferencesController#update_preferences."""
+    raise NotImplementedError("port Preferences::AdvancedPreferencesController#update_preferences")
+

.claude/harvest/osm-website-rs/python/osm/api.py

@@ -0,0 +1,49 @@
+"""@generated DO-arm — `osm.api.<is_a>(inp)` free functions.
+part_of = this module, is_a = the function (standalone, not methods on
+the model — per OGAR's ActionDef rule). Call: `osm.api.show(inp)`.
+"""
+from typing import Any
+
+Input = dict   # the Rails params bag; typed params are the next ruff brick
+Output = Any
+
+def api_call_handle_error(inp: Input) -> Output:
+    """`api:api_call_handle_error` — DO arm. Source: ApiController#api_call_handle_error."""
+    raise NotImplementedError("port ApiController#api_call_handle_error")
+
+def api_call_timeout(inp: Input) -> Output:
+    """`api:api_call_timeout` — DO arm. Source: ApiController#api_call_timeout."""
+    raise NotImplementedError("port ApiController#api_call_timeout")
+
+def authorize(inp: Input) -> Output:
+    """`api:authorize` — DO arm. Source: ApiController#authorize."""
+    raise NotImplementedError("port ApiController#authorize")
+
+def check_rate_limit(inp: Input) -> Output:
+    """`api:check_rate_limit` — DO arm. Source: ApiController#check_rate_limit."""
+    raise NotImplementedError("port ApiController#check_rate_limit")
+
+def current_ability(inp: Input) -> Output:
+    """`api:current_ability` — DO arm. Source: ApiController#current_ability."""
+    raise NotImplementedError("port ApiController#current_ability")
+
+def deny_access(inp: Input) -> Output:
+    """`api:deny_access` — DO arm. Source: ApiController#deny_access."""
+    raise NotImplementedError("port ApiController#deny_access")
+
+def gpx_status(inp: Input) -> Output:
+    """`api:gpx_status` — DO arm. Source: ApiController#gpx_status."""
+    raise NotImplementedError("port ApiController#gpx_status")
+
+def scope_enabled(inp: Input) -> Output:
+    """`api:scope_enabled?` — DO arm. Source: ApiController#scope_enabled?."""
+    raise NotImplementedError("port ApiController#scope_enabled?")
+
+def set_request_formats(inp: Input) -> Output:
+    """`api:set_request_formats` — DO arm. Source: ApiController#set_request_formats."""
+    raise NotImplementedError("port ApiController#set_request_formats")
+
+def setup_user_auth(inp: Input) -> Output:
+    """`api:setup_user_auth` — DO arm. Source: ApiController#setup_user_auth."""
+    raise NotImplementedError("port ApiController#setup_user_auth")
+

.claude/harvest/osm-website-rs/python/osm/application.py

@@ -0,0 +1,109 @@
+"""@generated DO-arm — `osm.application.<is_a>(inp)` free functions.
+part_of = this module, is_a = the function (standalone, not methods on
+the model — per OGAR's ActionDef rule). Call: `osm.application.show(inp)`.
+"""
+from typing import Any
+
+Input = dict   # the Rails params bag; typed params are the next ruff brick
+Output = Any
+
+def api_status(inp: Input) -> Output:
+    """`application:api_status` — DO arm. Source: ApplicationController#api_status."""
+    raise NotImplementedError("port ApplicationController#api_status")
+
+def authorize_web(inp: Input) -> Output:
+    """`application:authorize_web` — DO arm. Source: ApplicationController#authorize_web."""
+    raise NotImplementedError("port ApplicationController#authorize_web")
+
+def check_api_readable(inp: Input) -> Output:
+    """`application:check_api_readable` — DO arm. Source: ApplicationController#check_api_readable."""
+    raise NotImplementedError("port ApplicationController#check_api_readable")
+
+def check_api_writable(inp: Input) -> Output:
+    """`application:check_api_writable` — DO arm. Source: ApplicationController#check_api_writable."""
+    raise NotImplementedError("port ApplicationController#check_api_writable")
+
+def check_database_readable(inp: Input) -> Output:
+    """`application:check_database_readable` — DO arm. Source: ApplicationController#check_database_readable."""
+    raise NotImplementedError("port ApplicationController#check_database_readable")
+
+def check_database_writable(inp: Input) -> Output:
+    """`application:check_database_writable` — DO arm. Source: ApplicationController#check_database_writable."""
+    raise NotImplementedError("port ApplicationController#check_database_writable")
+
+def close_body(inp: Input) -> Output:
+    """`application:close_body` — DO arm. Source: ApplicationController#close_body."""
+    raise NotImplementedError("port ApplicationController#close_body")
+
+def current_ability(inp: Input) -> Output:
+    """`application:current_ability` — DO arm. Source: ApplicationController#current_ability."""
+    raise NotImplementedError("port ApplicationController#current_ability")
+
+def database_status(inp: Input) -> Output:
+    """`application:database_status` — DO arm. Source: ApplicationController#database_status."""
+    raise NotImplementedError("port ApplicationController#database_status")
+
+def deny_access(inp: Input) -> Output:
+    """`application:deny_access` — DO arm. Source: ApplicationController#deny_access."""
+    raise NotImplementedError("port ApplicationController#deny_access")
+
+def invalid_parameter(inp: Input) -> Output:
+    """`application:invalid_parameter` — DO arm. Source: ApplicationController#invalid_parameter."""
+    raise NotImplementedError("port ApplicationController#invalid_parameter")
+
+def map_layout(inp: Input) -> Output:
+    """`application:map_layout` — DO arm. Source: ApplicationController#map_layout."""
+    raise NotImplementedError("port ApplicationController#map_layout")
+
+def preferred_editor(inp: Input) -> Output:
+    """`application:preferred_editor` — DO arm. Source: ApplicationController#preferred_editor."""
+    raise NotImplementedError("port ApplicationController#preferred_editor")
+
+def preferred_languages(inp: Input) -> Output:
+    """`application:preferred_languages` — DO arm. Source: ApplicationController#preferred_languages."""
+    raise NotImplementedError("port ApplicationController#preferred_languages")
+
+def report_error(inp: Input) -> Output:
+    """`application:report_error` — DO arm. Source: ApplicationController#report_error."""
+    raise NotImplementedError("port ApplicationController#report_error")
+
+def require_cookies(inp: Input) -> Output:
+    """`application:require_cookies` — DO arm. Source: ApplicationController#require_cookies."""
+    raise NotImplementedError("port ApplicationController#require_cookies")
+
+def require_oauth(inp: Input) -> Output:
+    """`application:require_oauth` — DO arm. Source: ApplicationController#require_oauth."""
+    raise NotImplementedError("port ApplicationController#require_oauth")
+
+def require_public_data(inp: Input) -> Output:
+    """`application:require_public_data` — DO arm. Source: ApplicationController#require_public_data."""
+    raise NotImplementedError("port ApplicationController#require_public_data")
+
+def require_user(inp: Input) -> Output:
+    """`application:require_user` — DO arm. Source: ApplicationController#require_user."""
+    raise NotImplementedError("port ApplicationController#require_user")
+
+def respond_to_timeout(inp: Input) -> Output:
+    """`application:respond_to_timeout` — DO arm. Source: ApplicationController#respond_to_timeout."""
+    raise NotImplementedError("port ApplicationController#respond_to_timeout")
+
+def safe_referer(inp: Input) -> Output:
+    """`application:safe_referer` — DO arm. Source: ApplicationController#safe_referer."""
+    raise NotImplementedError("port ApplicationController#safe_referer")
+
+def set_locale(inp: Input) -> Output:
+    """`application:set_locale` — DO arm. Source: ApplicationController#set_locale."""
+    raise NotImplementedError("port ApplicationController#set_locale")
+
+def site_layout(inp: Input) -> Output:
+    """`application:site_layout` — DO arm. Source: ApplicationController#site_layout."""
+    raise NotImplementedError("port ApplicationController#site_layout")
+
+def update_totp(inp: Input) -> Output:
+    """`application:update_totp` — DO arm. Source: ApplicationController#update_totp."""
+    raise NotImplementedError("port ApplicationController#update_totp")
+
+def web_timeout(inp: Input) -> Output:
+    """`application:web_timeout` — DO arm. Source: ApplicationController#web_timeout."""
+    raise NotImplementedError("port ApplicationController#web_timeout")
+

.claude/harvest/osm-website-rs/python/osm/basic_preference.py

@@ -0,0 +1,13 @@
+"""@generated DO-arm — `osm.basic_preference.<is_a>(inp)` free functions.
+part_of = this module, is_a = the function (standalone, not methods on
+the model — per OGAR's ActionDef rule). Call: `osm.basic_preference.show(inp)`.
+"""
+from typing import Any
+
+Input = dict   # the Rails params bag; typed params are the next ruff brick
+Output = Any
+
+def update_preferences(inp: Input) -> Output:
+    """`basic_preference:update_preferences` — DO arm. Source: Preferences::BasicPreferencesController#update_preferences."""
+    raise NotImplementedError("port Preferences::BasicPreferencesController#update_preferences")
+