iiconf 0.0.2__tar.gz

iiconf-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lqxnjk
+
+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.

iiconf-0.0.2/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.5
+Name: iiconf
+Version: 0.0.2
+Summary: Parse INI and .env text into plain dictionaries.
+Project-URL: Homepage, https://github.com/lqxnjk/iiconf
+Author: lqxnjk
+License: MIT
+License-File: LICENSE
+Keywords: config,dotenv,env,ini,settings
+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 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# iiconf
+
+Read INI and `.env` files into plain dicts — no classes, no global state, no
+environment mutation.
+
+## Install
+
+```console
+pip install iiconf
+```
+
+## Usage
+
+```python
+from iiconf import load_config, parse_env, parse_ini
+
+parse_env("""
+# local settings
+export HOST=localhost
+PORT=5432
+MOTTO="hello # not a comment"
+""")
+# {'HOST': 'localhost', 'PORT': '5432', 'MOTTO': 'hello # not a comment'}
+
+parse_ini("""
+key = before-section
+[db]
+host = localhost
+port = 5432
+""")
+# {'': {'key': 'before-section'}, 'db': {'host': 'localhost', 'port': '5432'}}
+
+load_config("settings.ini")
+```
+
+## Behaviour
+
+| Aspect | Detail |
+| --- | --- |
+| Comments | `#` to end of line, except inside quotes |
+| Quotes | surrounding `'` or `"` stripped |
+| Separator | `=` or `:`, first occurrence only |
+| Substitution | **not** performed, `${X}` stays literal |
+| Unparseable line | `ValueError` |
+
+Values stay strings on purpose: guessing whether `"0123"` is a number or an ID
+is how leading zeros get lost.
+
+## License
+
+MIT

iiconf-0.0.2/README.md

@@ -0,0 +1,51 @@
+# iiconf
+
+Read INI and `.env` files into plain dicts — no classes, no global state, no
+environment mutation.
+
+## Install
+
+```console
+pip install iiconf
+```
+
+## Usage
+
+```python
+from iiconf import load_config, parse_env, parse_ini
+
+parse_env("""
+# local settings
+export HOST=localhost
+PORT=5432
+MOTTO="hello # not a comment"
+""")
+# {'HOST': 'localhost', 'PORT': '5432', 'MOTTO': 'hello # not a comment'}
+
+parse_ini("""
+key = before-section
+[db]
+host = localhost
+port = 5432
+""")
+# {'': {'key': 'before-section'}, 'db': {'host': 'localhost', 'port': '5432'}}
+
+load_config("settings.ini")
+```
+
+## Behaviour
+
+| Aspect | Detail |
+| --- | --- |
+| Comments | `#` to end of line, except inside quotes |
+| Quotes | surrounding `'` or `"` stripped |
+| Separator | `=` or `:`, first occurrence only |
+| Substitution | **not** performed, `${X}` stays literal |
+| Unparseable line | `ValueError` |
+
+Values stay strings on purpose: guessing whether `"0123"` is a number or an ID
+is how leading zeros get lost.
+
+## License
+
+MIT

iiconf-0.0.2/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "iiconf"
+version = "0.0.2"
+description = "Parse INI and .env text into plain dictionaries."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "lqxnjk" }]
+keywords = ["config", "ini", "dotenv", "env", "settings"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/lqxnjk/iiconf"
+
+[tool.pytest.ini_options]
+pythonpath = ["src"]
+testpaths = ["tests"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/iiconf"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/iiconf", "tests", "README.md", "LICENSE"]

iiconf-0.0.2/src/iiconf/__init__.py

@@ -0,0 +1,101 @@
+"""
+Author: lqxnjk <lqxnjk@qq.com>
+Created: 2026-10-23 10:25
+Modified: 2026-10-23 10:25
+Python Version: 3.10
+Minimal INI and .env parsing.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+__all__ = ["parse_env", "parse_ini"]
+
+_SECTION_RE = re.compile(r"^\s*\[(?P<name>[^\]]+)\]\s*$")
+_PAIR_RE = re.compile(r"^\s*(?P<key>[^=:\s]+)\s*[=:]\s*(?P<value>.*?)\s*$")
+_QUOTES = ("'", '"')
+
+
+def _strip_comment(m_line: str) -> str:
+    """Cut an inline ``#`` comment, ignoring hashes inside quotes."""
+    quote: str | None = None
+    for index, char in enumerate(m_line):
+        if quote:
+            if char == quote:
+                quote = None
+        elif char in _QUOTES:
+            quote = char
+        elif char == "#":
+            return m_line[:index]
+    return m_line
+
+
+def _unquote(m_value: str) -> str:
+    if len(m_value) >= 2 and m_value[0] == m_value[-1] and m_value[0] in _QUOTES:
+        return m_value[1:-1]
+    return m_value
+
+
+def parse_env(m_text: str) -> dict[str, str]:
+    """Parse dotenv text into ``{key: value}``.
+
+    Blank lines and ``#`` comments are skipped, an optional ``export`` prefix is
+    removed, and surrounding quotes are stripped. Values are never evaluated —
+    ``${OTHER}`` stays literal, because a config parser that executes
+    substitutions is a config parser that surprises you.
+    """
+    result: dict[str, str] = {}
+    for line in m_text.splitlines():
+        stripped = _strip_comment(line).strip()
+        if not stripped:
+            continue
+        if stripped.lower().startswith("export "):
+            stripped = stripped[7:].strip()
+        match = _PAIR_RE.match(stripped)
+        if not match:
+            raise ValueError(f"cannot parse line: {line!r}")
+        result[match.group("key")] = _unquote(match.group("value"))
+    return result
+
+
+def parse_ini(m_text: str) -> dict[str, dict[str, str]]:
+    """Parse INI text into ``{section: {key: value}}``.
+
+    Keys before the first section land under ``""``. Values keep ``=`` and ``:``
+    characters after the first separator; quotes are stripped.
+    """
+    result: dict[str, dict[str, str]] = {}
+    current = ""
+    for line in m_text.splitlines():
+        stripped = _strip_comment(line).strip()
+        if not stripped:
+            continue
+        section = _SECTION_RE.match(stripped)
+        if section:
+            current = section.group("name").strip()
+            result.setdefault(current, {})
+            continue
+        match = _PAIR_RE.match(stripped)
+        if not match:
+            raise ValueError(f"cannot parse line: {line!r}")
+        result.setdefault(current, {})[match.group("key")] = _unquote(match.group("value"))
+    return result
+
+
+def load_config(m_path: str | Path) -> dict[str, object]:
+    """Parse a file, choosing the format from its suffix.
+
+    ``.ini`` / ``.cfg`` use :func:`parse_ini`; everything else is treated as
+    dotenv. An unsupported suffix raises ``ValueError`` so a typo in the path
+    cannot be mistaken for an empty config.
+    """
+    path = Path(m_path)
+    text = path.read_text(encoding="utf-8")
+    suffix = path.suffix.lower()
+    if suffix in (".ini", ".cfg"):
+        return parse_ini(text)
+    if suffix in (".env", "", ".txt"):
+        return parse_env(text)
+    raise ValueError(f"unsupported config suffix: {suffix!r}")

iiconf-0.0.2/tests/test_iiconf.py

@@ -0,0 +1,53 @@
+"""
+Author: lqxnjk <lqxnjk@qq.com>
+Created: 2026-10-23 10:25
+Modified: 2026-10-23 10:25
+Python Version: 3.10
+"""
+
+import pytest
+
+from iiconf import load_config, parse_env, parse_ini
+
+
+def test_env_basic() -> None:
+    assert parse_env("A=1\nB = two\n") == {"A": "1", "B": "two"}
+
+
+def test_env_export_and_quotes() -> None:
+    assert parse_env("export A=1\nB='x y'\nC=\"z\"\n") == {"A": "1", "B": "x y", "C": "z"}
+
+
+def test_env_comments_and_blanks() -> None:
+    assert parse_env("# c\n\nA=1 # tail\nB=\"keep # this\"\n") == {"A": "1", "B": "keep # this"}
+
+
+def test_ini_sections() -> None:
+    text = "key = v0\n[db]\nhost = localhost\nport: 5432\n"
+    assert parse_ini(text) == {"": {"key": "v0"}, "db": {"host": "localhost", "port": "5432"}}
+
+
+def test_no_substitution() -> None:
+    assert parse_env("A=${B}\n") == {"A": "${B}"}
+
+
+def test_unparseable_line() -> None:
+    with pytest.raises(ValueError):
+        parse_env("this is not a pair\n")
+
+
+def test_load_config_dispatch(tmp_path) -> None:
+    ini = tmp_path / "a.ini"
+    ini.write_text("[s]\nk = 1\n", encoding="utf-8")
+    assert load_config(ini) == {"s": {"k": "1"}}
+
+    env = tmp_path / "a.env"
+    env.write_text("K=1\n", encoding="utf-8")
+    assert load_config(env) == {"K": "1"}
+
+
+def test_unsupported_suffix(tmp_path) -> None:
+    target = tmp_path / "a.yaml"
+    target.write_text("k: 1\n", encoding="utf-8")
+    with pytest.raises(ValueError):
+        load_config(target)