laga 0.1.1__tar.gz

laga-0.1.1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,148 @@
+name: Bug report
+description: Report a reproducible bug in laga with enough detail to diagnose and fix it.
+title: "Bug: "
+labels:
+  - bug
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug.
+
+        Please provide a minimal, reproducible example and include the exact input that triggers the problem.
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Affected area
+      description: Pick the part of laga that seems broken.
+      options:
+        - Public API
+        - CLI
+        - Parser / repair behavior
+        - Tokenizer
+        - Documentation
+        - Packaging / release
+        - Tests / CI
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: How much does this affect your use case?
+      options:
+        - Blocking
+        - High
+        - Medium
+        - Low
+        - Cosmetic
+    validations:
+      required: true
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: Describe the bug in one or two sentences.
+      placeholder: laga returns the wrong structure when ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: input
+    attributes:
+      label: Input that triggers the bug
+      description: Paste the smallest possible text sample that reproduces the issue.
+      render: text
+      placeholder: |
+        {name: 'Ada', roles: ['admin',],}
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected result
+      description: What should laga have returned or done instead?
+      placeholder: The input should be repaired to valid JSON and parse to ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual result
+      description: What happened instead. Include the exact error message or unexpected output.
+      placeholder: laga raised LagaError: ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: List the exact steps so someone else can reproduce the issue.
+      placeholder: |
+        1. Install laga
+        2. Run laga.repair(...) with the sample above
+        3. Observe the failure
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Share the runtime details that matter for reproduction.
+      placeholder: |
+        Python:
+        OS:
+        laga version:
+        Installation method:
+        Shell or editor:
+    validations:
+      required: true
+
+  - type: dropdown
+    id: reproducibility
+    attributes:
+      label: Reproducibility
+      description: How often does this happen?
+      options:
+        - Always
+        - Sometimes
+        - Rarely
+        - Only once
+    validations:
+      required: true
+
+  - type: textarea
+    id: workaround
+    attributes:
+      label: Workaround
+      description: If you found a workaround, describe it here.
+      placeholder: Using strict=False avoids the failure, but ...
+
+  - type: textarea
+    id: extra
+    attributes:
+      label: Additional context
+      description: Add logs, stack traces, screenshots, or notes that may help.
+      placeholder: Any extra detail that could narrow down the root cause.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Confirmation checklist
+      options:
+        - label: I have searched existing issues and did not find a duplicate.
+          required: true
+        - label: I have reduced the example to the smallest reproducible input I could.
+          required: true
+        - label: I am using the latest released version or I can explain why I am not.
+          required: true
+        - label: I am comfortable sharing the sample input publicly in this issue.
+          required: true

laga-0.1.1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security reporting
+    url: https://github.com/olaflaitinen/laga/security/advisories
+    about: Use this for private security reports only.
+  - name: Project repository
+    url: https://github.com/olaflaitinen/laga
+    about: Review the README, docs, and existing issues before opening a new ticket.

laga-0.1.1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,124 @@
+name: Feature request
+description: Suggest an improvement, capability, or workflow enhancement for laga.
+title: "Feature: "
+labels:
+  - enhancement
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an improvement.
+
+        The most useful requests explain the current limitation, the user impact, and the exact behavior you want.
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      description: Which part of laga would this affect?
+      options:
+        - Public API
+        - CLI
+        - Parser / repair behavior
+        - Tokenizer
+        - Documentation
+        - Packaging / release
+        - Tests / CI
+        - New capability
+        - Other
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this request to you?
+      options:
+        - Critical
+        - High
+        - Medium
+        - Low
+        - Nice to have
+    validations:
+      required: true
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: Describe the limitation or pain point you are trying to solve.
+      placeholder: Today I have to ... which causes ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: goal
+    attributes:
+      label: Desired outcome
+      description: Describe the behavior, output, or workflow you want.
+      placeholder: laga should be able to ...
+    validations:
+      required: true
+
+  - type: textarea
+    id: user_story
+    attributes:
+      label: User story
+      description: Optional, but helpful if you can describe who needs this and why.
+      placeholder: As a ... I want ... so that ...
+
+  - type: textarea
+    id: examples
+    attributes:
+      label: Example input or API shape
+      description: Show a concrete example of the proposed behavior.
+      render: text
+      placeholder: |
+        laga.repair('{name: "Ada"}')
+        # could optionally return ...
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: Describe other approaches you evaluated and why they were not enough.
+      placeholder: |
+        1. Use a post-processing step
+        2. Wrap laga in custom logic
+        3. Change upstream data generation
+
+  - type: textarea
+    id: tradeoffs
+    attributes:
+      label: Tradeoffs and constraints
+      description: Mention any compatibility, performance, or maintenance concerns we should keep in mind.
+      placeholder: This should remain backwards compatible with ...
+
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+      description: What would make this feature request complete?
+      placeholder: |
+        - Works with ...
+        - Does not break ...
+        - Includes tests/docs ...
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Add links, screenshots, related issues, or any notes that help frame the request.
+
+  - type: checkboxes
+    id: checklist
+    attributes:
+      label: Confirmation checklist
+      options:
+        - label: I searched existing issues and discussions before opening this request.
+          required: true
+        - label: I explained the problem and not just the solution.
+          required: true
+        - label: I included a concrete example or user story.
+          required: true

laga-0.1.1/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Summary
+
+Describe the change and why it is needed. Link any related issue or discussion.
+
+## Testing
+
+- [ ] `make lint`
+- [ ] `make typecheck`
+- [ ] `make test`
+- [ ] `make build`
+
+## Notes
+
+Add any follow-up work, release notes, or migration notes here.

laga-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,47 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e ".[dev]"
+
+      - name: Lint
+        run: ruff check .
+
+      - name: Type check
+        run: mypy src/laga
+
+      - name: Test
+        run: pytest
+
+      - name: Upload coverage report
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: |
+            coverage.xml
+            htmlcov

laga-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,39 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          cache: pip
+
+      - name: Install build dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+
+      - name: Build distributions
+        run: python -m build
+
+      - name: Verify artifacts
+        run: python -m pip install twine && twine check dist/*
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist

laga-0.1.1/.gitignore

@@ -0,0 +1,13 @@
+.coverage
+.hypothesis/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.venv/
+.benchmarks/
+coverage.xml
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.py[cod]

laga-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,25 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: check-added-large-files
+      - id: check-ast
+      - id: check-byte-order-marker
+      - id: check-case-conflict
+      - id: check-merge-conflict
+      - id: check-symlinks
+      - id: end-of-file-fixer
+      - id: mixed-line-ending
+      - id: trailing-whitespace
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.6.9
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.11.2
+    hooks:
+      - id: mypy
+        additional_dependencies: [hatchling]
+        files: ^src/laga/

laga-0.1.1/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project are documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.1] - 2026-07-24
+
+### Added
+
+- Repository cleanup, documentation refresh, and GitHub workflow improvements.
+- Root ignore file for Python build and cache artifacts.
+- Project ownership metadata updated for the `olaflaitinen` repository.
+
+### Changed
+
+- Dropped Python 3.9 support; laga 0.1.1 targets Python 3.10 through 3.13.
+
+## [0.1.0] - 2026-07-24
+
+### Added
+
+- Fast path through `json.loads` for valid JSON.
+- Recovery for comments, fences, prose, smart quotes, single quotes, missing commas, trailing commas, and truncated braces.
+- `repair`, `repair_to_str`, and `loads` public entry points.
+- Type information distributed through `py.typed`.

laga-0.1.1/CODE_OF_CONDUCT.md

@@ -0,0 +1,23 @@
+# Code of Conduct
+
+## Our Pledge
+
+We commit to a respectful, inclusive, and professional community. We do not tolerate harassment, discrimination, or abuse of any kind.
+
+## Expected Behavior
+
+- Be considerate and constructive.
+- Give feedback on ideas, not people.
+- Assume good intent and communicate clearly.
+
+## Unacceptable Behavior
+
+- Harassment or threats.
+- Hate speech or discriminatory language.
+- Deliberate disruption of discussions or reviews.
+
+## Enforcement
+
+Maintainers may remove content, restrict access, or take other actions when needed to protect the community.
+
+Reports may be sent to the maintainers listed in the repository or through private project contact channels.

laga-0.1.1/CONTRIBUTING.md

@@ -0,0 +1,26 @@
+# Contributing
+
+## Setup
+
+1. Create and activate a virtual environment.
+2. Install development dependencies with `python -m pip install -e ".[dev]"`.
+3. Install pre-commit hooks with `pre-commit install`.
+
+## Local Checks
+
+Run the full check set before sending a change:
+
+```bash
+make lint
+make typecheck
+make test
+make build
+```
+
+## Pull Requests
+
+1. Keep changes focused and easy to review.
+2. Add or update tests for behavior changes.
+3. Update documentation when the public API changes.
+4. Include screenshots only when the change is visual.
+5. Make sure the CI workflow passes before requesting review.

laga-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Gustav Olaf Yunus Laitinen-Fredriksson Lundström-Imanov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

laga-0.1.1/Makefile

@@ -0,0 +1,20 @@
+.PHONY: install lint typecheck test build docs
+
+install:
+	python -m pip install -e ".[dev]"
+
+lint:
+	ruff check .
+	ruff format --check .
+
+typecheck:
+	mypy src/laga
+
+test:
+	pytest
+
+build:
+	python -m build
+
+docs:
+	mkdocs build

laga-0.1.1/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: laga
+Version: 0.1.1
+Summary: Repair malformed JSON from language models and hand-written config.
+Project-URL: Homepage, https://github.com/olaflaitinen/laga
+Project-URL: Documentation, https://github.com/olaflaitinen/laga/tree/main/docs
+Project-URL: Source, https://github.com/olaflaitinen/laga
+Project-URL: Issue Tracker, https://github.com/olaflaitinen/laga/issues
+Author: Gustav Olaf Yunus Laitinen-Fredriksson Lundström-Imanov
+License: MIT License
+        
+        Copyright (c) 2026 Gustav Olaf Yunus Laitinen-Fredriksson Lundström-Imanov
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Keywords: data-cleanup,json,llm,parser,repair
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: <3.14,>=3.10
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: coverage[toml]>=7.6; extra == 'dev'
+Requires-Dist: hypothesis>=6.108; extra == 'dev'
+Requires-Dist: mkdocs-material>=9.5; extra == 'dev'
+Requires-Dist: mkdocs>=1.6; extra == 'dev'
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: pre-commit>=3.8; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.3; extra == 'dev'
+Requires-Dist: ruff>=0.6.9; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
+Requires-Dist: mkdocs>=1.6; extra == 'docs'
+Provides-Extra: lint
+Requires-Dist: mypy>=1.11; extra == 'lint'
+Requires-Dist: ruff>=0.6.9; extra == 'lint'
+Provides-Extra: test
+Requires-Dist: coverage[toml]>=7.6; extra == 'test'
+Requires-Dist: hypothesis>=6.108; extra == 'test'
+Requires-Dist: pytest-cov>=5.0; extra == 'test'
+Requires-Dist: pytest>=8.3; extra == 'test'
+Description-Content-Type: text/markdown
+
+# laga
+
+`laga` repairs malformed JSON and returns Python objects.
+
+## Why
+
+Large language models and hand-written configuration often produce almost-JSON with trailing commas, missing commas, comments, code fences, single quotes, unquoted keys, or truncated containers. `laga` keeps the public surface small, tries `json.loads` first for valid input, and only enters the repair path when necessary.
+
+## Install
+
+`laga` 0.1.1 supports Python 3.10 through 3.13.
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Quickstart
+
+```python
+import laga
+
+text = """Here is the result:
+```json
+{
+  'name': 'Ada',
+  'active': True,
+  'roles': ['admin', 'writer',],
+}
+```
+"""
+
+data = laga.repair(text)
+print(data)
+print(laga.repair_to_str(text))
+```
+
+## API Reference
+
+| Function | Returns | Description |
+| --- | --- | --- |
+| `laga.repair(text, strict=False)` | Python object | Repairs malformed JSON and returns Python data. |
+| `laga.repair_to_str(text, strict=False)` | `str` | Repairs malformed JSON and returns normalized JSON text. |
+| `laga.loads(text, strict=False)` | Python object | Alias for `laga.repair`. |
+| `laga.LagaError` | Exception type | Raised when repair fails or input is unrecoverable. |
+
+## Repair Rules
+
+| Rule | Before | After |
+| --- | --- | --- |
+| Trailing comma | `{"a": 1,}` | `{"a":1}` |
+| Missing comma | `{"a": 1 "b": 2}` | `{"a":1,"b":2}` |
+| Single quotes | `{'a': 'b'}` | `{"a":"b"}` |
+| Unquoted keys | `{name: "Ada"}` | `{"name":"Ada"}` |
+| Python literals | `{"ok": True, "none": None}` | `{"ok":true,"none":null}` |
+| Comments | `{"a": 1 // note\n}` | `{"a":1}` |
+| Markdown fences | <code>```json\n{"a":1}\n```</code> | `{"a":1}` |
+| Smart quotes | `“a”` | `"a"` |
+| Prose around JSON | `Result: {"a":1}` | `{"a":1}` |
+| Truncated structure | `{"a": [1, 2` | `{"a":[1,2]}` |
+
+## Limitations
+
+`laga` is intentionally conservative. It does not evaluate expressions, it does not guess at arbitrary JavaScript syntax, and it does not try to recover malformed numbers or deeply ambiguous text in strict mode. If you already control the producer and the input is valid JSON, the standard library remains the best choice because `json.loads` is faster and stricter.
+
+When an object contains duplicate keys, the last value wins, matching Python dict behavior.
+
+## When To Use The Standard Library
+
+Use `json.loads` when you control the producer and know the input is valid JSON. Use `laga` when the input is noisy, user-facing, or generated by a model and you need a predictable repair step before parsing.
+
+## Development
+
+```bash
+make install
+make lint
+make typecheck
+make test
+make build
+```