sample-helper-aws-appconfig

What it is and what it does

sample-helper-aws-appconfig is a Python client library that simplifies fetching and managing configuration from AWS AppConfig. It wraps the AppConfig Data API, handling token tracking, poll intervals, and content-type parsing automatically so you don't have to manage those details yourself.

The library supports YAML, JSON, and plain-text configurations, with flexible refresh strategies: fetch on initialization, on every read (if stale), or on demand. You specify a minimum refresh interval in seconds, and the library enforces it to avoid excessive API calls. It works across AWS Lambda, EC2, and on-premises environments, and integrates with boto3 for credential and region management.

Use it for:

• Fetch feature flags or environment-specific settings in Lambda functions without managing AppConfig API tokens manually.
• Periodically reload application configuration in a web service at a controlled interval without polling on every request.
• Store and retrieve YAML or JSON configuration profiles from AppConfig with automatic parsing and type conversion.
• Centralize configuration for multi-environment deployments using AppConfig profiles.
• Reduce boilerplate when integrating AppConfig into Python applications by handling API state and content negotiation.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Fetches and caches configuration from AWS AppConfig, handling API token tracking, multiple content types (YAML, JSON, plain text), and configurable refresh intervals.

Yes. The package solves a real problem (AppConfig API complexity) with low install friction, active maintenance, no vulnerabilities, and permissive licensing. It's most valuable if you're already using AWS AppConfig and want to avoid writing token-tracking and parsing logic yourself; less critical if you only need occasional config fetches or prefer direct boto3 calls.

Install

sample-helper-aws-appconfig on PyPI

pip install sample-helper-aws-appconfig

uv add sample-helper-aws-appconfig

poetry add sample-helper-aws-appconfig

Installing sample-helper-aws-appconfig

Before you install

Low friction: pure Python wheel with four common runtime dependencies (PyYAML, boto3, botocore, urllib3). Actively maintained with recent commits and no known vulnerabilities.

License in practice

Licensed under Apache-2.0 (permissive), allowing use in commercial and open-source projects with minimal restrictions beyond attribution.

Quickstart

pip install sample-helper-aws-appconfig

from sample_helper_aws_appconfig import AppConfigHelper

appconfig = AppConfigHelper(
    "MyAppConfigApp",
    "MyAppConfigEnvironment",
    "MyAppConfigProfile",
    45
)

if appconfig.update_config():
    print("New configuration received")
config_value = appconfig.config

Requires AWS credentials configured (via environment, IAM role, or boto3.Session) and an existing AWS AppConfig application, environment, and configuration profile.

Verify before relying

• Whether the 15-second minimum refresh interval is enforced at initialization or only during updates.
• Whether fetch_on_read and fetch_on_init are mutually exclusive or can both be enabled.
• Performance characteristics when polling frequently in high-concurrency environments.

Package facts

Evidence: sample_helper_aws_appconfig-2.3.2-py3-none-any.whl

Keywords: aws, appconfig

Tags

More Software Development packages