programasweights 0.4.7__tar.gz → 0.4.9__tar.gz

{programasweights-0.4.7 → programasweights-0.4.9}/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.4.9 (2026-09-21)
+
+- Lead quickstarts and examples with compiling your own functions, then
+  saving and reusing program IDs.
+- Reuse loaded functions in the LangChain example and serialize calls to
+  each shared instance.
+
+## 0.4.8 (2026-09-20)
+
+- Reduce the source distribution to the SDK and files needed to build and
+  document the package.
+
 ## 0.4.7 (2026-09-20)
 
 - Add `remote=True` to `paw.function` and `paw.compile_and_load`, plus

{programasweights-0.4.7 → programasweights-0.4.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: programasweights
-Version: 0.4.7
+Version: 0.4.9
 Summary: Compile natural language specifications into neural programs that run locally via llama.cpp.
 Project-URL: Homepage, https://programasweights.com
 Project-URL: Repository, https://github.com/programasweights/programasweights-python
@@ -46,22 +46,21 @@ pip install programasweights --extra-index-url https://pypi.programasweights.com
 ```python
 import programasweights as paw
 
-# Use a pre-compiled function (downloads once, runs locally forever)
-fn = paw.function("email-triage")
+# Compile and load your own function
+fn = paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'."
+)
 fn("Urgent: the server is down!")        # "immediate"
 fn("Newsletter: spring picnic")          # "wait"
 
-# Compile your own from a description
+# Compile once and save the program ID
 program = paw.compile(
-    "Fix malformed JSON: repair missing quotes and trailing commas",
-    slug="json-fixer"              # optional: creates username/json-fixer handle
+    "Fix malformed JSON: repair missing quotes and trailing commas"
 )
-fn = paw.function(program.slug)    # or paw.function(program.id)
+print(program.id)  # Save this ID for future runs
+fn = paw.function(program.id)
 fn("{name: 'Alice',}")  # '{"name":"Alice"}'
-
-# Or compile and load in one step
-fn = paw.compile_and_load("Classify sentiment as positive or negative")
-fn("I love this!")  # "positive"
 ```
 
 If you specifically want the smaller browser-compatible runtime, pass `compiler="paw-4b-gpt2"`. Otherwise, omit `compiler` and let the server default decide.
@@ -73,7 +72,11 @@ Use the hosted API for fast inference in around 150 ms, without a local model do
 ```python
 import programasweights as paw
 
-with paw.function("email-triage", remote=True) as remote_fn:
+with paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'.",
+    remote=True,
+) as remote_fn:
     print(remote_fn("Urgent: the server is down!"))
 ```
 

{programasweights-0.4.7 → programasweights-0.4.9}/PYPI_README.md

@@ -15,22 +15,21 @@ pip install programasweights --extra-index-url https://pypi.programasweights.com
 ```python
 import programasweights as paw
 
-# Use a pre-compiled function (downloads once, runs locally forever)
-fn = paw.function("email-triage")
+# Compile and load your own function
+fn = paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'."
+)
 fn("Urgent: the server is down!")        # "immediate"
 fn("Newsletter: spring picnic")          # "wait"
 
-# Compile your own from a description
+# Compile once and save the program ID
 program = paw.compile(
-    "Fix malformed JSON: repair missing quotes and trailing commas",
-    slug="json-fixer"              # optional: creates username/json-fixer handle
+    "Fix malformed JSON: repair missing quotes and trailing commas"
 )
-fn = paw.function(program.slug)    # or paw.function(program.id)
+print(program.id)  # Save this ID for future runs
+fn = paw.function(program.id)
 fn("{name: 'Alice',}")  # '{"name":"Alice"}'
-
-# Or compile and load in one step
-fn = paw.compile_and_load("Classify sentiment as positive or negative")
-fn("I love this!")  # "positive"
 ```
 
 If you specifically want the smaller browser-compatible runtime, pass `compiler="paw-4b-gpt2"`. Otherwise, omit `compiler` and let the server default decide.
@@ -42,7 +41,11 @@ Use the hosted API for fast inference in around 150 ms, without a local model do
 ```python
 import programasweights as paw
 
-with paw.function("email-triage", remote=True) as remote_fn:
+with paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'.",
+    remote=True,
+) as remote_fn:
     print(remote_fn("Urgent: the server is down!"))
 ```
 

{programasweights-0.4.7 → programasweights-0.4.9}/README.md

@@ -15,22 +15,21 @@ pip install programasweights --extra-index-url https://pypi.programasweights.com
 ```python
 import programasweights as paw
 
-# Use a pre-compiled function (downloads once, runs locally forever)
-fn = paw.function("email-triage")
+# Compile and load your own function
+fn = paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'."
+)
 fn("Urgent: the server is down!")        # "immediate"
 fn("Newsletter: spring picnic")          # "wait"
 
-# Compile your own from a description
+# Compile once and save the program ID
 program = paw.compile(
-    "Fix malformed JSON: repair missing quotes and trailing commas",
-    slug="json-fixer"              # optional: creates username/json-fixer handle
+    "Fix malformed JSON: repair missing quotes and trailing commas"
 )
-fn = paw.function(program.slug)    # or paw.function(program.id)
+print(program.id)  # Save this ID for future runs
+fn = paw.function(program.id)
 fn("{name: 'Alice',}")  # '{"name":"Alice"}'
-
-# Or compile and load in one step
-fn = paw.compile_and_load("Classify sentiment as positive or negative")
-fn("I love this!")  # "positive"
 ```
 
 If you specifically want the smaller browser-compatible runtime, pass `compiler="paw-4b-gpt2"`. Otherwise, omit `compiler` and let the server default decide.
@@ -42,7 +41,11 @@ Use the hosted API for fast inference in around 150 ms, without a local model do
 ```python
 import programasweights as paw
 
-with paw.function("email-triage", remote=True) as remote_fn:
+with paw.compile_and_load(
+    "Classify if a message needs immediate attention or can wait. "
+    "Return only 'immediate' or 'wait'.",
+    remote=True,
+) as remote_fn:
     print(remote_fn("Urgent: the server is down!"))
 ```
 

{programasweights-0.4.7 → programasweights-0.4.9}/programasweights/__init__.py

@@ -5,12 +5,16 @@ functions that run locally.
 Quick start:
     import programasweights as paw
 
-    # Use a pre-compiled function (downloads once, runs locally forever)
-    fn = paw.function("email-triage")
+    # Compile and load your own function
+    fn = paw.compile_and_load(
+        "Classify if a message needs immediate attention or can wait. "
+        "Return only 'immediate' or 'wait'."
+    )
     fn("Urgent: server is down!")  # "immediate"
 
-    # Compile your own from a description
+    # Compile once and save the program ID
     program = paw.compile("Fix malformed JSON: repair missing quotes and trailing commas")
+    print(program.id)  # Save this ID for future runs
     fn = paw.function(program.id)
     fn("{name: 'Alice',}")  # '{"name":"Alice"}'
 
@@ -27,7 +31,7 @@ try:
     from importlib.metadata import version as _meta_version
     __version__ = _meta_version("programasweights")
 except Exception:
-    __version__ = "0.4.7"
+    __version__ = "0.4.9"
 
 from ._output import ProgressCallback, ProgressEvent, report_progress
 from .cache import CachedProgram

{programasweights-0.4.7 → programasweights-0.4.9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "programasweights"
-version = "0.4.7"
+version = "0.4.9"
 description = "Compile natural language specifications into neural programs that run locally via llama.cpp."
 readme = "PYPI_README.md"
 requires-python = ">=3.9"
@@ -47,6 +47,16 @@ paw = "programasweights.cli:main"
 [tool.hatch.build.targets.wheel]
 packages = ["programasweights"]
 
+[tool.hatch.build.targets.sdist]
+only-include = [
+  "programasweights",
+  "README.md",
+  "PYPI_README.md",
+  "LICENSE",
+  "CHANGELOG.md",
+  "pyproject.toml",
+]
+
 [tool.pytest.ini_options]
 addopts = "-q"
 pythonpath = ["."]

programasweights-0.4.7/.cursor/rules/releases.mdc

@@ -1,17 +0,0 @@
----
-description: Publish and verify complete Python SDK releases
-alwaysApply: true
----
-
-# SDK releases
-
-For release or publication work, read `RELEASING.md` first.
-
-- A release is complete only when its annotated remote tag, PyPI wheel and
-  source distribution, and published GitHub Release all exist and agree.
-- Build from the clean, tested release commit; push its annotated version tag
-  before uploading the exact checked artifacts to PyPI.
-- Verify the `GitHub release` workflow succeeded and the latest GitHub Release
-  agrees with PyPI. A tag alone is not a GitHub Release entry.
-- Repair missing entries using the documented workflow dispatch. Never move a
-  published tag, rebuild an existing version, or bypass artifact verification.

programasweights-0.4.7/.github/workflows/release.yml

@@ -1,72 +0,0 @@
-name: GitHub release
-
-on:
-  push:
-    tags: ['v*']
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Existing stable version tag, e.g. v0.4.6'
-        required: true
-        type: string
-
-permissions:
-  contents: write
-
-concurrency:
-  group: github-release-${{ inputs.tag || github.ref_name }}
-  cancel-in-progress: false
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    timeout-minutes: 15
-    env:
-      RELEASE_TAG: ${{ inputs.tag || github.ref_name }}
-      GH_TOKEN: ${{ github.token }}
-      GH_REPO: ${{ github.repository }}
-    steps:
-      - name: Set the verification output directory
-        run: echo "RELEASE_DIR=$RUNNER_TEMP/verified-release" >> "$GITHUB_ENV"
-      - uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-      - name: Verify the remote tag and both published PyPI artifacts
-        # Tags are pushed before uploading. Wait for the wheel AND sdist;
-        # never announce an unpublished version or rebuild release assets.
-        run: python scripts/release_metadata.py --tag "$RELEASE_TAG" --output-dir "$RELEASE_DIR" --wait-seconds 600
-      - name: Publish the missing GitHub release
-        shell: bash
-        run: |
-          set -euo pipefail
-          if gh release view "$RELEASE_TAG" --json tagName >/dev/null 2>&1; then
-            echo "Release already exists; preserving its notes and assets."
-          else
-            latest=$(jq -r .latest "$RELEASE_DIR/verified.json")
-            gh release create "$RELEASE_TAG" "$RELEASE_DIR"/artifacts/* \
-              --verify-tag --title "$RELEASE_TAG" \
-              --notes-file "$RELEASE_DIR/notes.md" --latest="$latest"
-          fi
-          gh release view "$RELEASE_TAG" --json tagName,isDraft,isPrerelease,url \
-            | jq -e --arg tag "$RELEASE_TAG" '.tagName == $tag and .isDraft == false and .isPrerelease == false'
-      - name: Verify the uploaded release assets and latest marker
-        shell: bash
-        run: |
-          set -euo pipefail
-          gh release download "$RELEASE_TAG" --pattern 'programasweights-*' \
-            --dir "$RELEASE_DIR/github-assets"
-          for artifact in "$RELEASE_DIR"/artifacts/*; do
-            cmp "$artifact" "$RELEASE_DIR/github-assets/$(basename "$artifact")"
-          done
-          if [ "$(jq -r .latest "$RELEASE_DIR/verified.json")" = true ]; then
-            gh api "repos/$GH_REPO/releases/latest" \
-              | jq -e --arg tag "$RELEASE_TAG" '.tag_name == $tag'
-          fi
-      - name: Retain the verification record
-        uses: actions/upload-artifact@v4
-        with:
-          name: release-verification-${{ inputs.tag || github.ref_name }}
-          path: ${{ runner.temp }}/verified-release/verified.json

programasweights-0.4.7/.github/workflows/test.yml

@@ -1,94 +0,0 @@
-name: tests
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-
-jobs:
-  release-metadata:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: '3.12'
-      - run: python -m pip install pytest
-      - name: Test release verification without network or publishing
-        run: python -m pytest tests/test_release_metadata.py
-
-  test:
-    runs-on: ubuntu-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-
-      - name: Install (hermetic deps only)
-        # Install httpx + pytest and the package itself without pulling the heavy
-        # llama-cpp-python build. Runtime tests inject a fake llama_cpp module,
-        # so CI needs neither the native extension nor a model download.
-        run: |
-          python -m pip install --upgrade pip
-          python -m pip install httpx pytest
-          python -m pip install -e . --no-deps
-
-      - name: Run hermetic tests
-        # Scoped to tests that need no network, no model download, and no
-        # PAW_API_KEY. Auth tests (@needs_auth) auto-skip without a key; the
-        # network/model-download tests in test_sdk.py are excluded here and can
-        # be run separately against a live server.
-        run: |
-          pytest \
-            tests/test_api_errors.py \
-            tests/test_compile_timeouts.py \
-            tests/test_local_program.py \
-            tests/test_base_interpreter.py \
-            tests/test_cli_auth.py \
-            tests/test_remote_inference.py \
-            tests/test_desktop_sdk.py \
-            tests/test_runtime_registry_sdk.py \
-            tests/test_sdk.py::TestInstallAndImport
-
-  local-files-windows:
-    runs-on: windows-latest
-    strategy:
-      fail-fast: false
-      matrix:
-        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-python@v5
-        with:
-          python-version: ${{ matrix.python-version }}
-      - name: Install hermetic test dependencies
-        run: |
-          python -m pip install httpx pytest
-          python -m pip install -e . --no-deps
-      - name: Test Windows local paths, cache locks, and compile errors
-        run: python -m pytest tests/test_api_errors.py tests/test_compile_timeouts.py tests/test_local_program.py tests/test_remote_inference.py --junitxml=test-results.xml
-      - name: Annotate Windows test failures
-        if: failure()
-        shell: python
-        run: |
-          from pathlib import Path
-          import xml.etree.ElementTree as ET
-
-          report = Path("test-results.xml")
-          if report.exists():
-              for case in ET.parse(report).iter("testcase"):
-                  for result in case:
-                      if result.tag in {"failure", "error"}:
-                          # GitHub truncates annotations, so retain the actual
-                          # exception at the end of long pytest tracebacks.
-                          detail = result.text or result.get("message", "")
-                          message = f"{case.get('name')}: {detail[-3500:]}"
-                          message = message.replace("%", "%25").replace("\r", "%0D").replace("\n", "%0A")
-                          print(f"::error::{message}")

programasweights-0.4.7/.readthedocs.yaml

@@ -1,13 +0,0 @@
-version: 2
-
-build:
-  os: ubuntu-24.04
-  tools:
-    python: "3.12"
-
-mkdocs:
-  configuration: mkdocs.yml
-
-python:
-  install:
-    - requirements: docs/requirements.txt