Metadata-Version: 2.1
Name: Permanent_variable_tool
Version: 1.0.4
Summary: Used to store variables permanently, which can be read directly after importing into the library.
Author: Unwilling to disclose
Author-email: Unwilling to disclose <q1111911111q@outlook.com>
License: MIT
Keywords: Permanent variable tool,pvt
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=6.0; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: flake8; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest>=6.0; extra == "test"
Requires-Dist: pytest-cov; extra == "test"

# Permanent Variable Tool
### 中文文档请往下查看
---
## `pvt.new(variable:str, value:Any=None) -> None`
Functionality

Creates/updates variable files in `./data/` directory 
### Usage Example 
```python
pvt.new("user_profile", {"name": "John", "age": 28})  # Serializes to string 
pvt.new("system_flag")   # Creates empty file 
```
---
## `pvt.read(variable:str) -> str`
### Critical Notes
- Always wrap in try-except:
```python 
try:
    config = pvt.read("app_config")
except FileNotFoundError:
    initialize_defaults()
```
---
## `pvt.delete(variable:str) -> None`
### Security Notice 
- Deletion is permanent. Recommended safety check:
```python 
if os.path.exists(pvt.data_dir + "/" + variable + ".var"):
    pvt.delete("temp_data") 
```
---
## `pvt.find (variable name: str) -> Bool`
### Use examples
```python
Bool = pvt.find(str)
print(Bool) # True / False
```
---
## `pvt.list() -> dict`
Functionality  
Reads all `.var` files from `C:\pvt_data` and converts contents to Python values  
Value Mapping Rules  
- `$value.false` → `False`  
- `$value.true` → `True`  
- `$value.ellipsis` → `...`  
- Other content remains as string  
### Usage Example  
```python
variables = pvt.list()  # Returns {'debug': True, 'max_retries': '5'}
```
---
---

# 永久变量工具 (Permanent Variable Tool)
### Please check the English documents up.
---
## `pvt.new(变量名:str, 值:Any=None) -> None`
功能 
在`./data/`目录中创建/更新变量文件
### 使用示例 
```python
pvt.new("user_profile", {"name": "张三", "age": 28})  # 序列化为字符串 
pvt.new("system_flag")   # 创建空文件
```
--- 
## `pvt.read(变量名:str) -> str`
### 重要说明 
- 必须使用try-except包裹:
```python 
try:
    config = pvt.read("app_config")
except FileNotFoundError:
    initialize_defaults()
```
---
## `pvt.delete(变量名:str) -> None`
### 安全提示 
- 删除操作不可逆。建议进行安全检查:
```python 
if os.path.exists(pvt.data_dir + "/" + variable + ".var"):
    pvt.delete("temp_data")
```
---
## `pvt.find(变量名:str) -> Bool`
### 使用示例 
```python 
Bool = pvt.find(str)
print(Bool) # True / False
```
---
## `pvt.list() -> dict`  
功能  
从`C:\pvt_data`读取所有`.var`文件并转换内容为Python值  
### 值转换规则  
- `$value.false` → 布尔值`False`  
- `$value.true` → 布尔值`True`  
- `$value.ellipsis` → 省略号对象`...`  
- 其他内容保留原始字符串格式  
### 使用示例  
```python
variables = pvt.list()  # 返回如 {'debug': True, 'max_retries': '5'}
```
