{"id":28177,"library":"sfmergeutility","title":"Service Fabric Yaml Merge Utility","description":"A utility for merging Service Fabric YAML configuration files, part of the Azure CLI extensions. Currently at version 0.1.6, with low release cadence.","status":"active","version":"0.1.6","language":"python","source_language":"en","source_url":"https://github.com/Azure/azure-cli-extensions","tags":["azure","service-fabric","yaml","merge","cli-extension"],"install":[{"cmd":"pip install sfmergeutility","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"YAML parsing and merging","package":"pyyaml","optional":false}],"imports":[{"note":"Common mistake: merge_yaml is exposed at package level, not in submodules.","wrong":"from sfmergeutility.utils import merge_yaml","symbol":"merge_yaml","correct":"from sfmergeutility import merge_yaml"}],"quickstart":{"code":"from sfmergeutility import merge_yaml\n\nbase = {'service': {'name': 'myapp'}}\noverride = {'service': {'replicas': 3}}\nresult = merge_yaml(base, override)\nprint(result)","lang":"python","description":"Merges two YAML dictionaries, with override taking precedence."},"warnings":[{"fix":"Consider migrating to Azure Resource Manager templates or Bicep for Service Fabric deployments.","message":"The package is part of azure-cli-extensions and may be deprecated in favor of native ARM template or Bicep deployments.","severity":"deprecated","affected_versions":"all"},{"fix":"If you need to merge lists, handle them manually before calling merge_yaml.","message":"merge_yaml performs deep merge but lists are overwritten, not concatenated.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Ensure you have installed the correct version: pip install sfmergeutility==0.1.6","cause":"merge_yaml is not imported correctly due to package version mismatch or incorrect installation.","error":"ImportError: cannot import name 'merge_yaml' from 'sfmergeutility'"},{"fix":"Upgrade to version 0.1.6: pip install --upgrade sfmergeutility","cause":"Using an older version of the package that did not expose merge_yaml at package level.","error":"AttributeError: module 'sfmergeutility' has no attribute 'merge_yaml'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}