Registry / aws / sample-helper-aws-appconfig

sample-helper-aws-appconfig

library2.3.2pypypi✓ verified 80d ago

A sample helper library for AWS AppConfig that simplifies configuration retrieval and management. Current version 2.3.1, supports Python >=3.10, <4.0.

aws devops

pip install sample-helper-aws-appconfig

github ↗package ↗

INSTALL

IMPORT

SIG · SAMPLE-HELPER-AWS-

sample-helper-aws-appconfig

awspythonv2.3.2

Install

4.5s avg

Import

—

Disk

61MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.3.2 · 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.95 runs

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

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 4.5s · import 0.000s · 66MB

61MB installed

● package 61MB

Code

Verified usage

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

AppConfigHelper

✓ from appconfig_helper import AppConfigHelper

✗ from sample_helper_aws_appconfig import AppConfigHelper

Initialize the helper with AppConfig identifiers and retrieve configuration.

import os from sample_helper_aws_appconfig import AppConfigHelper helper = AppConfigHelper( application='my-app', environment='production', configuration='my-config', client_id='my-client' ) config = helper.get_configuration() print(config)

Debug

Known issues

deprecatedThe `get_configuration` method returns raw configuration content without validation; use `get_configuration_validated` for schema validation.

fix

Use `helper.get_configuration_validated()` and provide a schema.

affects: >=1.0.0,<2.4.0

gotchaClient ID must be unique; reusing the same client ID across multiple instances may cause throttling.

fix

Generate a unique client ID per instance (e.g., using uuid.uuid4()).

affects: all

breakingIn version 2.0.0, the `get_configuration` method changed from returning a dict to returning a string. Code expecting a dict will break.

fix

Use `json.loads(helper.get_configuration())` to parse the string if needed.

affects: <2.0.0

Upgrade

Version history

2.3.2latest on PyPI · released May 18, 2026

Audit

Dependencies

boto3requiredAWS SDK for Python, required for AppConfig API calls

typing-extensionsoptionalBackports for type hints

Agent activity

19 hits · last 30 days

node

Resources

githubhttps://github.com/aws-samples/sample-python-helper-aws-appconfig ↗

packagehttps://pypi.org/project/sample-helper-aws-appconfig/ ↗