Merge pull request #45 from quantifyearth/mwd-version-number

Add version flag to command wrappers

Author: mdales

CHANGES.md

@@ -1,3 +1,9 @@
+## v2.0.3 (28/01/2026)
+
+### Added
+
+* Added `--version` flag to command line tools.
+
 ## v2.0.2 (27/01/2026)
 
 ### Fixed

aoh/aohcalc.py

@@ -1,5 +1,6 @@
 import argparse
 import logging
+from importlib.metadata import version
 from pathlib import Path
 
 from ._internal import aohcalc_fractional, aohcalc_binary
@@ -9,6 +10,11 @@
 
 def main() -> None:
     parser = argparse.ArgumentParser(description="Area of habitat calculator.")
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {version("aoh")}'
+    )
 
     # land cover/habitat map arguments - either single raster for binary or directory for many
     parser.add_argument(

aoh/habitat_process.py

@@ -2,6 +2,7 @@
 import os
 import logging
 from functools import partial
+from importlib.metadata import version
 from multiprocessing import Pool, cpu_count
 from pathlib import Path
 from typing import Optional, Set
@@ -159,6 +160,11 @@ def habitat_process(
 
 def main() -> None:
     parser = argparse.ArgumentParser(description="Downsample habitat map to raster per terrain type.")
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {version("aoh")}'
+    )
     parser.add_argument(
         '--habitat',
         type=Path,

aoh/summaries/endemism.py

@@ -7,6 +7,7 @@
 import sys
 import tempfile
 import time
+from importlib.metadata import version
 from pathlib import Path
 from multiprocessing import Manager, Process, Queue, cpu_count
 from typing import Dict, Optional, Set
@@ -213,7 +214,12 @@ def endemism(
 
 
 def main() -> None:
-    parser = argparse.ArgumentParser(description="Calculate species richness")
+    parser = argparse.ArgumentParser(description="Calculate species endemism")
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {version("aoh")}'
+    )
     parser.add_argument(
         "--aohs_folder",
         type=Path,

aoh/summaries/species_richness.py

@@ -4,8 +4,9 @@
 import sys
 import tempfile
 import time
-from pathlib import Path
+from importlib.metadata import version
 from multiprocessing import Manager, Process, Queue, cpu_count
+from pathlib import Path
 
 import yirgacheffe as yg
 
@@ -128,6 +129,11 @@ def species_richness(
 
 def main() -> None:
     parser = argparse.ArgumentParser(description="Calculate species richness")
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {version("aoh")}'
+    )
     parser.add_argument(
         "--aohs_folder",
         type=Path,

aoh/validation/collate_data.py

@@ -2,6 +2,7 @@
 import json
 import os
 import sys
+from importlib.metadata import version
 from pathlib import Path
 
 import pandas as pd
@@ -58,7 +59,12 @@ def collate_data(
     df.to_csv(output_path, index=False)
 
 def main() -> None:
-    parser = argparse.ArgumentParser(description="Collate metadata from AoH build.")
+    parser = argparse.ArgumentParser(description="Collate metadata from AOH build.")
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {version("aoh")}'
+    )
     parser.add_argument(
         '--aoh_results',
         type=Path,

aoh/validation/fetch_gbif_data.py

@@ -3,6 +3,7 @@
 import sys
 import time
 import zipfile
+from importlib.metadata import version
 from pathlib import Path
 from typing import Any, Dict, Optional, Tuple
 
@@ -249,6 +250,11 @@ def main() -> None:
             ''',
         formatter_class=argparse.RawDescriptionHelpFormatter,
     )
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {version("aoh")}'
+    )
     parser.add_argument(
         '--collated_aoh_data',
         type=Path,

aoh/validation/validate_map_prevalence.py

@@ -2,6 +2,7 @@
 # Based on R code authored by Franchesca Ridley.
 
 import argparse
+from importlib.metadata import version
 from pathlib import Path
 from typing import cast
 
@@ -194,6 +195,11 @@ def validate_map_prevalence(
 
 def main() -> None:
     parser = argparse.ArgumentParser(description="Validate map prevalence.")
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {version("aoh")}'
+    )
     parser.add_argument(
         '--collated_aoh_data',
         type=Path,

aoh/validation/validate_occurences.py

@@ -3,6 +3,7 @@
 import math
 import os
 from functools import partial
+from importlib.metadata import version
 from multiprocessing import cpu_count, Pool
 from pathlib import Path
 from typing import NamedTuple
@@ -190,6 +191,11 @@ def validate_occurrences(
 
 def main() -> None:
     parser = argparse.ArgumentParser(description="Validate occurrence prevelance.")
+    parser.add_argument(
+        '--version',
+        action='version',
+        version=f'%(prog)s {version("aoh")}'
+    )
     parser.add_argument(
         '--gbif_data_path',
         type=Path,

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "aoh"
-version = "2.0.2"
+version = "2.0.3"
 description = "A library for calculating Area of Habitat for species distribution mapping"
 authors = [
     {name = "Michael Dales", email = "mwd24@cam.ac.uk"}