v2.15.0

2.15.0 (2026-07-13)

Features

• add a pluggable RNG seam for native embedders (#423) (54103bd)
• add infomap-network v1.0 JSON input format (#645) (#668) (a15e3c4)
• allow naming state nodes via addStateNode, wire through Python/R (#799) (0638d54)
• expose max/min flow iterations and flow tolerance in the API (#764) (3a4b868)
• python: accept an options= carrier on the graph community finders (e4d2f1f)
• python: accept an options= carrier on the stateful Infomap (d127c87)
• python: add infomap.datasets with the bundled example networks (#712) (3e083f3)
• python: add Result.summary() and Result.to_series() (#783) (8ddd19d)
• python: add Result.to_networkx and Result.to_igraph methods (8e56bf2)
• python: add signature-tier metadata to the parameter catalog (#751) (f7451bb)
• python: close builder/data-model gaps and type the Infomap facade (b09384f)
• python: emit type annotations on the generated Infomap signatures (#752) (46883c8)
• python: file writers on Result and Network (#766) (e4537cf)
• python: guard run() inputs, validate initial_partition, advise on Network logging (b84c3b2)
• python: make infomap.run the canonical run entry point (0210c27)
• python: mark non-engine Options fields in the generated docstring (3fa4176)
• python: public io namespace, tl re-exports, and API consistency cleanups (f73e5dc)
• python: render the Infomap summary card as Result.repr_html (1764c05)
• python: route the engine log through Python logging (#763) (182fc6a)
• python: sand down Result/Network agent-usability edges (9cfb82d)
• python: steer Options errors and publish a machine-readable option catalog (08f1911)
• python: surface the common-tier options on the run() signature (4354fe0)
• python: type the Network builder; ship py.typed in the sdist (be70823)
• python: validate numeric options against the catalog's ranges (d50903a)
• python: validate option values and steer agents off usability traps (450efce)
• python: warn on legacy instance accessors; clearer empty-network error (d731321)
• python: warn when args-only output options can't take effect (b4c30aa)
• python: widen num_threads to str | int | None via a types override (0ebf437)

Bug Fixes

• honor --max-flow-iterations in regularized multilayer flow (94905a7)
• python: align and tidy the graph-library adapter surface (90cebe0)
• python: attribute the export mismatch warning to the caller; unify two error types (72dacf2)
• python: correct error types, path handling, and duplicated helpers (6149487)
• python: correct factual slips surfaced by the API review (9472b69)
• python: correct hide_bipartite_nodes docs and surface random-move defaults (4a3bb7e)
• python: correct the binding_default return annotation (1087300)
• python: don't flag a 2x2 array as a dense adjacency matrix (132d754)
• python: don't flag verbosity_level inert under routed DEBUG logging (25d588a)
• python: don't warn that hide_bipartite_nodes is inert (4406f21)
• python: emit a runtime deprecation warning on the legacy Infomap methods (31903e7)
• python: emit the advanced-tier deprecation warning from infomap.run() (4c9d394)
• python: extend Result legacy-accessor hints to camelCase spellings (c32c17e)
• python: import pandas lazily to avoid OpenMP duplicate-runtime abort (#709) (eaffa4a)
• python: keep native attribute types in to_networkx and to_igraph (7c1b31b)
• python: keep the option generator in sync with the directed/flow_model fix (9822347)
• python: make the Python API silent by default (#735) (a53c0a6)
• python: only warn on a real directed/flow_model conflict (34ff4c6)
• python: re-export engine log hooks under their private names (c88f7ea)
• python: redirect legacy accessors on Result; correct the directed docs (689d97f)
• python: regenerate JS parameter metadata and address review comments (56b223c)
• python: resolve API review findings (f793470)
• python: route result.py iterator types through _core, not _swig (2bcc2be)
• python: sharpen run() front-door warnings and error messages (01f1f4c)
• python: sharpen two error surfaces on the run/result API (4830216)
• python: stop the default Result read path nagging and trim guard lectures (9e01007)
• python: turn agent-facing run/Network/Result footguns into guided errors (9a9723f)
• python: validate the choices and bindingOnly override sections (412f1c8)
• python: warn on deprecated pretty and attribute option warnings to user code (894c628)
• python: warn once per Network that its engine is silent for life (3a72905)
• python: warning and logging behavior for the 3.0 deprecation surface (d49061f)

Performance Improvements

• python: compute effective-num-modules lazily in Result (#701) (c147cb0)

Reverts

• C++17 follow-up refactors (#725–#730) (#731) (094ba1f)