Install mapfile_parser as a command through pip for compatibility with uvx

Author: AngheloAlf

CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Install a `mapfile_parser` program script when installing the library through
+  `pip`.
+  - This provides the same functionality as running the library module with
+    `python3 -m mapfile_parser`.
+  - This should allow better integration with tools like `uvx` or `pipx`.
+
 ## [2.11.0] - 2025-09-08
 
 ### Added

Cargo.lock

@@ -3,7 +3,7 @@
 
 [package]
 name = "mapfile_parser"
-version = "2.11.0"
+version = "2.12.0-dev0"
 edition = "2021"
 rust-version = "1.74.0"
 authors = ["Anghelo Carvajal <angheloalf95@gmail.com>"]

Cargo.toml

@@ -95,10 +95,12 @@ Various cli examples are provided in the [frontends folder](src/mapfile_parser/f
 Most of them are re-implementations of already existing tools using this
 library to show how to use this library and inspire new ideas.
 
-The list can be checked in runtime with `python3 -m mapfile_parser --help`.
+The list can be checked in runtime with `python3 -m mapfile_parser --help` or
+`mapfile_parser --help`.
 
-Each one of them can be executed with `python3 -m mapfile_parser utilityname`,
-for example `python3 -m mapfile_parser pj64_syms`.
+Each one of them can be executed with `python3 -m mapfile_parser utilityname` or
+`mapfile_parser utilityname`, for example `python3 -m mapfile_parser pj64_syms`
+or `mapfile_parser objdiff_report`.
 
 - `bss_check`: Check that globally visible bss has not been reordered.
 - `first_diff`: Find the first difference(s) between the built ROM and the base

README.md

@@ -3,7 +3,7 @@
 
 [project]
 name = "mapfile_parser"
-version = "2.11.0"
+version = "2.12.0-dev0"
 description = "Map file parser library focusing decompilation projects"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -25,6 +25,9 @@ classifiers = [
 requires = ["maturin>=1.2,<2.0"]
 build-backend = "maturin"
 
+[project.scripts]
+mapfile_parser = "mapfile_parser.__main__:mapfileParserMain"
+
 [tool.cibuildwheel]
 skip = ["cp36-*"]
 

pyproject.toml

@@ -5,8 +5,8 @@
 
 from __future__ import annotations
 
-__version_info__ = (2, 11, 0)
-__version__ = ".".join(map(str, __version_info__)) # + "-dev0"
+__version_info__ = (2, 12, 0)
+__version__ = ".".join(map(str, __version_info__)) + "-dev0"
 __author__ = "Decompollaborate"
 
 from . import utils as utils