iniconfig 2.3.0: IniConfig, ParseError, iscommentline

# iniconfig INI Parsing and Configuration

This sample pins `iniconfig` 2.3.0 and verifies core `IniConfig`, `ParseError`, `iscommentline`, and line tracking capabilities.

The contract verifies:
- `IniConfig` parses INI-formatted text with section headers into dictionary-like sections.
- Sections and `IniConfig` support typed value conversions via `get(..., convert=type)` and fallback defaults.
- Source line number tracking via `lineof()` for both section headers and individual keys.
- Comment line detection using `iscommentline()` with standard comment characters `#` and `;`.
- Raising `ParseError` containing error message, line number, and path when invalid INI content is parsed.

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
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - packageManager: npm@10.9.8
  - runtime: node@22.23.2

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:84e295e9f2f9215cefbc288518e5c55de24ed7b702548ebeabf8683796489acb","contract":["IniConfig parses INI-formatted text and section blocks into dictionary-like sections accessible by name.","SectionWrapper and IniConfig support typed value conversion via get(..., convert=type) and default fallback values.","IniConfig.lineof and SectionWrapper.lineof return source line numbers for section headers and specific keys.","iscommentline correctly identifies comment lines prefixed by COMMENTCHARS ('#' or ';') as well as empty lines.","IniConfig raises ParseError with lineno, path, and message attributes on malformed syntax without section header."],"goal":"verify pkg:pypi/iniconfig@2.3.0","kind":"HOW","packages":["pkg:pypi/iniconfig@2.3.0"],"schemaVersion":1,"symbols":["iniconfig.IniConfig","iniconfig.ParseError","iniconfig.iscommentline","iniconfig.COMMENTCHARS"]},"contractCommand":["python","test/contract.py"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"pypi","executionContext":"python","language":"python","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"pip","runtime":"python","schemaVersion":1},"license":"MIT-0","packages":["pkg:pypi/iniconfig@2.3.0"],"schemaVersion":1,"subject":"pkg:pypi/iniconfig@2.3.0","symbols":["iniconfig.IniConfig","iniconfig.ParseError","iniconfig.iscommentline","iniconfig.COMMENTCHARS"],"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"
  ],
  "symbols": [
    "iniconfig.IniConfig",
    "iniconfig.ParseError",
    "iniconfig.iscommentline",
    "iniconfig.COMMENTCHARS"
  ]
}

import iniconfig

ini_content = """# Global comment
[app]
name = SampleApp
port = 8080
debug = true
multiline = line1
    line2

; Another section
[database]
host = 127.0.0.1
max_connections = 50
"""

ini = iniconfig.IniConfig("test.ini", ini_content)

# 1. Section membership and iteration
assert "app" in ini
assert "database" in ini
assert "nonexistent" not in ini
assert len(ini.sections) == 2
section_names = [sec.name for sec in ini]
assert section_names == ["app", "database"]

# 2. Section indexing and items
app_sec = ini["app"]
assert app_sec.name == "app"
assert app_sec["name"] == "SampleApp"
assert app_sec["port"] == "8080"
assert app_sec["multiline"] == "line1\nline2"
assert list(app_sec) == ["name", "port", "debug", "multiline"]
items_dict = dict(app_sec.items())
assert items_dict["name"] == "SampleApp"
assert items_dict["port"] == "8080"

# 3. Value conversion and default fallbacks
assert app_sec.get("port", convert=int) == 8080
assert app_sec.get("missing_key", default="default_val") == "default_val"
assert ini.get("database", "host") == "127.0.0.1"
assert ini.get("database", "max_connections", convert=int) == 50
assert ini.get("database", "missing", default=100, convert=int) == 100
assert ini.get("nonexistent", "key", default="fallback") == "fallback"

# 4. Source line tracking with lineof
assert ini.lineof("app") == 2
assert ini.lineof("app", "name") == 3
assert ini.lineof("app", "port") == 4
assert app_sec.lineof("port") == 4
assert ini.lineof("database") == 10
assert ini.lineof("database", "host") == 11

# 5. Comment detection and COMMENTCHARS
assert "#" in iniconfig.COMMENTCHARS and ";" in iniconfig.COMMENTCHARS
assert iniconfig.iscommentline("# This is a comment") is True
assert iniconfig.iscommentline("; This is also a comment") is True
assert iniconfig.iscommentline("   # Indented comment") is True
assert iniconfig.iscommentline("name = value") is False
assert iniconfig.iscommentline("") is True

# 6. ParseError on invalid syntax
try:
    iniconfig.IniConfig("invalid.ini", "key_without_section = value")
    raise AssertionError("Expected ParseError when key appears before section header")
except iniconfig.ParseError as err:
    assert err.path == "invalid.ini"
    assert err.lineno == 0
    assert "no section header" in str(err.msg).lower() or "no section header" in str(err).lower()

print("CONTRACT PASS: iniconfig@2.3.0 verified offline")