moveq-cli 0.1.0__tar.gz

moveq_cli-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, moveq contributors
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

moveq_cli-0.1.0/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: moveq-cli
+Version: 0.1.0
+Summary: Command-line tool for moveq — compute equity metrics from CSV or JSON without writing Python.
+Author-email: Soura <martisoura@gmail.com>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/SVamseekar/moveq
+Project-URL: Documentation, https://github.com/SVamseekar/moveq/blob/main/docs/getting_started.md
+Project-URL: Repository, https://github.com/SVamseekar/moveq
+Project-URL: Issues, https://github.com/SVamseekar/moveq/issues
+Project-URL: Changelog, https://github.com/SVamseekar/moveq/blob/main/CHANGELOG.md
+Keywords: transport,equity,accessibility,cli,gini,palma
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: moveq>=0.1.0
+Provides-Extra: frames
+Requires-Dist: moveq[frames]; extra == "frames"
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Dynamic: license-file
+
+# moveq-cli
+
+Command-line interface for [`moveq`](https://pypi.org/project/moveq/): compute
+equity metrics, composite accessibility scores, and validate country
+harmonization catalogues from CSV or JSON without writing Python.
+
+[![PyPI](https://img.shields.io/pypi/v/moveq-cli.svg)](https://pypi.org/project/moveq-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/moveq-cli.svg)](https://pypi.org/project/moveq-cli/)
+[![License](https://img.shields.io/pypi/l/moveq-cli.svg)](https://github.com/SVamseekar/moveq/blob/main/LICENSE)
+
+## Installation
+
+Requires Python 3.10+.
+
+```bash
+pip install moveq-cli
+```
+
+This installs the `moveq` console script and pulls in `moveq` (and therefore
+`moveq-core` and `moveq-catalogue`).
+
+## Commands
+
+### Inequality metrics from CSV
+
+```bash
+moveq gini data.csv --value trips --weight population
+moveq palma data.csv --value trips --weight population
+moveq ci data.csv --value trips --rank deprivation_rank --weight population
+```
+
+### Composite scoring
+
+```bash
+moveq score --terms '{"coverage": 0.8, "evening": 0.5, "frequency": null}' \
+            --weights '{"coverage": 0.5, "evening": 0.3, "frequency": 0.2}'
+
+moveq score score_config.json --json
+```
+
+### Catalogue validation
+
+```bash
+moveq catalogue validate country_catalogue.json
+```
+
+## Documentation
+
+- [Getting started & CLI guide](https://github.com/SVamseekar/moveq/blob/main/docs/getting_started.md)
+- [API reference](https://github.com/SVamseekar/moveq/blob/main/docs/api_reference.md)
+- [Source repository](https://github.com/SVamseekar/moveq)
+- [Changelog](https://github.com/SVamseekar/moveq/blob/main/CHANGELOG.md)
+
+## License
+
+[BSD 3-Clause](https://github.com/SVamseekar/moveq/blob/main/LICENSE).

moveq_cli-0.1.0/README.md

@@ -0,0 +1,56 @@
+# moveq-cli
+
+Command-line interface for [`moveq`](https://pypi.org/project/moveq/): compute
+equity metrics, composite accessibility scores, and validate country
+harmonization catalogues from CSV or JSON without writing Python.
+
+[![PyPI](https://img.shields.io/pypi/v/moveq-cli.svg)](https://pypi.org/project/moveq-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/moveq-cli.svg)](https://pypi.org/project/moveq-cli/)
+[![License](https://img.shields.io/pypi/l/moveq-cli.svg)](https://github.com/SVamseekar/moveq/blob/main/LICENSE)
+
+## Installation
+
+Requires Python 3.10+.
+
+```bash
+pip install moveq-cli
+```
+
+This installs the `moveq` console script and pulls in `moveq` (and therefore
+`moveq-core` and `moveq-catalogue`).
+
+## Commands
+
+### Inequality metrics from CSV
+
+```bash
+moveq gini data.csv --value trips --weight population
+moveq palma data.csv --value trips --weight population
+moveq ci data.csv --value trips --rank deprivation_rank --weight population
+```
+
+### Composite scoring
+
+```bash
+moveq score --terms '{"coverage": 0.8, "evening": 0.5, "frequency": null}' \
+            --weights '{"coverage": 0.5, "evening": 0.3, "frequency": 0.2}'
+
+moveq score score_config.json --json
+```
+
+### Catalogue validation
+
+```bash
+moveq catalogue validate country_catalogue.json
+```
+
+## Documentation
+
+- [Getting started & CLI guide](https://github.com/SVamseekar/moveq/blob/main/docs/getting_started.md)
+- [API reference](https://github.com/SVamseekar/moveq/blob/main/docs/api_reference.md)
+- [Source repository](https://github.com/SVamseekar/moveq)
+- [Changelog](https://github.com/SVamseekar/moveq/blob/main/CHANGELOG.md)
+
+## License
+
+[BSD 3-Clause](https://github.com/SVamseekar/moveq/blob/main/LICENSE).

moveq_cli-0.1.0/pyproject.toml

@@ -0,0 +1,58 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "moveq-cli"
+version = "0.1.0"
+description = "Command-line tool for moveq — compute equity metrics from CSV or JSON without writing Python."
+readme = "README.md"
+license = "BSD-3-Clause"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+authors = [
+    { name = "Soura", email = "martisoura@gmail.com" },
+]
+keywords = [
+    "transport",
+    "equity",
+    "accessibility",
+    "cli",
+    "gini",
+    "palma",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Scientific/Engineering",
+]
+dependencies = [
+    "moveq>=0.1.0",
+]
+
+[project.optional-dependencies]
+frames = ["moveq[frames]"]
+test = ["pytest>=7"]
+
+[project.scripts]
+moveq = "moveq_cli.main:main"
+
+[project.urls]
+Homepage = "https://github.com/SVamseekar/moveq"
+Documentation = "https://github.com/SVamseekar/moveq/blob/main/docs/getting_started.md"
+Repository = "https://github.com/SVamseekar/moveq"
+Issues = "https://github.com/SVamseekar/moveq/issues"
+Changelog = "https://github.com/SVamseekar/moveq/blob/main/CHANGELOG.md"
+
+[tool.setuptools.packages.find]
+where = ["src"]

moveq_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

moveq_cli-0.1.0/src/moveq_cli/__init__.py

@@ -0,0 +1,3 @@
+"""moveq-cli — command-line tool for moveq."""
+
+__version__ = "0.1.0"

moveq_cli-0.1.0/src/moveq_cli/__main__.py

@@ -0,0 +1,5 @@
+import sys
+from moveq_cli.main import main
+
+if __name__ == "__main__":
+    sys.exit(main())

moveq_cli-0.1.0/src/moveq_cli/main.py

@@ -0,0 +1,232 @@
+"""``moveq`` command-line tool.
+
+    moveq gini data.csv --value trips --weight population
+    moveq palma data.csv --value trips --weight population
+    moveq ci data.csv --value trips --rank deprivation_rank --weight population
+    moveq score --terms '{"coverage": 0.8, "evening": 0.5}' --weights '{"coverage": 0.6, "evening": 0.4}'
+    moveq score config.json
+    moveq catalogue validate config.json
+"""
+
+from __future__ import annotations
+
+import argparse
+import csv
+import json
+import sys
+from pathlib import Path
+from typing import Any
+
+import numpy as np
+
+from moveq_catalogue import Catalogue, SectionAction
+from moveq_core import (
+    compute_concentration_index,
+    compute_gini,
+    compute_palma_ratio,
+    compute_score,
+)
+
+
+def _read_columns(path: str, columns: list[str]) -> dict[str, np.ndarray]:
+    with open(path, newline="", encoding="utf-8") as fh:
+        reader = csv.DictReader(fh)
+        rows = list(reader)
+    if not rows:
+        raise ValueError(f"{path} has no data rows")
+    missing = [c for c in columns if c not in rows[0]]
+    if missing:
+        raise ValueError(f"{path} is missing column(s): {', '.join(missing)}")
+    return {c: np.array([float(r[c]) for r in rows]) for c in columns}
+
+
+def _cmd_gini(args: argparse.Namespace) -> int:
+    cols = _read_columns(args.csv, [args.value, args.weight])
+    result = compute_gini(cols[args.value], cols[args.weight])
+    print(f"gini: {result:.4f}")
+    return 0
+
+
+def _cmd_palma(args: argparse.Namespace) -> int:
+    cols = _read_columns(args.csv, [args.value, args.weight])
+    result = compute_palma_ratio(cols[args.value], cols[args.weight])
+    print(f"palma: {result:.4f}")
+    return 0
+
+
+def _cmd_ci(args: argparse.Namespace) -> int:
+    cols = _read_columns(args.csv, [args.value, args.rank, args.weight])
+    result = compute_concentration_index(cols[args.value], cols[args.rank], cols[args.weight])
+    print(f"concentration_index: {result:.4f}")
+    return 0
+
+
+def _cmd_score(args: argparse.Namespace) -> int:
+    terms: dict[str, Any] = {}
+    weights: dict[str, float] = {}
+    labels: dict[str, str] | None = None
+    n_areas: int | None = None
+    context: dict[str, str] | None = None
+
+    if args.config:
+        with open(args.config, encoding="utf-8") as fh:
+            data = json.load(fh)
+        terms = data.get("terms", {})
+        weights = data.get("weights", {})
+        labels = data.get("labels")
+        n_areas = data.get("n_areas")
+        context = data.get("context")
+    else:
+        if not args.terms or not args.weights:
+            raise ValueError("Either provide a config file or both --terms and --weights arguments")
+        terms = json.loads(args.terms)
+        weights = json.loads(args.weights)
+        if args.labels:
+            labels = json.loads(args.labels)
+        if args.context:
+            context = json.loads(args.context)
+        n_areas = args.n_areas
+
+    result = compute_score(
+        terms=terms,
+        weights=weights,
+        labels=labels,
+        n_areas=n_areas,
+        context=context,
+    )
+
+    if args.json:
+        print(json.dumps(result.to_dict(), indent=2))
+        return 0
+
+    if result.score is None:
+        print("score: None")
+    else:
+        print(f"score: {result.score:.1f}")
+
+    if result.note:
+        print(f"note: {result.note}")
+
+    print("components:")
+    for comp in result.components:
+        if comp.missing:
+            print(f"  - {comp.id} ({comp.label}): missing, design_weight={comp.design_weight:.2f}")
+        else:
+            print(
+                f"  - {comp.id} ({comp.label}): value={comp.value:.4f}, "
+                f"design_weight={comp.design_weight:.2f}, weight_used={comp.weight_used:.4f}"
+            )
+    return 0
+
+
+def _cmd_catalogue_validate(args: argparse.Namespace) -> int:
+    with open(args.config, encoding="utf-8") as fh:
+        data = json.load(fh)
+
+    country = data.get("country")
+    if not country:
+        raise ValueError("Catalogue config missing required 'country' field")
+
+    base_sections = data.get("base_sections")
+    if not base_sections or not isinstance(base_sections, list):
+        raise ValueError("Catalogue config missing or invalid 'base_sections' list")
+
+    catalogue = Catalogue(base_sections, country=country)
+
+    for item in data.get("mappings", []):
+        section_id = item.get("section_id")
+        action_str = item.get("action")
+        if not section_id or not action_str:
+            raise ValueError(f"Mapping item missing section_id or action: {item}")
+        action = SectionAction(action_str)
+        catalogue.register(
+            section_id,
+            action,
+            note=item.get("note"),
+            replacement_title=item.get("replacement_title"),
+        )
+
+    issues = catalogue.validate()
+
+    if args.json:
+        out = catalogue.to_dict()
+        out["issues"] = issues
+        out["valid"] = len(issues) == 0
+        print(json.dumps(out, indent=2))
+        return 0 if not issues else 1
+
+    summary = catalogue.summary()
+    print(f"country: {country}")
+    print(f"summary: same={summary['same']}, replace={summary['replace']}, omit={summary['omit']}")
+
+    if issues:
+        print("validation errors:")
+        for issue in issues:
+            print(f"  - {issue}")
+        return 1
+
+    print("status: valid (fully specified)")
+    return 0
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(prog="moveq", description="Transport-equity metrics and catalogue tools.")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    # Gini
+    gini = sub.add_parser("gini", help="Population-weighted Gini coefficient")
+    gini.add_argument("csv", help="Path to input CSV file")
+    gini.add_argument("--value", required=True, help="Service-level column")
+    gini.add_argument("--weight", required=True, help="Population-weight column")
+    gini.set_defaults(func=_cmd_gini)
+
+    # Palma
+    palma = sub.add_parser("palma", help="Palma ratio (top 10%% / bottom 40%%)")
+    palma.add_argument("csv", help="Path to input CSV file")
+    palma.add_argument("--value", required=True, help="Service-level column")
+    palma.add_argument("--weight", required=True, help="Population-weight column")
+    palma.set_defaults(func=_cmd_palma)
+
+    # Concentration Index
+    ci = sub.add_parser("ci", help="Wagstaff Concentration Index")
+    ci.add_argument("csv", help="Path to input CSV file")
+    ci.add_argument("--value", required=True, help="Service-level column")
+    ci.add_argument("--rank", required=True, help="Ranking column (e.g. deprivation rank)")
+    ci.add_argument("--weight", required=True, help="Population-weight column")
+    ci.set_defaults(func=_cmd_ci)
+
+    # Score
+    score = sub.add_parser("score", help="Compute weighted composite score with graceful missing-term handling")
+    score.add_argument("config", nargs="?", default=None, help="Path to JSON configuration file")
+    score.add_argument("--terms", help="JSON dictionary of terms: e.g. '{\"coverage\": 0.8}'")
+    score.add_argument("--weights", help="JSON dictionary of design weights: e.g. '{\"coverage\": 0.5}'")
+    score.add_argument("--labels", help="JSON dictionary of human-readable labels")
+    score.add_argument("--context", help="JSON dictionary of free-form context")
+    score.add_argument("--n-areas", type=int, help="Count of areal units")
+    score.add_argument("--json", action="store_true", help="Output machine-readable JSON")
+    score.set_defaults(func=_cmd_score)
+
+    # Catalogue
+    cat_parser = sub.add_parser("catalogue", help="Cross-country catalogue harmonization tools")
+    cat_sub = cat_parser.add_subparsers(dest="subcommand", required=True)
+
+    cat_val = cat_sub.add_parser("validate", help="Validate a country's section catalogue against base sections")
+    cat_val.add_argument("config", help="Path to JSON catalogue configuration file")
+    cat_val.add_argument("--json", action="store_true", help="Output machine-readable JSON")
+    cat_val.set_defaults(func=_cmd_catalogue_validate)
+
+    return parser
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    try:
+        return args.func(args)
+    except (ValueError, FileNotFoundError, json.JSONDecodeError) as exc:
+        print(f"error: {exc}", file=sys.stderr)
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())

moveq_cli-0.1.0/src/moveq_cli.egg-info/PKG-INFO

@@ -0,0 +1,91 @@
+Metadata-Version: 2.4
+Name: moveq-cli
+Version: 0.1.0
+Summary: Command-line tool for moveq — compute equity metrics from CSV or JSON without writing Python.
+Author-email: Soura <martisoura@gmail.com>
+License-Expression: BSD-3-Clause
+Project-URL: Homepage, https://github.com/SVamseekar/moveq
+Project-URL: Documentation, https://github.com/SVamseekar/moveq/blob/main/docs/getting_started.md
+Project-URL: Repository, https://github.com/SVamseekar/moveq
+Project-URL: Issues, https://github.com/SVamseekar/moveq/issues
+Project-URL: Changelog, https://github.com/SVamseekar/moveq/blob/main/CHANGELOG.md
+Keywords: transport,equity,accessibility,cli,gini,palma
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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 :: Scientific/Engineering
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: moveq>=0.1.0
+Provides-Extra: frames
+Requires-Dist: moveq[frames]; extra == "frames"
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Dynamic: license-file
+
+# moveq-cli
+
+Command-line interface for [`moveq`](https://pypi.org/project/moveq/): compute
+equity metrics, composite accessibility scores, and validate country
+harmonization catalogues from CSV or JSON without writing Python.
+
+[![PyPI](https://img.shields.io/pypi/v/moveq-cli.svg)](https://pypi.org/project/moveq-cli/)
+[![Python versions](https://img.shields.io/pypi/pyversions/moveq-cli.svg)](https://pypi.org/project/moveq-cli/)
+[![License](https://img.shields.io/pypi/l/moveq-cli.svg)](https://github.com/SVamseekar/moveq/blob/main/LICENSE)
+
+## Installation
+
+Requires Python 3.10+.
+
+```bash
+pip install moveq-cli
+```
+
+This installs the `moveq` console script and pulls in `moveq` (and therefore
+`moveq-core` and `moveq-catalogue`).
+
+## Commands
+
+### Inequality metrics from CSV
+
+```bash
+moveq gini data.csv --value trips --weight population
+moveq palma data.csv --value trips --weight population
+moveq ci data.csv --value trips --rank deprivation_rank --weight population
+```
+
+### Composite scoring
+
+```bash
+moveq score --terms '{"coverage": 0.8, "evening": 0.5, "frequency": null}' \
+            --weights '{"coverage": 0.5, "evening": 0.3, "frequency": 0.2}'
+
+moveq score score_config.json --json
+```
+
+### Catalogue validation
+
+```bash
+moveq catalogue validate country_catalogue.json
+```
+
+## Documentation
+
+- [Getting started & CLI guide](https://github.com/SVamseekar/moveq/blob/main/docs/getting_started.md)
+- [API reference](https://github.com/SVamseekar/moveq/blob/main/docs/api_reference.md)
+- [Source repository](https://github.com/SVamseekar/moveq)
+- [Changelog](https://github.com/SVamseekar/moveq/blob/main/CHANGELOG.md)
+
+## License
+
+[BSD 3-Clause](https://github.com/SVamseekar/moveq/blob/main/LICENSE).

moveq_cli-0.1.0/src/moveq_cli.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/moveq_cli/__init__.py
+src/moveq_cli/__main__.py
+src/moveq_cli/main.py
+src/moveq_cli.egg-info/PKG-INFO
+src/moveq_cli.egg-info/SOURCES.txt
+src/moveq_cli.egg-info/dependency_links.txt
+src/moveq_cli.egg-info/entry_points.txt
+src/moveq_cli.egg-info/requires.txt
+src/moveq_cli.egg-info/top_level.txt
+tests/test_main.py

moveq_cli-0.1.0/src/moveq_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

moveq_cli-0.1.0/src/moveq_cli.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+moveq = moveq_cli.main:main

moveq_cli-0.1.0/src/moveq_cli.egg-info/requires.txt

@@ -0,0 +1,7 @@
+moveq>=0.1.0
+
+[frames]
+moveq[frames]
+
+[test]
+pytest>=7

moveq_cli-0.1.0/src/moveq_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+moveq_cli

moveq_cli-0.1.0/tests/test_main.py

@@ -0,0 +1,153 @@
+import csv
+import io
+import json
+from contextlib import redirect_stdout
+
+from moveq_cli.main import main
+
+
+def _write_csv(path, rows, fieldnames):
+    with open(path, "w", newline="", encoding="utf-8") as fh:
+        writer = csv.DictWriter(fh, fieldnames=fieldnames)
+        writer.writeheader()
+        writer.writerows(rows)
+
+
+def test_gini_command(tmp_path):
+    csv_path = tmp_path / "data.csv"
+    _write_csv(
+        csv_path,
+        [{"trips": "10", "population": "100"}, {"trips": "10", "population": "100"}],
+        ["trips", "population"],
+    )
+    buf = io.StringIO()
+    with redirect_stdout(buf):
+        code = main(["gini", str(csv_path), "--value", "trips", "--weight", "population"])
+    assert code == 0
+    assert "gini: 0.0000" in buf.getvalue()
+
+
+def test_palma_command(tmp_path):
+    csv_path = tmp_path / "data.csv"
+    _write_csv(
+        csv_path,
+        [{"trips": str(i * 10), "population": "100"} for i in range(1, 11)],
+        ["trips", "population"],
+    )
+    buf = io.StringIO()
+    with redirect_stdout(buf):
+        code = main(["palma", str(csv_path), "--value", "trips", "--weight", "population"])
+    assert code == 0
+    assert "palma:" in buf.getvalue()
+
+
+def test_ci_command(tmp_path):
+    csv_path = tmp_path / "data.csv"
+    _write_csv(
+        csv_path,
+        [
+            {"trips": "10", "dep_rank": "1", "population": "100"},
+            {"trips": "20", "dep_rank": "2", "population": "100"},
+        ],
+        ["trips", "dep_rank", "population"],
+    )
+    buf = io.StringIO()
+    with redirect_stdout(buf):
+        code = main(["ci", str(csv_path), "--value", "trips", "--rank", "dep_rank", "--weight", "population"])
+    assert code == 0
+    assert "concentration_index:" in buf.getvalue()
+
+
+def test_missing_column_returns_error(tmp_path):
+    csv_path = tmp_path / "data.csv"
+    _write_csv(csv_path, [{"trips": "10"}], ["trips"])
+    code = main(["gini", str(csv_path), "--value", "trips", "--weight", "population"])
+    assert code == 1
+
+
+def test_score_inline_args():
+    buf = io.StringIO()
+    with redirect_stdout(buf):
+        code = main([
+            "score",
+            "--terms",
+            '{"coverage": 0.8, "evening": 0.5, "frequency": null}',
+            "--weights",
+            '{"coverage": 0.5, "evening": 0.3, "frequency": 0.2}',
+        ])
+    assert code == 0
+    out = buf.getvalue()
+    assert "score: 68.8" in out
+    assert "renormalised" in out
+
+
+def test_score_json_config(tmp_path):
+    config_path = tmp_path / "score_config.json"
+    config_path.write_text(
+        json.dumps({
+            "terms": {"coverage": 0.8, "evening": 0.5},
+            "weights": {"coverage": 0.6, "evening": 0.4},
+        }),
+        encoding="utf-8",
+    )
+    buf = io.StringIO()
+    with redirect_stdout(buf):
+        code = main(["score", str(config_path), "--json"])
+    assert code == 0
+    data = json.loads(buf.getvalue())
+    assert data["score"] == 68.0
+
+
+def test_score_missing_arguments():
+    code = main(["score"])
+    assert code == 1
+
+
+def test_catalogue_validate_valid(tmp_path):
+    cat_path = tmp_path / "catalogue.json"
+    cat_path.write_text(
+        json.dumps({
+            "country": "france",
+            "base_sections": ["s1", "s2", "s3"],
+            "mappings": [
+                {"section_id": "s1", "action": "same"},
+                {"section_id": "s2", "action": "replace", "replacement_title": "Local S2"},
+                {"section_id": "s3", "action": "omit", "note": "No census data available"},
+            ],
+        }),
+        encoding="utf-8",
+    )
+    buf = io.StringIO()
+    with redirect_stdout(buf):
+        code = main(["catalogue", "validate", str(cat_path)])
+    assert code == 0
+    assert "status: valid (fully specified)" in buf.getvalue()
+
+
+def test_catalogue_validate_invalid_unmapped(tmp_path):
+    cat_path = tmp_path / "catalogue_unmapped.json"
+    cat_path.write_text(
+        json.dumps({
+            "country": "france",
+            "base_sections": ["s1", "s2"],
+            "mappings": [
+                {"section_id": "s1", "action": "same"},
+            ],
+        }),
+        encoding="utf-8",
+    )
+    buf = io.StringIO()
+    with redirect_stdout(buf):
+        code = main(["catalogue", "validate", str(cat_path), "--json"])
+    assert code == 1
+    data = json.loads(buf.getvalue())
+    assert data["valid"] is False
+    assert len(data["issues"]) == 1
+
+
+def test_help_command():
+    try:
+        main(["--help"])
+    except SystemExit as exc:
+        assert exc.code == 0
+