---
id: application-properties
version: "0.9.3"
license: MIT
license_treatment: permissive
maintenance: active
---

# application-properties — A simple, easy to use, unified manner of accessing program properties.

License: permissive · Maintenance: active · Downloads: 1.6M/mo

## What it is and what it does

application_properties is a configuration management library that loads application settings from JSON, YAML, and TOML files and provides a unified interface to retrieve them. It's designed for developers who need to add configuration handling to Python projects without complex setup, supporting hierarchical property names using dot notation and optional command-line property overrides.

The package separates configuration loading from value access, allowing custom loaders to be added. It includes an ApplicationPropertiesFacade object for restricting access to properties under a specific hierarchy—useful for plugin systems or multi-tenant scenarios. The library supports Python 3.10 through 3.13 and has been tested with over 280 tests and coverage above 99%.

Use it for:

- Load application settings from YAML or TOML files at startup and access them throughout your application.
- Restrict plugin or module access to only their relevant configuration subtree using ApplicationPropertiesFacade.
- Override specific configuration values via command line without modifying configuration files.
- Build a configuration system that supports multiple file formats (JSON, YAML, TOML) interchangeably.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Loads and retrieves application configuration from JSON, YAML, and TOML files with hierarchical property access and command-line override support.

Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and covers a common need (configuration retrieval) with solid test coverage. It's appropriate for projects requiring simple to moderately complex configuration handling without external service dependencies.

## Install

pip install application-properties
uv add application-properties
poetry add application-properties

## Installing application-properties

Before you install: Low install friction with four lightweight runtime dependencies (typing-extensions, tomli, pyyaml, pyjson5). Actively maintained with recent releases and no known vulnerabilities.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open-source and commercial projects.

Quickstart:

pip install application-properties

from application_properties import ApplicationProperties

props = ApplicationProperties()
props.load_from_file('config.yaml')
value = props.get_string_property('app.setting.name')

Requires Python 3.10 or later.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 1.6M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

configuration file loader, properties management, yaml json toml config, hierarchical configuration, application settings retrieval, configuration-management, plugin-friendly

[View on SkillFed](https://skillfed.io/packages/application-properties) · [View on PyPI](https://pypi.org/project/application-properties/)