Merge pull request #37 from noboru-fukaishi/feature/python-3.13-support

feat: Upgrade to v1.0.0 with Python 3.10-3.13 support

Author: noboru-fukaishi

.github/workflows/test.yml

@@ -0,0 +1,21 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+      - name: Run tests
+        run: uv run --python ${{ matrix.python-version }} --extra dev pytest

.travis.yml

@@ -1,82 +1,107 @@
-# pptx-template [![Build Status](https://travis-ci.org/m3dev/pptx-template.svg?branch=master)](https://travis-ci.org/m3dev/pptx-template)
+# pptx-template
 
-## Overview
+[![Test](https://github.com/m3dev/pptx-template/actions/workflows/test.yml/badge.svg)](https://github.com/m3dev/pptx-template/actions/workflows/test.yml)
+[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
+
+## 概要
 
 pptx-template は pptx のテンプレートを元に、別途用意した JSON 中の文字列や CSV データを差し込んだ pptx を生成するツールです。
 
 定型レポートなどで大量のグラフ付きスライドを作成する際の作業を代行してくれます。
 
   - テンプレートには "{sales.0.june.us}" のような形で JSON内の値を指す id を記入できます
-  - python 3, pandas, pptx に依存しています
+  - Python 3.10+, pandas, python-pptx に依存しています
   - 扱う json や csv の 文字コードは utf-8 前提です
 
-### Text substitution
+### テキスト置換
 
 <img src="docs/01.png?raw=true" width="80%" />
 
-### CSV Import
+### CSVインポート
 
 <img src="docs/02.png?raw=true" width="80%" />
 
-## Getting started
+## はじめに
+
+```bash
+pip install pptx-template
+echo '{ "slides": [ { "greeting" : "Hello!!" } ] }' > model.json
 
-TBD
+# "{greeting}" を含むテンプレートファイル (test.pptx) を用意してください
 
+pptx_template --out out.pptx --template test.pptx --model model.json
 ```
-$ pip install pptx-template
-$ echo '{ "slides": [ { "greeting" : "Hello!!" } ] }' > model.json
 
-# prepare your template file (test.pptx) which contains "{greeting}" in somewhere
+## 開発
 
-$ pptx-template --out out.pptx --template test.pptx --model model.json
-```
+### 必要条件
+
+- Python 3.10, 3.11, 3.12, または 3.13
+- [uv](https://docs.astral.sh/uv/)（推奨）または pip
 
-## 開発工程
+### インストール
 
-### インストールの流れ
+```bash
+git clone https://github.com/m3dev/pptx-template.git
+cd pptx-template
 
-pyenvをインストールしておく
+# uvを使う場合（推奨）
+uv sync --extra dev
 
+# pipを使う場合
+pip install -e ".[dev]"
 ```
-git clone https://github.com/m3dev/pptx-template.git
 
-pyenv install 3.7.1 # Pythonをインストール
-pyenv shell 3.7.1 # シェルで使うPython
+### テスト実行
+
+```bash
+# uvを使う場合
+uv run --extra dev pytest
 
-venv .venv # 開発用の仮想環境を作成
-source .venv/bin/activate # 仮想環境を使用する
+# 特定のPythonバージョンで実行
+uv run --python 3.13 --extra dev pytest
 
-python setup.py develop        # パッケージを開発用にインストール＆依存パッケージをインストール
-pip install -r requirements.txt # 開発用のパッケージをインストール
+# pip インストール後
+pytest
 ```
 
-### REPLで実行 ※開発時はこの方法
+### コマンドラインで実行
 
-pythonのREPLを起動
+```bash
+# uvを使う場合
+uv run pptx_template \
+  --template test/data3/in.pptx \
+  --model test/data3/in.xlsx \
+  --out test/data3/out.pptx \
+  --debug
 
-```
-cd {プロジェクトフォルダ}
-pyenv shell 3.7.1
-python
+# pip インストール後
+pptx_template \
+  --template test/data3/in.pptx \
+  --model test/data3/in.xlsx \
+  --out test/data3/out.pptx \
+  --debug
 ```
 
-REPL内で実行
+### REPLで実行（開発時）
 
+```bash
+uv run python
 ```
+
+```python
 import sys
 from importlib import reload
 import pptx_template.cli as cli
 
-
-## 実行引数設定
-## sys.argv = ['{pyファイル名}', '--out', '{出力pptxファイルパス}', '--template', '{テンプレートpptxファイルパス}', '--model', '{設定xlsxファイルパス}', '--debug']
-## 以下の設定でテストファイルにて実行できます
+# 実行引数設定
 sys.argv = ['dummy.py', '--out', 'test/data3/out.pptx', '--template', 'test/data3/in.pptx', '--model', 'test/data3/in.xlsx', '--debug']
 
-## 実行
+# 実行
 cli.main()
 
-## 変更したソースをリロードして実行
+# ソースコード変更後、リロードして再実行
 reload(sys.modules.get('pptx_template.xlsx_model'))
 reload(sys.modules.get('pptx_template.text'))
 reload(sys.modules.get('pptx_template.table'))
@@ -86,48 +111,24 @@ reload(sys.modules.get('pptx_template.cli'))
 cli.main()
 ```
 
-### コマンドラインで実行 ※githubに上がっているものの動作確認をしたい場合はこの方法
-
-```
-## pptx_template --out {出力pptxファイルパス} --template {テンプレートpptxファイルパス} --model {設定xlsxファイルパス}  --debug
-pptx_template --out test/data3/out.pptx --template test/data3/in.pptx --model test/data3/in.xlsx  --debug
-```
-
-### テスト実行
-
-```
-pytest
-```
-
-### ロールアウト手順
+### リリース手順
 
 1. featureブランチを作成する
 2. 実装する
-3. 全pythonバージョンでtestが動くようにする
+3. 全Pythonバージョン（3.10, 3.11, 3.12, 3.13）でテストを実行する
 4. pushする
-5. github上でpull requestを作成する
+5. GitHub上でPull Requestを作成する
 6. コードレビューを依頼する
-7. QAを実施する（QAする人は、上記ローカル環境構築が必要）
-8. pll requestをマージする
+7. QAを実施する
+8. Pull Requestをマージする
 9. PyPIにアップロードする（PyPIのリポジトリ管理者のみ可）
 
-### PyPIへのアップロード手順
+### PyPIへのアップロード
 
-1. パッケージインストール
+```bash
+# ビルド
+uv build
 
-```
-pip install wheel
-pip install twine
-```
-
-2. コンパイル
-
-```
-python setup.py bdist_wheel
-```
-
-3. PyPIにアップロード
-
-```
-twine upload dist/*
+# PyPIにアップロード
+uv publish
 ```