iniconfig 2.3.0: IniConfig

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pkg:pypi/iniconfig@2.3.0
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:pypi/iniconfig@2.3.0

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:8ec4fafd40618db83a9dab9d718466f882641577cc6750061f3b9b55a2c5c1ed","contract":["IniConfig parses ini string content with sections and key-value pairs","IniConfig section items can be accessed by indexing and converted with get","IniConfig lineof method returns the line number of a section key","IniConfig raises ParseError on malformed ini syntax"],"goal":"verify pkg:pypi/iniconfig@2.3.0","kind":"HOW","packages":["pkg:pypi/iniconfig@2.3.0"],"schemaVersion":1,"symbols":["iniconfig.IniConfig"]},"contractCommand":["python","test/contract.py"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"pypi","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"pip","schemaVersion":1},"license":"MIT-0","packages":["pkg:pypi/iniconfig@2.3.0"],"schemaVersion":1,"subject":"pkg:pypi/iniconfig@2.3.0","symbols":["iniconfig.IniConfig"],"verifierAdapter":"python@1"}

iniconfig==2.3.0

{
  "schemaVersion": 1,
  "goal": "verify pkg:pypi/iniconfig@2.3.0",
  "kind": "HOW",
  "packages": [
    "pkg:pypi/iniconfig@2.3.0"
  ]
}

"""Example of loading and reading INI configurations with iniconfig."""

import iniconfig


def load_config_dict(ini_text: str) -> dict:
    """Parse INI formatted text and return a dictionary of sections and options."""
    ini = iniconfig.IniConfig("config.ini", ini_text)
    result = {}
    for section_name, section in ini.items():
        result[section_name] = dict(section.items())
    return result


if __name__ == "__main__":
    sample = """
[app]
title = Minimal Example
debug = false
"""
    parsed = load_config_dict(sample)
    print("Parsed configuration:", parsed)

"""Contract test for iniconfig@2.3.0."""

import sys
import iniconfig


def test_iniconfig_parsing_and_access():
    sample_ini = """
# Sample INI configuration
[server]
host = 127.0.0.1
port = 8080
enabled = true

[database]
name = testdb
max_connections = 20
"""
    ini = iniconfig.IniConfig("config.ini", sample_ini)

    # Verify section access
    assert "server" in ini
    assert "database" in ini
    assert "unknown" not in ini

    server_section = ini["server"]
    assert server_section["host"] == "127.0.0.1"
    assert server_section["port"] == "8080"

    # Verify type conversion with get
    assert server_section.get("port", convert=int) == 8080
    assert server_section.get("missing_key", default="fallback") == "fallback"

    # Verify lineof tracking
    assert server_section.lineof("host") is not None

    # Verify top-level get helper
    assert ini.get("database", "name") == "testdb"
    assert ini.get("database", "max_connections", convert=int) == 20
    assert ini.get("database", "missing", "default_val") == "default_val"


def test_iniconfig_parse_error():
    malformed_ini = "invalid_key_without_section = value"
    try:
        iniconfig.IniConfig("malformed.ini", malformed_ini)
        raise AssertionError("Expected ParseError for invalid ini syntax")
    except iniconfig.ParseError:
        pass


def main():
    test_iniconfig_parsing_and_access()
    test_iniconfig_parse_error()
    print("All iniconfig 2.3.0 contract assertions passed successfully.")
    return 0


if __name__ == "__main__":
    sys.exit(main())