Skip to content

Rename the allometry inventory creators to with_gdam_allometry and with_crown_base_height_allometry (breaking) - #253

Merged
amarcozzi merged 1 commit into
mainfrom
252-allometry-creator-names
Nov 5, 2026
Merged

amarcozzi merged 1 commit into
mainfrom
252-allometry-creator-names

Conversation

@amarcozzi

Copy link
Copy Markdown
Contributor

Closes #252.

Renames the two allometry inventory creators. Both take an existing inventory and return the same trees with columns added, so from_ named the wrong thing. The new names follow the API's allometry routes (allometry/gdam, allometry/crown_base_height).

Old New
create_tree_inventory_from_gdam create_tree_inventory_with_gdam_allometry
create_tree_inventory_from_crown_base_height create_tree_inventory_with_crown_base_height_allometry

Breaking: a hard rename with no aliases. Release as 0.26.0.

Updated the functions and __all__, the docstring cross-references in inventories.py and grids.py, docs/v2/guides/inventories.md, v2_api_design.md, and the tests (functions and test class names).

Checks

  • No reference to the old names remains outside the generated client.
  • pytest tests/v2/test_inventories.py -k "WithGdamAllometry or WithCrownBaseHeightAllometry or BuildCrownBaseHeightModel" against the live API: 22 passed.
  • pre-commit (black, flake8): passed.

Downstream

FastFuels-Web docs call create_tree_inventory_from_gdam in six files and create_tree_inventory_from_crown_base_height on the upload how-to. A docs PR follows after the release.

create_tree_inventory_from_gdam -> create_tree_inventory_with_gdam_allometry
create_tree_inventory_from_crown_base_height ->
create_tree_inventory_with_crown_base_height_allometry

Both take an existing inventory and return the same trees with columns
added, so from_ named the wrong thing. The new names follow the API's
allometry routes. Breaking: no aliases.
@amarcozzi amarcozzi added 🎨 design Get our your crayons v2 FastFuels v2 API / SDK work labels Nov 5, 2026
@amarcozzi amarcozzi self-assigned this Nov 5, 2026
@amarcozzi
amarcozzi merged commit e1a3f24 into main Nov 5, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

🎨 design Get our your crayons v2 FastFuels v2 API / SDK work

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Rename the allometry inventory creators to with_gdam_allometry and with_crown_base_height_allometry (breaking)

1 participant