{"id":24466,"library":"python-zunclient","title":"python-zunclient","description":"Client library for OpenStack Zun (Container Management service). Version 5.4.0. This is a legacy OpenStack client, mainly in maintenance mode.","status":"maintenance","version":"5.4.0","language":"python","source_language":"en","source_url":"https://opendev.org/openstack/python-zunclient","tags":["openstack","zun","containers","client","cloud"],"install":[{"cmd":"pip install python-zunclient","lang":"bash","label":"PyPI install"}],"dependencies":[{"reason":"Authentication for OpenStack APIs","package":"keystoneauth1","optional":false},{"reason":"OpenStackClient common library","package":"osc-lib","optional":false}],"imports":[{"note":"","wrong":"","symbol":"client","correct":"from zunclient import client"}],"quickstart":{"code":"import os\nfrom zunclient import client\n\n# Create client using Keystone auth\nauth_url = os.environ.get('OS_AUTH_URL', 'http://localhost:5000/v3')\nproject_name = os.environ.get('OS_PROJECT_NAME', 'admin')\nusername = os.environ.get('OS_USERNAME', 'admin')\npassword = os.environ.get('OS_PASSWORD', 'admin')\nuser_domain_name = os.environ.get('OS_USER_DOMAIN_NAME', 'Default')\nproject_domain_name = os.environ.get('OS_PROJECT_DOMAIN_NAME', 'Default')\n\nkclient = client.Client(1, auth_url=auth_url,\n                        username=username,\n                        password=password,\n                        project_name=project_name,\n                        user_domain_name=user_domain_name,\n                        project_domain_name=project_domain_name)\nprint('Containers:', list(kclient.containers.list()))","lang":"python","description":"Initialize Zun client and list containers."},"warnings":[{"fix":"Specify the correct API version when creating the client: `client.Client(2, ...)` or `client.Client(1, ...)`.","message":"The library supports multiple API versions (1, 2). Version 2 is microversion-based. Using the wrong API version may cause unexpected AttributeErrors.","severity":"gotcha","affected_versions":"all"},{"fix":"Migrate to `openstacksdk` using `import openstack` and `conn = openstack.connect()`.","message":"OpenStack Zun and its client library are in maintenance mode. No new features are added; only critical bug fixes. Consider using the OpenStack SDK (openstacksdk) for a more modern and unified API.","severity":"deprecated","affected_versions":">=5.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use `from zunclient import client` (do not use `import zunclient` then `zunclient.client`).","cause":"Importing incorrectly; the correct module is `zunclient.client`.","error":"AttributeError: module 'zunclient' has no attribute 'client'"},{"fix":"Verify OpenStack services are running and the service catalog contains a 'container' endpoint. Ensure env vars OS_AUTH_URL, OS_USERNAME, etc. are correct.","cause":"No Zun service endpoint found in Keystone catalog. The service may not be enabled, or the auth URL is wrong.","error":"zunclient.exceptions.EndpointNotFound"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}