Merge remote-tracking branch 'origin/develop' into dga-2020319-prototype-pydantic

Author: dgarros

.github/workflows/ci.yml

@@ -76,7 +76,7 @@ jobs:
       - name: "Check out repository code"
         uses: "actions/checkout@v4"
       - name: "Setup environment"
-        run: "pip install ruff==0.8.6"
+        run: "pip install ruff==0.11.0"
       - name: "Linting: ruff check"
         run: "ruff check ."
       - name: "Linting: ruff format"
@@ -212,6 +212,7 @@ jobs:
           - "3.10"
           - "3.11"
           - "3.12"
+          - "3.13"
     if: |
       always() && !cancelled() &&
       !contains(needs.*.result, 'failure') &&

.github/workflows/sync-docs.yml

@@ -8,7 +8,8 @@ on:
       - stable
     paths:
       - 'docs/docs/**'
-      - 'docs/sidebars.ts'
+      - 'docs/sidebars-infrahubctl.ts'
+      - 'docs/sidebars-python-sdk.ts'
   pull_request:
     branches:
       - stable

CHANGELOG.md

@@ -11,6 +11,47 @@ This project uses [*towncrier*](https://towncrier.readthedocs.io/) and the chang
 
 <!-- towncrier release notes start -->
 
+## [1.9.2](https://github.com/opsmill/infrahub-sdk-python/tree/v1.9.2) - 2025-03-26
+
+### Changed
+
+- Remove hfid in upsert payload, to improve node upsert performances
+
+## [1.9.1](https://github.com/opsmill/infrahub-sdk-python/tree/v1.9.1) - 2025-03-21
+
+### Fixed
+
+- Fixed an issue where the process_nodes method in the generators used the old format of the schema hash, so node population didn't work
+
+## [1.9.0](https://github.com/opsmill/infrahub-sdk-python/tree/v1.9.0) - 2025-03-21
+
+### Added
+
+- Add 'schema_hash' parameter to client.schema.all to only optionally refresh the schema if the provided hash differs from what the client has already cached. ([#152](https://github.com/opsmill/infrahub-sdk-python/issues/152))
+
+### Changed
+
+- CoreStandardGroups created or updated by a generator in Infrahub are now stored as a member of the CoreGeneratorGroup. Previously they were being stored as children of the CoreGeneratorGroup.
+
+### Fixed
+
+- The SDK client query methods (get, filters, all) default behaviour has changed. The query methods will store the retrieved nodes in the internal store by default, where previously this behaviour had to be enabled explicitly using the `populate_store` argument. ([#15](https://github.com/opsmill/infrahub-sdk-python/issues/15))
+
+## [1.8.0](https://github.com/opsmill/infrahub-sdk-python/tree/v1.8.0) - 2025-03-19
+
+### Deprecated
+
+- Timestamp: Direct access to `obj` and `add_delta` have been deprecated and will be removed in a future version. ([#255](https://github.com/opsmill/infrahub-sdk-python/issues/255))
+
+### Added
+
+- Added support for Enum in GraphQL query and mutation. ([#18](https://github.com/opsmill/infrahub-sdk-python/issues/18))
+
+### Fixed
+
+- Refactored Timestamp to use `whenever` instead of `pendulum` and extend Timestamp with `add()`, `subtract()`, and `to_datetime()`. ([#255](https://github.com/opsmill/infrahub-sdk-python/issues/255))
+- Fixed support for Python 3.13 as it's no longer required to have Rust installed on the system.
+
 ## [1.7.2](https://github.com/opsmill/infrahub-sdk-python/tree/v1.7.2) - 2025-03-07
 
 ### Added
@@ -26,6 +67,14 @@ This project uses [*towncrier*](https://towncrier.readthedocs.io/) and the chang
 ### Fixed
 
 - `protocols` CTL command properly gets default branch setting from environment variable. ([#104](https://github.com/opsmill/infrahub-sdk-python/issues/104))
+- Fix typing for Python 3.9 ([#251](https://github.com/opsmill/infrahub-sdk-python/issues/251))
+- Refactor Timestamp to use `whenever` instead of `pendulum` and extend Timestamp with add(), subtract(), and to_datetime(). ([#255](https://github.com/opsmill/infrahub-sdk-python/issues/255))
+- Remove default value "main" for branch parameter from all Infrahub CTL commands. ([#264](https://github.com/opsmill/infrahub-sdk-python/issues/264))
+- Fixed support for Python 3.13, it's no longer required to have Rust installed on the system.
+
+### Housekeeping
+
+- Move the function `read_file` from the ctl module to the SDK.
 - Fixed typing for Python 3.9 and removed support for Python 3.13. ([#251](https://github.com/opsmill/infrahub-sdk-python/issues/251))
 - Removed default value "main" for branch parameter from all Infrahub CTL commands. ([#264](https://github.com/opsmill/infrahub-sdk-python/issues/264))
 

changelog/+store-group-as-member-of-generator-group.changed.md

@@ -19,26 +19,7 @@ The `get` and `filters` query methods allow you to use filters. Filters specify
 
 ### Discovering available filters
 
-The easiest way to discover the available filters for a kind of node is by querying the schema.
-
-<Tabs groupId="async-sync">
-  <TabItem value="Async" default>
-
-  ```python
-  tag_schema = await client.schema.get("BuiltinTag")
-  print(tag_schema.filters)
-  ```
-
-  </TabItem>
-  <TabItem value="Sync">
-
-  ```python
-  tag_schema = client.schema.get("BuiltinTag")
-  print(tag_schema.filters)
-  ```
-
-  </TabItem>
-</Tabs>
+The easiest way to discover the available filters for a kind of node is by opening the GraphQLi Explorer in the GraphQL sandbox. Under each GraphQL query you will find the available filters.
 
 ### Attribute filters
 
@@ -435,7 +416,8 @@ You can exclude attributes and relationships that are retrieved with a query by
 
 ### Fetching relationships manually
 
-The `fetch` method can be used to retrieve relationships that are not retrieved as part of a query. The `fetch` method will initialized the relationship, if was not yet initialized and retrieve the related nodes.
+The `fetch` method can be used to retrieve relationships, initialize them; and retrieving the related nodes manually.
+The `fetch` method can also be used on relationship that were previously initialized.
 
 <Tabs groupId="async-sync">
   <TabItem value="Async" default>
@@ -466,8 +448,6 @@ The `fetch` method can be used to retrieve relationships that are not retrieved
   </TabItem>
 </Tabs>
 
-The `fetch` method can also be used to `fetch` the related nodes of a relationship that was already initialized or retrieved as part of the query.
-
 <Tabs groupId="async-sync">
   <TabItem value="Async" default>
 

changelog/15.fixed.md

@@ -1,27 +1,28 @@
 ---
 title: Python SDK
 ---
-import Tabs from '@theme/Tabs';
-import TabItem from '@theme/TabItem';
-
-# Python SDK
 
 The Infrahub Python SDK greatly simplifies how you can interact with Infrahub programmatically.
 
+## Blog Posts
+
+- [Querying Data in Infrahub via the Python SDK](https://www.opsmill.com/querying-data-in-infrahub-via-the-python-sdk/)
+
 ## Guides
 
-- [Installing infrahub-sdk](./guides/installation)
-- [Creating a client](./guides/client)
-- [Querying data in Infrahub](./guides/query_data)
-- [Managing nodes](./guides/create_update_delete)
-- [Managing branches](./guides/branches)
-- [Using the client store](./guides/store)
-- [Using the client tracking mode](./guides/tracking)
+- [Installing infrahub-sdk](./guides/installation.mdx)
+- [Creating a client](./guides/client.mdx)
+- [Querying data in Infrahub](./guides/query_data.mdx)
+- [Managing nodes](./guides/create_update_delete.mdx)
+- [Managing branches](./guides/branches.mdx)
+- [Using the client store](./guides/store.mdx)
+- [Using the client tracking mode](./guides/tracking.mdx)
 
 ## Topics
 
-- [Understanding tracking in the Python SDK](./topics/tracking)
+- [Understanding tracking in the Python SDK](./topics/tracking.mdx)
 
 ## Reference
 
-- [Client configuration](./reference/config)
+- [Client configuration](./reference/config.mdx)
+- [Python SDK Release Notes](https://github.com/opsmill/infrahub-sdk-python/releases)