---
id: parameter-decorators
version: "0.0.2"
license: GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this license… (full text in the JSON record)
license_treatment: copyleft
maintenance: dormant
---

# parameter-decorators — Handy decorators for converting parameters

License: copyleft · Maintenance: dormant · Downloads: 314.9K/mo

## What it is and what it does

parameter-decorators is a small utility library that provides decorator functions to automatically convert function parameters from one type to another at call time. Instead of manually casting arguments inside your function, you decorate the function and specify which parameters should be converted and how. The example shows @str_to_path('input_file'), which converts a string argument to a Path object before the function receives it.

The package has no runtime dependencies and supports Python 3.7, 3.8, 3.9, 3.10, and 3.11. It is dormant—the last release was 2023-01-31, with no activity since 2023-10-03. The repository has minimal visibility (2 stars), suggesting it is either a personal utility or has seen limited adoption. The GNU General Public License Version 3 means any code that distributes this package must also be licensed under GPLv3.

Use it for:

- Decorate functions that accept file paths as strings to automatically convert them to Path objects for safer filesystem operations.
- Reduce boilerplate in functions that need to coerce arguments to specific types before processing.
- Apply consistent type conversions across multiple functions without repeating casting logic in each function body.
- Simplify function signatures by moving type-conversion logic into declarative decorators.

## Worth the install?

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

Provides decorators that automatically convert function parameters to specified types—for example, converting string arguments to Path objects without manual casting in the function body.

No, unless you have a specific need for parameter-conversion decorators and accept the GPLv3 copyleft constraint. The package is dormant with minimal community adoption, no recent maintenance, and limited documentation of its full decorator set. The single example shown is trivial to implement inline. Consider it only if you need a reusable decorator library and can commit to GPLv3 licensing.

## Install

pip install parameter-decorators
uv add parameter-decorators
poetry add parameter-decorators

## Installing parameter-decorators

Before you install: Installation is straightforward with no runtime dependencies. However, the package is dormant—last updated 2023-01-31 with no commits since 2023-10-03, and the repository has only 2 stars, suggesting minimal community adoption or ongoing maintenance.

License in practice: Licensed under GNU General Public License Version 3, 29 June 2007, a copyleft license. If you distribute software using this package, you must license your entire work under GPLv3 and make source code available to recipients.

Quickstart:

python3 -m pip install parameter-decorators

from parameter_decorators import str_to_path

@str_to_path('input_file')
def get_parent(input_file):
    return input_file.parent

print(get_parent('/usr/bin/python'))

Verify before relying:

- What specific parameter conversion decorators are included beyond str_to_path shown in the documentation excerpt.
- Whether the package handles edge cases like None values, type validation failures, or nested parameter structures.
- Performance characteristics when decorators are applied to functions with many parameters or called frequently.

## Package facts

- License: GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007 Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/> Everyone is permitted to copy and distribute verbatim copies of this license… (full text in the JSON record) (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 314.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

parameter type conversion decorators, automatic argument casting, function parameter decorators, convert function arguments, decorator-based type conversion, parameter transformation, argument preprocessing decorators, decorator, type-conversion

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