The fabric-cicd library just hit v1.0.0 — a huge milestone for the project! This release brings some significant changes, so if you're already using the library, please read through the breaking changes before upgrading. Let's break it all down.

Breaking Changes — Read Before Upgrading!

This release introduces some important breaking changes that require action on your part:

• Explicit token credential is now required. The default credential fallback has been removed. You must now explicitly pass a token credential — no more implicit authentication as a safety net.
• Implicit authentication in Fabric Notebook has been removed. Explicit token credential is also required when running fabric-cicd from the Fabric Notebook context.
• FabricWorkspace and deploy_with_config now require keyword-only arguments. Update your function calls to use explicit keyword arguments.
• Identity logging has been removed along with the disable_print_identity feature flag. Optionally remove the no longer existing flag.

These changes make authentication more intentional and secure. Please review the updated documentation for more information on supported authentication here: Getting Started - fabric-cicd.

New Item Support

• Ontology item type is now supported. New to the Fabric ecosystem, you can now deploy Ontology items as part of your CI/CD pipelines.

New Functionality

• Better deployment transparency: deploy_with_config now gives clearer feedback on success and failure scenarios, making it much easier to debug pipelines.
• Unpublish operations now collect API responses: API response collection has been extended to unpublish operations, giving you better visibility across the full deployment lifecycle.
• New get_changed_items() utility function: Detect Fabric items changed via git diff and use them for selective deployment — a great way to speed up your pipelines by only deploying what actually changed. Special thanks to u/vipulb91 for this awesome contribution!

Bug Fixes

Quite a few important fixes landed in this release:

• Prevent unintended GUID replacements in Variable Library item files during publish.
• Fix YAML content check to properly reject non-YAML files (like Notebooks) during key_value_replace parameterization, preventing file corruption.
• Fix Notebook deployment failures caused by non-deterministic ordering of definition files in the API payload (Convert py to ipynb failed with unexpected error).
• Parameter file is now ignored when not explicitly defined in the config file — no more surprise behavior.
• New enable_hard_delete feature flag to bypass the workspace recycle bin during unpublish operations.
• Addition of a timeout for long-running operation polling to prevent pipelines from hanging indefinitely.

Get Started

Check out the full release notes here: https://github.com/microsoft/fabric-cicd/releases/tag/v1.0.0

To upgrade:

pip install fabric-cicd==1.0.0

Relevant Links

• fabric-cicd GitHub
• fabric-cicd Docs
• Raise a GitHub Issue