Metadata-Version: 2.4
Name: ex2val
Version: 0.1.0
Summary: Convert Excel formulas to values
Author-email: Zhang3 <675942084@qq.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/sidleo/ex2val
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
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: openpyxl>=3.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: twine; extra == "dev"
Dynamic: license-file

# ex2val

将 Excel 公式转换为值。

## 安装

```bash
pip install ex2val
```

## 使用方法

### 命令行

```bash
# 基本用法 - 输出文件自动添加 _vyyyyMMdd 后缀
ex2val 输入.xlsx
# 输出: 输入_v20260424.xlsx

# 指定输出文件
ex2val 输入.xlsx 输出.xlsx

# 使用占位符动态命名
ex2val "报表_{yyyy}{mm}{dd}.xlsx"
# 输出: 报表_20260424.xlsx（解析占位符）

ex2val "报表_{yyyymmdd -1}.xlsx"
# 输出: 报表_20260423.xlsx（昨天）

# 也支持 python -m 方式调用
python -m ex2val 输入.xlsx
```

### 占位符

| 占位符 | 说明 | 示例 |
|--------|------|------|
| `{yyyy}` | 当前年份（小写） | 2026 |
| `{mm}` | 当前月份（小写） | 04 |
| `{dd}` | 当前日期（小写） | 24 |
| `{HH}` | 当前小时（大写） | 15 |
| `{MM}` | 当前分钟（大写） | 30 |
| `{SS}` | 当前秒数（大写） | 45 |
| `{tmp}` | 空字符串 | |
| `{v}` | vyyyyMMdd 格式 | v20260424 |
| `{yyyymmdd}` | 今天 yyyymmdd | 20260424 |
| `{yyyymmdd -1}` | 昨天 | 20260423 |
| `{yyyymmdd 1}` | 明天 | 20260425 |

### Python API

```python
from ex2val import convert, Placeholder

# 转换文件
convert("输入.xlsx", "输出.xlsx")

# 使用占位符
Placeholder.yyyy()         # "2026"
Placeholder.yyyymmdd()     # "20260424"
Placeholder.yyyymmdd(-1)   # "20260423"（昨天）
```

### 右键菜单 / 快速操作

**命令行方式（推荐）：**

```bash
# 添加右键菜单
ex2val --install-menu

# 卸载右键菜单
ex2val --uninstall-menu
```

**Windows：** 安装后右键点击任意文件即可选择"转换为值(ex2val)"。

**macOS：** 安装后在 Finder 中右键点击文件，选择"快速操作" → "转换为值(ex2val)"。

> 注意：macOS 新添加的服务需要在「系统设置」→「键盘」→「键盘快捷键」→「服务」中手动启用。

## 功能特性

- 将 Excel 公式转换为静态值
- 支持日期占位符动态命名
- 删除以 `-` 开头的 sheet
- Windows 右键菜单集成
- macOS 快速操作集成

## 许可证

MIT
