Metadata-Version: 2.4
Name: init-once
Version: 0.1.0
Summary: Utility for initialization that runs an extra function once before a function is called
Author-email: Elcaro377 <Elcaro377@outlook.com>
License: MIT
Project-URL: Homepage, https://github.com/Elcaro377/init-once
Project-URL: Repository, https://github.com/Elcaro377/init-once.git
Project-URL: Issues, https://github.com/Elcaro377/init-once/issues
Keywords: decorator,lazy-initialization,once,function
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: build>=1.0; extra == "dev"
Requires-Dist: twine>=4.0; extra == "dev"
Dynamic: license-file

English | [简体中文](README.zh-CN.md)

# init_once

## Introduction

`init_once` is a decorator that ensures an initialization function is executed **only once before the first call of the decorated function**. The initialization logic will not be repeated on subsequent calls to the decorated function.

## Dependencies and Version Requirements

- Python 3.8 or higher

## Usage

### Basic Syntax

```python
@init_once(initializer, *init_args, **init_kwds)
def func(...):
    ...
```

- `initializer`: The initialization function that needs to be executed once.
- `*init_args`: Positional arguments to pass to `initializer`.
- `**init_kwds`: Keyword arguments to pass to `initializer`.

### Simple Example

```python
from init_once import init_once

# Initialization function: runs only once
def init_func(msg: str):
    print(f"Initializing msg: {msg}")

@init_once(init_func, "hello")
def main_task(data: str):
    print(f"Processing: {data}")

# First call: init_func executes first, then main_task
main_task("first")
# Output:
# Initializing msg: hello
# Processing: first

# Subsequent calls: only main_task executes
main_task("second")
# Output:
# Processing: second
```

## Notes
1. **Applicability**: This decorator is only suitable for simple initialization procedures. Its return value is ignored. If you need to obtain the return value, it indicates that this decorator should not be used for implicit initialization.
2. **Async and Threading**: Async and thread-safe versions are to be implemented in the future.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

---

If you have any questions or suggestions for improvement, feel free to open an Issue or submit a Pull Request.
