Version 1.19.0 (beta 0)

Added

• Added support for FileObject nodes with file upload and download capabilities. New methods upload_from_path(path) and upload_from_bytes(content, name) allow setting file content before saving, while download_file(dest) enables downloading files to memory or streaming to disk for large files. (#ihs193)
• Added a 'py.typed' file to the project. This is to enable type checking when the Infrahub SDK is imported from other projects. The addition of this file could cause new typing issues in external projects until all typing issues have been resolved. Adding it to the project now to better highlight remaining issues.

Changed

• Updated branch report command to use node metadata for proposed change creator information instead of the deprecated relationship-based approach. Requires Infrahub 1.7 or above.

Fixed

• Allow SDK tracking feature to continue after encountering delete errors due to impacted nodes having already been deleted by cascade delete. (#265)

v1.18.1

1.18.1 - 2026-01-08

Fixed

• Reverted #723 (Fix code for HFID casting of strings that aren't UUIDs)

Version 1.18.0

Added

• Add ability to query for metadata on nodes to include information such as creation and update timestamps, creator and last user to update an object.
• Added ability to order nodes by metadata created_at or updated_at fields

Removed

• The previously deprecated 'background_execution' parameter under client.branch.create() was removed.

Fixed

• Rewrite and re-enable integration tests (#187)
• Fixed SDK including explicit null values for uninitialized optional relationships when creating nodes with object templates, which prevented the backend from applying template defaults. (#630)

Housekeeping

• Fixed Python 3.14 compatibility warnings. Testing now requires pytest>=9.

Full changelog

• IHS-173 Detect if a relationship is set from a profile by @gmazoyer in #686
• Bump astral-sh/setup-uv from 4 to 7 by @dependabot[bot] in #681
• Bump actions/checkout from 5 to 6 by @dependabot[bot] in #682
• Bump DavidAnson/markdownlint-cli2-action from 21 to 22 by @dependabot[bot] in #695
• Bump actions/cache from 4 to 5 by @dependabot[bot] in #694
• fix: python 3.14 deprecation warnings by @fatih-acar in #692
• Remove deprecated 'background_execution' param from client.branch.create() by @ogenstad in #696
• fix(analyzer): allowing passing a parsed query by @fatih-acar in #701
• Add ty as a type checker by @ogenstad in #702
• Add ability to query for node metadata by @ogenstad in #700
• Upgrade ty and cleanup rules by @ogenstad in #706
• Fix invalid return types by @ogenstad in #705
• Fix optional relationships preventing object template defaults from applying by @Copilot in #634
• Fixes for test annotations and split up rules by @ogenstad in #707
• Add annotations for clients and client_type by @ogenstad in #708
• Fix issue #713 and #712 by @BaptisteGi in #714
• Fix annotations on CTL tests by @ogenstad in #718
• Upgrade ruff=0.14.10 and fix new violation by @ogenstad in #724
• Use pathlib instead of os for Path operations by @ogenstad in #722
• Fix unsupported operator on MainSchemaTypes by @ogenstad in #721
• Upgrade ty=0.0.8 by @ogenstad in #723
• Fix test annotations on unit tests by @ogenstad in #720
• Convert and enable integration tests by @gmazoyer in #730
• Add ability to order results by metadata created_at or updated_at by @ogenstad in #698
• Fix code for HFID casting of strings that aren't UUIDs by @FragmentedPacket in #732
• Add docs for metadata and ordering by @minitriga in #735

Full Changelog: v1.17.0...v1.18.0

Release 1.15.2

Fixed

• Fixed SDK including explicit null values for uninitialized optional relationships when creating nodes with object templates, which prevented the backend from applying template defaults. (#630)

Version 1.17.0

Added

• Add support for Python 3.14

Removed

• Removed copier as a dependency, this impacts the infrahub repository init command and contains new instructions for how to initialize a repository from the template.
• Remove is_visible property from Infrahub

Full changelog

• IHS-176: Remove is_visible property from attribute metadata by @solababs in #603
• Set vale to ignore yaml files by @ogenstad in #664
• Validate uv.lock in CI by @ogenstad in #665
• Add AGENTS files by @dgarros in #609
• Pmc-20251201-docs by @petercrocker in #673
• Add ancestors and descendants support for hierarchical nodes by @Copilot in #659
• Fix linting violations after merge by @ogenstad in #675
• Add flake by @ogenstad in #676
• Update urllib3==2.6.0 by @ogenstad in #680
• Remove copier and provide workaround for 'infrahubctl repository init' by @ogenstad in #684
• Python 3.14 by @ogenstad in #663
• Fix boolean logic error in hierarchy support detection by @Copilot in #688

Full Changelog: v1.16.0...v1.17.0

Version 1.16.0

Added

• Added infrahubctl branch report command to help with cleaning up branches in Infrahub.

Changed

• Updated behaviour for recursive lookups for the conversion of nested relationships. Note that this change could cause issues in transforms or generators that use the convert_query_response feature if "id" or "__typename" isn't requested for nested related objects. (#389)
• The project now uses uv instead of poetry for package and dependency management.

Removed

• Remove is_visible property from infrahub
• Removed support for Python 3.9 (end of life)

Full changelog

• fix(cli): hide file paths in log output unless debug mode enabled by @petercrocker in #608
• Convert project to UV by @dgarros in #599
• Update infrahub-testcontainers by @ogenstad in #633
• Remove support for Python 3.9 by @ogenstad in #635
• Upgrade ruff by @ogenstad in #636
• Use ruff version from uv.lock in CI by @ogenstad in #638
• fix(ci): uv publish command by @fatih-acar in #639
• Allow recursive convertion to InfrahubNode objects by @ogenstad in #390
• Upgrade uv action version and pin Python version for test matrix by @ogenstad in #648
• Prefer next(iter()) over single element slice by @ogenstad in #643
• Simplify dictionary lookups by @ogenstad in #647
• Clear out test restrictions for Python 3.9 by @ogenstad in #649
• Update ruleset for shadowing builtins by @ogenstad in #645
• Use specific rule codes when using noqa by @ogenstad in #641
• Use a set literal when testing for membership by @ogenstad in #642
• Fix return annotations and changes for early returns by @ogenstad in #644
• Remove resolved rule ignores by @ogenstad in #650
• Unnecessary assignment to data before return statement by @ogenstad in #651
• Prefer Path.cwd() over Path().resolve() for current-directory lookups by @ogenstad in #653
• Linting: Probable insecure usage of temporary file or directory by @ogenstad in #652
• Correct autofixable ruff rules for Optional by @ogenstad in #646
• Bump actions/checkout from 5 to 6 by @dependabot[bot] in #658
• Add infrahubctl branch report command by @wvandeun in #637

Version 1.16.0b0

Removed

• Removed support for Python 3.9 (end of life)

Changed

• Updated behaviour for recursive lookups for the conversion of nested relationships. Note that this change could cause issues in transforms or generators that use the convert_query_response feature if "id" or "__typename" isn't requested for nested related objects. (#389)

Version 1.15.1

Fixed

• Fixed nested object template range expansion. (#624)

Version 1.15.0

Added

• Add create_diff method to create a diff summary between two timestamps
  Update get_diff_summary to accept optional time range parameters (#529)
• Add the ability to perform range expansions in object files. This feature allows users to define patterns in string fields that will be expanded into multiple objects, facilitating bulk object creation and management. The implementation includes validation to ensure that all expanded lists have the same length, preventing inconsistencies. Documentation has been updated to explain how to use this feature, including examples of valid and invalid configurations. (#560)
• Add convert_object_type method to allow converting an object to another type.
• Add graph_version and status properties to Branch
• Add infrahubctl graphql commands to export schema and generate Pydantic types from GraphQL queries
• Added deprecation warnings when loading or checking schemas

Changed

• Deprecate the use of raise_for_error=False across several methods, using a try/except pattern is preferred. (#493)

Fixed

• Respect default branch for client.query_gql_query() and client.set_context_properties() (#236)
• Fix branch creation with the sync client while setting wait_until_completion=False (#374)
• Replaced the Sync word in the protocol schema name so that the correct kind can be gotten from the cache (#380)
• Fix infrahubctl info command when run as an anonymous user (#398)
• JsonDecodeError now includes server response content in error message when JSON decoding fails, providing better debugging information for non-JSON server responses. (#473)
• Allow unsetting optional relationship of cardinality one by setting its value to None (#479)
• Bump docs dependencies (#519)
• Fix branch handling in _run_transform and execute_graphql_query functions in Infrahubctl to use environment variables for branch management. (#535)
• Allow the ability to clear optional attributes by setting them to None if they have been mutated by the user. (#549)
• Disable rich console print markup causing regex reformatting (#565)
• • Fixed issue with improperly escaped special characters in hfid fields and other string values in GraphQL mutations by implementing proper JSON-style string escaping

Housekeeping

• Handle error gracefully when loading schema instead of failing with an exception (#464)
• Replace toml package with tomllib and tomli optionally for when Python version is less than 3.11 (#528)

Version 1.15.0b1

What's Changed

• Use new mutation names for getting pool resources by @gmazoyer in #465
• Add protocols for Infrahub 1.4 by @ogenstad in #488
• Support infrahub.yml or infrahub.yaml configuration files by @petercrocker in #492
• Upgrade infrahub-testcontainers by @gmazoyer in #516
• IHS-152 Allow unsetting one-to-one relationship by @gmazoyer in #515
• Bump docs dependencies by @minitriga in #520
• IHS-154 Deprecate using raise_for_error = False by @gmazoyer in #508
• fix(docs): broken links to .infrahub.yml by @fatih-acar in #522
• Do not fail info command when user not set by @gmazoyer in #524
• Fix branch creation with sync client by @gmazoyer in #527
• Fix filters include parameter by @LucasG0 in #513
• Respect default branch for client.query_gql_query() by @ogenstad in #518
• Add create_diff to the clients to manually create a diff between two times. by @minitriga in #531
• Fix issue with render ctl command not using branch environment variables by @minitriga in #536
• Fix return types by @ogenstad in #541
• Remove unnecessary assignments before return statement by @ogenstad in #542
• Fix typing for substract params by @ogenstad in #540
• Clean up typing for proxy config by @ogenstad in #539
• add livestream to docs by @petercrocker in #544
• fix improperly escaped special characters in HFID by @BeArchiTek in #547
• IFC-1811: Replace toml package with tomllib and tomli optionally by @solababs in #551
• Add convert_object_type method by @LucasG0 in #554
• Add support for clearing optional attributes by @minitriga in #548
• IHS-147: Fix schema load failure exception by @solababs in #555
• Add to object conversion input by @LucasG0 in #558
• Fix JsonDecodeError to include server response content in error message by @Copilot in #553
• Object file range expansion by @minitriga in #561
• IHS-163 Add required change for IFC-1820 (display_label) by @gmazoyer in #556
• Increase default timeouts for transform/checks from 10 to 60. by @FragmentedPacket in #563
• Range Expansion Imrovements by @minitriga in #571
• IHS-170: Disable rich console print markup causing regex reformatting by @solababs in #574
• update docusaurus by @petercrocker in #567
• fixed broken link by @vsurresh in #474
• Add command to generate Pydantic model based on a GraphQL query by @dgarros in #546
• Add flags to CoreGeneratorDefinition to control when each generator should be executed by @dgarros in #578

New Contributors

• @solababs made their first contribution in #551
• @vsurresh made their first contribution in #474

Full Changelog: v1.14.0...v1.15.0b1