py4project 0.1.0__tar.gz

py4project-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,89 @@
+name: publish
+
+# GitHub 上で Release を「公開（published）」したときに PyPI へアップロードする。
+# 手動実行（workflow_dispatch）を選ぶと TestPyPI へアップロードする。
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: 配布物をビルド
+    runs-on: ubuntu-latest
+    steps:
+      - name: リポジトリをチェックアウト
+        uses: actions/checkout@v4
+
+      - name: Python をセットアップ
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: ビルド用ツールをインストール
+        run: python -m pip install --upgrade pip build twine
+
+      - name: 配布物をビルド
+        run: python -m build
+
+      - name: メタデータを検査
+        run: python -m twine check dist/*
+
+      - name: 配布物を成果物として保存
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  publish-to-pypi:
+    name: PyPI へ公開
+    # Release を公開したときだけ実行する
+    if: github.event_name == 'release'
+    needs: build
+    runs-on: ubuntu-latest
+
+    # PyPI 側の Trusted Publisher 設定で指定する環境名。
+    # GitHub の Settings > Environments で "pypi" を作成しておく。
+    environment:
+      name: pypi
+      url: https://pypi.org/project/py4project/
+
+    permissions:
+      # Trusted Publishing（OIDC）に必要。API トークンは不要。
+      id-token: write
+
+    steps:
+      - name: 配布物をダウンロード
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: PyPI へアップロード
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  publish-to-testpypi:
+    name: TestPyPI へ公開
+    # 手動実行したときだけ TestPyPI に上げる（本番前の確認用）
+    if: github.event_name == 'workflow_dispatch'
+    needs: build
+    runs-on: ubuntu-latest
+
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/project/py4project/
+
+    permissions:
+      id-token: write
+
+    steps:
+      - name: 配布物をダウンロード
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: TestPyPI へアップロード
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/

py4project-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,65 @@
+name: test
+
+# push と pull request のたびにテストを実行する。
+# 手動実行（workflow_dispatch）も可能。
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      # 1つのバージョンが失敗しても他のバージョンのテストは最後まで走らせる
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+      - name: リポジトリをチェックアウト
+        uses: actions/checkout@v4
+
+      - name: Python ${{ matrix.python-version }} をセットアップ
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: 依存パッケージとパッケージ本体をインストール
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -e .
+          python -m pip install pytest
+
+      - name: インストールされたバージョンを記録
+        run: python -m pip list
+
+      - name: pytest を実行
+        # matplotlib が画面のない環境で動くように Agg バックエンドを使う
+        env:
+          MPLBACKEND: Agg
+        run: python -m pytest tests/ -v
+
+  build:
+    # 配布物が正しくビルドでき、PyPI のメタデータ検査を通ることを確認する
+    runs-on: ubuntu-latest
+    steps:
+      - name: リポジトリをチェックアウト
+        uses: actions/checkout@v4
+
+      - name: Python をセットアップ
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: ビルド用ツールをインストール
+        run: python -m pip install --upgrade pip build twine
+
+      - name: 配布物をビルド
+        run: python -m build
+
+      - name: メタデータを検査
+        run: python -m twine check dist/*

py4project-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+__pycache__/
+*.pyc
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+.venv/
+.DS_Store

py4project-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tetsugen HARUYAMA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

py4project-0.1.0/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.5
+Name: py4project
+Version: 0.1.0
+Summary: 授業用回帰分析・散布図・バープロット・ボックスプロットのユーティリティ
+Project-URL: Homepage, https://github.com/Py4Project/py4project
+Project-URL: Repository, https://github.com/Py4Project/py4project
+Project-URL: Issues, https://github.com/Py4Project/py4project/issues
+Author-email: Tetsugen HARUYAMA <tetsu.yes@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: matplotlib,regional-economics,shift-share,statistics
+Classifier: Intended Audience :: Education
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Japanese
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: japanize-matplotlib-jlite
+Requires-Dist: matplotlib>=3.9
+Requires-Dist: numpy
+Requires-Dist: pandas
+Requires-Dist: scipy
+Description-Content-Type: text/markdown
+
+# py4project
+
+授業用分析・可視化ユーティリティです。pandas DataFrame から回帰分析・散布図・横バープロット・ボックスプロットを簡単に作成できます。
+
+## インストール
+
+```bash
+pip install py4project
+```
+
+## 提供している関数
+
+- `regression(x, y, data)` — 単回帰分析（R²、95%信頼区間、回帰式を表示）
+- `regression_plot(x, y, data, ...)` — 散布図＋回帰直線
+- `scatter_plot(x, y, data, ...)` — 散布図＋トレンド線（対数軸オプションあり）
+- `bar_plot(x, data, ...)` — 横バープロット（複数系列・シフトシェア分解の配色に対応）
+- `box_plot(x, data, ...)` — ボックスプロット（外れ値の自動ラベル表示、対数化オプションあり）
+
+## 使用例
+
+```python
+import pandas as pd
+from py4project import regression, bar_plot
+
+df = pd.DataFrame({
+    "産業": ["製造業", "卸売業", "小売業"],
+    "全国成長効果": [120, 80, 60],
+    "産業構成効果": [-20, 10, 5],
+    "地域固有効果": [30, -5, 15],
+})
+
+bar_plot(["全国成長効果", "産業構成効果", "地域固有効果"], df, title="シフトシェア分解")
+```
+
+## 依存パッケージ
+
+`numpy`, `pandas`, `scipy`, `matplotlib`, `japanize_matplotlib_jlite`（日本語フォントを自動設定します）
+
+## ライセンス
+
+MIT License

py4project-0.1.0/README.md

@@ -0,0 +1,41 @@
+# py4project
+
+授業用分析・可視化ユーティリティです。pandas DataFrame から回帰分析・散布図・横バープロット・ボックスプロットを簡単に作成できます。
+
+## インストール
+
+```bash
+pip install py4project
+```
+
+## 提供している関数
+
+- `regression(x, y, data)` — 単回帰分析（R²、95%信頼区間、回帰式を表示）
+- `regression_plot(x, y, data, ...)` — 散布図＋回帰直線
+- `scatter_plot(x, y, data, ...)` — 散布図＋トレンド線（対数軸オプションあり）
+- `bar_plot(x, data, ...)` — 横バープロット（複数系列・シフトシェア分解の配色に対応）
+- `box_plot(x, data, ...)` — ボックスプロット（外れ値の自動ラベル表示、対数化オプションあり）
+
+## 使用例
+
+```python
+import pandas as pd
+from py4project import regression, bar_plot
+
+df = pd.DataFrame({
+    "産業": ["製造業", "卸売業", "小売業"],
+    "全国成長効果": [120, 80, 60],
+    "産業構成効果": [-20, 10, 5],
+    "地域固有効果": [30, -5, 15],
+})
+
+bar_plot(["全国成長効果", "産業構成効果", "地域固有効果"], df, title="シフトシェア分解")
+```
+
+## 依存パッケージ
+
+`numpy`, `pandas`, `scipy`, `matplotlib`, `japanize_matplotlib_jlite`（日本語フォントを自動設定します）
+
+## ライセンス
+
+MIT License

py4project-0.1.0/examples/data_project.csv

@@ -0,0 +1,18 @@
+地域コード,地域,産業コード,産業,w2016,w2021,e2016,e2021
+0,全国,AB,農林漁業,363024,453703,32676,42458
+0,全国,C,鉱業，採石業，砂利採取業,19467,19697,1851,1865
+0,全国,D,建設業,3690740,3737415,492734,485135
+0,全国,E,製造業,8864253,8803643,454800,412617
+0,全国,F,電気・ガス・熱供給・水道業,187818,202149,4654,9139
+0,全国,G,情報通信業,1642042,1986839,63574,76559
+0,全国,H,運輸業，郵便業,3197231,3264734,130459,128224
+0,全国,I,卸売業，小売業,11843869,11611924,1355060,1228920
+0,全国,J,金融業，保険業,1530002,1494436,84041,83852
+0,全国,K,不動産業，物品賃貸業,1462395,1618138,353155,374456
+0,全国,L,学術研究，専門・技術サービス業,1842795,2118920,223439,252340
+0,全国,M,宿泊業，飲食サービス業,5362088,4678739,696396,599058
+0,全国,N,生活関連サービス業，娯楽業,2420557,2176139,470713,434209
+0,全国,O,教育，学習支援業,1827596,1950734,167662,163357
+0,全国,P,医療，福祉,7374844,8162398,429173,462531
+0,全国,Q,複合サービス事業,484260,435970,33780,32131
+0,全国,R,サービス業（他に分類されないもの）,4759845,5234337,346616,369212