Registry / data / glance-store

glance-store

library5.5.0pypypi✓ verified 82d ago

OpenStack Image Service Store Library, providing a unified interface to store and retrieve virtual machine images in various backends (filesystem, Swift, Ceph/RBD, HTTP, etc.). Current version: 5.4.0. Python 3.10+ required. Released under Apache 2.0, maintained by the OpenStack community.

data database

pip install glance-store

package ↗homepage ↗

INSTALL

IMPORT

SIG · GLANCE-STORE

glance-store

datapythonv5.5.0

Install

7.1s avg

Import

—

Disk

71MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v5.5.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.915 runs

installs and imports cleanly · install 0.0s · import 0.000s · 67.8MB

glibc

py 3.10–3.915 runs

installs and imports cleanly · install 7.1s · import 0.000s · 65MB

71MB installed

● package 71MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GlanceStoreException

✓ from glance_store import GlanceStoreException

✗ from glance_store import GlanceStore

BackendException

✓ from glance_store import BackendException

BadStoreUri

✓ from glance_store import BadStoreUri

Initialize GlanceStore with a config file or overrides. Requires oslo.config setup. Adjust paths and config as needed.

import os from glance_store import GlanceStore # Configuration: must provide a config file or dict config_path = os.environ.get('GLANCE_CONFIG', '/etc/glance/glance-store.conf') if not os.path.exists(config_path): # Minimal in-memory config for testing (filesystem backend) from oslo_config import cfg cfg.CONF([], project='glance', default_config_files=[]) cfg.CONF.set_override('filesystem_store_datadir', '/tmp/images', group='glance_store') store = GlanceStore() store.configure() # Example: get image location (assuming image ID exists) image_id = 'some-image-uuid' # locations = store.get_locations(image_id) print('Store initialized, ready to use.')

Debug

Known issues

breakingPython 2 support removed in Stein release (5.0.0). Requires Python 3.10+ from version 5.4.0.

fix

Upgrade to Python 3.10+. If stuck on Python 2/3.6, use glance-store 4.x.

affects: >=5.0.0

deprecatedThe 'swift' store driver is deprecated in favor of 'http' store with swift authentication. Removal planned in future release.

fix

Migrate to http store driver with swift endpoint configuration.

affects: >=5.0.0

gotchaConfiguration must be explicitly loaded before any store operations. Forgot to call store.configure()? Common cause of 'ConfigNotFound' errors.

fix

Always call store.configure() with a valid configuration object or file path.

affects: all

Upgrade

Version history

5.5.0latest on PyPI · released May 22, 2026

Audit

Dependencies

oslo.configrequiredConfiguration management required by OpenStack services

oslo.utilsrequiredUtility functions for time parsing, exception handling, etc.

oslo.i18nrequiredInternationalization support

stevedorerequiredDriver manager for backends (Cinder, Swift, etc.)

keystoneauth1optionalAuthentication for Swift and HTTP backends

python-swiftclientoptionalRequired for Swift store driver

python-cephclientoptionalRequired for Ceph/RBD store driver

Agent activity

11 hits · last 30 days

node

Resources

packagehttps://pypi.org/project/glance-store/ ↗

homepagehttps://docs.openstack.org/glance_store/latest/ ↗