pypiles 0.3.0__tar.gz

pypiles-0.3.0/.github/workflows/publish.yml

@@ -0,0 +1,41 @@
+name: Publish Python Package
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+
+    steps:
+    - name: Check out the repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.10'
+
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+
+    - name: Build the package
+      run: |
+        python -m build
+
+    - name: Publish to PyPI (Using Twine)
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        python -m pip install --upgrade twine
+        twine upload --verbose dist/*

pypiles-0.3.0/.gitignore

@@ -0,0 +1,6 @@
+# .gitignore
+pypile/_version.py
+pypile.egg-info/
+__pycache__/
+dist/
+build/

pypiles-0.3.0/.idea/.gitignore

@@ -0,0 +1,5 @@
+# 默认忽略的文件
+/shelf/
+/workspace.xml
+# 基于编辑器的 HTTP 客户端请求
+/httpRequests/

pypiles-0.3.0/.idea/PyPile.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="jdk" jdkName="Python 3.14" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

pypiles-0.3.0/.idea/inspectionProfiles/Project_Default.xml

@@ -0,0 +1,16 @@
+<component name="InspectionProjectProfileManager">
+  <profile version="1.0">
+    <option name="myName" value="Project Default" />
+    <inspection_tool class="LossyEncoding" enabled="false" level="WARNING" enabled_by_default="false" />
+    <inspection_tool class="PyPep8NamingInspection" enabled="true" level="WEAK WARNING" enabled_by_default="true">
+      <option name="ignoredErrors">
+        <list>
+          <option value="N802" />
+          <option value="N806" />
+          <option value="N803" />
+        </list>
+      </option>
+    </inspection_tool>
+    <inspection_tool class="PyTypeCheckerInspection" enabled="false" level="WARNING" enabled_by_default="false" />
+  </profile>
+</component>

pypiles-0.3.0/.idea/inspectionProfiles/profiles_settings.xml

@@ -0,0 +1,6 @@
+<component name="InspectionProjectProfileManager">
+  <settings>
+    <option name="USE_PROJECT_PROFILE" value="false" />
+    <version value="1.0" />
+  </settings>
+</component>

pypiles-0.3.0/.idea/misc.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Black">
+    <option name="sdkName" value="Python 3.12" />
+  </component>
+  <component name="ProjectRootManager" version="2" project-jdk-name="Python 3.14" project-jdk-type="Python SDK" />
+</project>

pypiles-0.3.0/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/PyPile.iml" filepath="$PROJECT_DIR$/.idea/PyPile.iml" />
+    </modules>
+  </component>
+</project>

pypiles-0.3.0/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>

pypiles-0.3.0/Benchmark/BH25/BH25.py

@@ -0,0 +1,68 @@
+from pypile import EquipmentConfig
+from pypile.core import SoilLayer, Borehole
+
+rig_safety = EquipmentConfig(hammer_energy_ratio=0.60)
+# 创建钻孔 BH25，地下水位 6.35m
+BH25 = Borehole(water_table_depth=6.35, equipment=rig_safety)
+
+# 0.00 - 1.50m: DARK GRAY Lean CLAY with shell (CL) - N=3 (1+2)
+BH25.add_layer(SoilLayer(0.0, 1.5, 'clay', n_field=3, description="Lean CLAY with shell (CL)"))
+
+# 1.50 - 3.00m: DARK GRAY Lean CLAY (CL) - N=2 (1+1)
+BH25.add_layer(SoilLayer(1.5, 3.0, 'clay', n_field=2, description="Lean CLAY (CL)"))
+
+# 3.00 - 4.50m: DARK GRAY Lean CLAY (CL) - N=2 (1+1)
+BH25.add_layer(SoilLayer(3.0, 4.5, 'clay', n_field=2, description="Lean CLAY (CL)"))
+
+# 4.50 - 6.00m: DARK GRAY Lean CLAY (CL) - N=3 (2+1)
+BH25.add_layer(SoilLayer(4.5, 6.0, 'clay', n_field=3, description="Lean CLAY (CL)"))
+
+# 6.00 - 7.50m: DARK GRAY Lean CLAY (CL) - N=4 (2+2)
+BH25.add_layer(SoilLayer(6.0, 7.5, 'clay', n_field=4, description="Lean CLAY (CL)"))
+
+# 7.50 - 9.00m: DARK GRAY Lean CLAY (CL) - N=3 (2+1)
+BH25.add_layer(SoilLayer(7.5, 9.0, 'clay', n_field=3, description="Lean CLAY (CL)"))
+
+# 9.00 - 10.50m: DARK GRAY Lean CLAY (CL) - N=4 (2+2)
+BH25.add_layer(SoilLayer(9.0, 10.5, 'clay', n_field=4, description="Lean CLAY (CL)"))
+
+# 10.50 - 12.00m: DARK GRAY Sandy Lean CLAY with shell (CL) - N=12 (5+7)
+BH25.add_layer(SoilLayer(10.5, 12.0, 'clay', n_field=12, description="Sandy Lean CLAY with shell (CL)"))
+
+# 12.00 - 13.50m: BROWNISH GRAY Silty SAND (SM) - N=43 (20+23)
+BH25.add_layer(SoilLayer(12.0, 13.5, 'sand', n_field=43, description="Silty SAND (SM)"))
+
+# --- 以下为 N>50 的硬土层，作为 IGM 处理 ---
+
+# 13.50 - 15.00m: BROWNISH GRAY Silty SAND (SM) - N=51 (24+27)
+BH25.add_layer(SoilLayer(13.5, 15.0, 'igm_sand', n_field=51, description="Silty SAND (SM), Very Dense"))
+
+# 15.00 - 16.50m: BROWN Clayey SAND with gravel (SC) - N=57 (27+30)
+BH25.add_layer(SoilLayer(15.0, 16.5, 'igm_sand', n_field=57, description="Clayey SAND with gravel (SC)"))
+
+# 16.50 - 18.00m: BROWN Clayey SAND with gravel (SC) - N=61 (29+32)
+BH25.add_layer(SoilLayer(16.5, 18.0, 'igm_sand', n_field=61, description="Clayey SAND with gravel (SC)"))
+
+# 18.00 - 19.50m: DARK BROWN Silty SAND with gravel (SM) - N=64 (31+33)
+BH25.add_layer(SoilLayer(18.0, 19.5, 'igm_sand', n_field=64, description="Silty SAND with gravel (SM)"))
+
+# 19.50 - 21.00m: DARK BROWN Clayey SAND with gravel (SC) - N=67 (34+33)
+BH25.add_layer(SoilLayer(19.5, 21.0, 'igm_sand', n_field=67, description="Clayey SAND with gravel (SC)"))
+
+# 21.00 - 22.50m: DARK BROWN Clayey SAND with gravel (SC) - N=78 (39+39) -> 规范建议截断至60~80之间，保守取78
+BH25.add_layer(SoilLayer(21.0, 22.5, 'igm_sand', n_field=78, description="Clayey SAND with gravel (SC)"))
+
+# 22.50 - 24.00m: DARK BROWN Silty SAND with gravel (SM) - 击数 89/20cm，取等效 N=60
+BH25.add_layer(SoilLayer(22.5, 24.0, 'igm_sand', n_field=60, description="Silty SAND with gravel (SM)"))
+
+# 24.00 - 25.50m: DARK BROWN Silty SAND (SM) - 击数 50/12cm，取等效 N=60
+BH25.add_layer(SoilLayer(24.0, 25.5, 'igm_sand', n_field=60, description="Silty SAND (SM)"))
+
+# 25.50 - 27.00m: DARK BROWN Clayey SAND with gravel (SC) - 击数 95/20cm，取等效 N=60
+BH25.add_layer(SoilLayer(25.5, 27.0, 'igm_sand', n_field=60, description="Clayey SAND with gravel (SC)"))
+
+# 27.00 - 28.50m: DARK BROWN Silty SAND (SM) - 击数 50/10cm，取等效 N=60
+BH25.add_layer(SoilLayer(27.0, 28.5, 'igm_sand', n_field=60, description="Silty SAND (SM)"))
+
+# 28.50 - 29.78m: DARK BROWN Clayey SAND with gravel (SC) - 击数 50/8cm，孔底深度29.78m，取等效 N=60
+BH25.add_layer(SoilLayer(28.5, 29.78, 'igm_sand', n_field=60, description="Clayey SAND with gravel (SC)"))

pypiles-0.3.0/Benchmark/BH25/test.py

@@ -0,0 +1,18 @@
+from pypile.configs import EquipmentConfig, AnalysisConfig
+from pypile.core import SoilLayer, Borehole, Pile
+from pypile.solver import LRFDSolver
+
+from BH25 import BH25
+
+
+def run_analysis():
+    # 4. 运行
+    pile = Pile(diameter=2.5, length=45)
+    solver = LRFDSolver(pile, BH25, config=AnalysisConfig())
+    result = solver.solve()
+
+    print(f"Capacity: {result['total_factored']:.2f} kN")
+
+
+if __name__ == "__main__":
+    run_analysis()

pypiles-0.3.0/Benchmark/BH29/CBH26.py

@@ -0,0 +1,34 @@
+from pypile.configs import AnalysisConfig
+from pypile.core import SoilLayer, Borehole, Pile
+import pandas as pd
+
+def run_analysis():
+    # 1. 规范版本
+    rules = AnalysisConfig(ver=2024)
+    # 2. 桩基配置
+    pile = Pile(diameter=2.5, length=30.0, casing_length=15.0, casing_rf=0.6)
+    # 3. 钻孔
+    bh = Borehole(analys_config=rules, water_table_depth=0.0, hammer_energy_ratio=0.60, pile=pile)
+    bh.add_layer(SoilLayer(1, 0, 1, 'sand', n_field=2, unit_weight=18))
+    bh.add_layer(SoilLayer(2, 1, 2, 'sand', n_field=2, unit_weight=18))
+    bh.add_layer(SoilLayer(3, 2, 3, 'clay', n_field=3, unit_weight=16, su=18))
+    bh.add_layer(SoilLayer(4, 3, 4, 'sand', n_field=3, unit_weight=18))
+    bh.add_layer(SoilLayer(5, 4, 5, 'sand', n_field=3, unit_weight=18))
+    bh.add_layer(SoilLayer(6, 5, 6, 'clay', n_field=6, unit_weight=16, su=36))
+    for tep in range(30):
+        bh.add_layer(SoilLayer(7 + tep, 6 + tep, 7 + tep, 'sand', n_field=50, unit_weight=19))
+
+    df1 = bh.report_layers()
+    df2 = bh.report_compress_result()
+
+    file_path = 'ResBH29-D2.5.xlsx'
+    with pd.ExcelWriter(file_path, engine='xlsxwriter') as writer:
+        # 将 df1 写入名为 'Layers' 的 sheet 中
+        df1.to_excel(writer, sheet_name='Layers', index=False)
+        # 将 df2 写入名为 'Compress_Result' 的 sheet 中
+        df2.to_excel(writer, sheet_name='Compress_Result', index=False)
+    print(f"数据已成功保存至 {file_path}")
+
+
+if __name__ == "__main__":
+    run_analysis()

pypiles-0.3.0/Benchmark/BH29/CBH29.py

@@ -0,0 +1,34 @@
+from pypile.configs import AnalysisConfig
+from pypile.core import SoilLayer, Borehole, Pile
+import pandas as pd
+
+def run_analysis():
+    # 1. 规范版本
+    rules = AnalysisConfig(ver=2024)
+    # 2. 桩基配置
+    pile = Pile(diameter=2.5, length=30.0, casing_length=15.0, casing_rf=0.6)
+    # 3. 钻孔
+    bh = Borehole(analys_config=rules, water_table_depth=0.0, hammer_energy_ratio=0.60, pile=pile)
+    bh.add_layer(SoilLayer(1, 0, 1, 'sand', n_field=2, unit_weight=18))
+    bh.add_layer(SoilLayer(2, 1, 2, 'sand', n_field=2, unit_weight=18))
+    bh.add_layer(SoilLayer(3, 2, 3, 'clay', n_field=3, unit_weight=16, su=18))
+    bh.add_layer(SoilLayer(4, 3, 4, 'sand', n_field=3, unit_weight=18))
+    bh.add_layer(SoilLayer(5, 4, 5, 'sand', n_field=3, unit_weight=18))
+    bh.add_layer(SoilLayer(6, 5, 6, 'clay', n_field=6, unit_weight=16, su=36))
+    for tep in range(30):
+        bh.add_layer(SoilLayer(7 + tep, 6 + tep, 7 + tep, 'sand', n_field=50, unit_weight=19))
+
+    df1 = bh.report_layers()
+    df2 = bh.report_compress_result()
+
+    file_path = 'ResBH29-D2.5.xlsx'
+    with pd.ExcelWriter(file_path, engine='xlsxwriter') as writer:
+        # 将 df1 写入名为 'Layers' 的 sheet 中
+        df1.to_excel(writer, sheet_name='Layers', index=False)
+        # 将 df2 写入名为 'Compress_Result' 的 sheet 中
+        df2.to_excel(writer, sheet_name='Compress_Result', index=False)
+    print(f"数据已成功保存至 {file_path}")
+
+
+if __name__ == "__main__":
+    run_analysis()

pypiles-0.3.0/PKG-INFO

@@ -0,0 +1,52 @@
+Metadata-Version: 2.4
+Name: pypiles
+Version: 0.3.0
+Summary: AASHTO LRFD Drilled Shaft Analysis Tool
+Author-email: Bill HU <billhu0228@icloud.com>
+Project-URL: Homepage, https://github.com/billhu0228/PyPile
+Project-URL: Bug Tracker, https://github.com/billhu0228/PyPile/issues
+Keywords: geotechnical,piles,drilled shafts,AASHTO,LRFD
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: Mathematics
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# PyPile: AASHTO LRFD Drilled Shaft Analysis
+
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Standard](https://img.shields.io/badge/AASHTO-LRFD%209th-orange)
+
+**PyPile** 是一个模块化、面向对象的 Python 库，专门用于按照 **AASHTO LRFD Bridge Design Specifications (9th Edition)** 和 **FHWA-NHI-10-016** 标准计算钻孔灌注桩（Drilled Shafts / Bored Piles）的轴向承载力。
+
+该项目旨在为岩土工程师提供一个透明、可扩展且自动化的计算工具，替代繁琐且容易出错的 Excel 表格。
+
+## 🚀 主要特性 (Key Features)
+
+* **规范合规 (Code Compliance):** 严格遵循 AASHTO LRFD 规范，内置抗力系数 ($\varphi$) 和极限阻力限制 (Limits)。
+* **多地层处理 (Multi-Layer Stratigraphy):** 支持复杂的“上软下硬”地层、夹层以及地下水位影响。
+* **自动化参数关联 (Auto-Correlations):**
+    * 自动将野外 SPT $N$ 值修正为 $N_{60}$。
+    * 基于 $N$ 值自动估算土体重度 ($\gamma$)、内摩擦角 ($\phi'$) 和不排水抗剪强度 ($S_u$)。
+* **高级算法 (Advanced Solvers):**
+    * **黏土 (Clay):** $\alpha$-Method (Total Stress).
+    * **砂土 (Sand):** $\beta$-Method (Effective Stress).
+    * **中间岩土材料 (IGM):** 针对 $N > 50$ 的极密实土层或软岩的特殊处理逻辑。
+* **模块化架构:** 易于扩展新的计算方法或集成到更大的 Web/Desktop 应用中。
+
+## 📦 安装 (Installation)
+
+目前 PyPile 处于开发阶段，建议通过克隆仓库进行本地安装：
+
+```bash
+git clone [https://github.com/yourusername/pypile.git](https://github.com/yourusername/pypile.git)
+cd pypile
+
+# (可选) 创建虚拟环境
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+
+# 安装依赖 (如果有)
+pip install -r requirements.txt

pypiles-0.3.0/README.md

@@ -0,0 +1,37 @@
+# PyPile: AASHTO LRFD Drilled Shaft Analysis
+
+![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)
+![License](https://img.shields.io/badge/license-MIT-green)
+![Standard](https://img.shields.io/badge/AASHTO-LRFD%209th-orange)
+
+**PyPile** 是一个模块化、面向对象的 Python 库，专门用于按照 **AASHTO LRFD Bridge Design Specifications (9th Edition)** 和 **FHWA-NHI-10-016** 标准计算钻孔灌注桩（Drilled Shafts / Bored Piles）的轴向承载力。
+
+该项目旨在为岩土工程师提供一个透明、可扩展且自动化的计算工具，替代繁琐且容易出错的 Excel 表格。
+
+## 🚀 主要特性 (Key Features)
+
+* **规范合规 (Code Compliance):** 严格遵循 AASHTO LRFD 规范，内置抗力系数 ($\varphi$) 和极限阻力限制 (Limits)。
+* **多地层处理 (Multi-Layer Stratigraphy):** 支持复杂的“上软下硬”地层、夹层以及地下水位影响。
+* **自动化参数关联 (Auto-Correlations):**
+    * 自动将野外 SPT $N$ 值修正为 $N_{60}$。
+    * 基于 $N$ 值自动估算土体重度 ($\gamma$)、内摩擦角 ($\phi'$) 和不排水抗剪强度 ($S_u$)。
+* **高级算法 (Advanced Solvers):**
+    * **黏土 (Clay):** $\alpha$-Method (Total Stress).
+    * **砂土 (Sand):** $\beta$-Method (Effective Stress).
+    * **中间岩土材料 (IGM):** 针对 $N > 50$ 的极密实土层或软岩的特殊处理逻辑。
+* **模块化架构:** 易于扩展新的计算方法或集成到更大的 Web/Desktop 应用中。
+
+## 📦 安装 (Installation)
+
+目前 PyPile 处于开发阶段，建议通过克隆仓库进行本地安装：
+
+```bash
+git clone [https://github.com/yourusername/pypile.git](https://github.com/yourusername/pypile.git)
+cd pypile
+
+# (可选) 创建虚拟环境
+python -m venv venv
+source venv/bin/activate  # Windows: venv\Scripts\activate
+
+# 安装依赖 (如果有)
+pip install -r requirements.txt

pypiles-0.3.0/constants.py

@@ -0,0 +1,18 @@
+# pypile/constants.py
+
+G = 9.81  # 重力加速度
+WATER_UNIT_WEIGHT = 9.81  # kN/m3
+PA = 100.0  # 大气压 kPa
+
+
+# AASHTO LRFD Limits
+# Ref: AASHTO LRFD 9th Ed, Art. 10.8.3.5.2b (Eq. 10.8.3.5.2b-1)
+MAX_SIDE_RESISTANCE = 192.0  # kPa (limit for Beta method)
+MAX_TIP_RESISTANCE_SAND = 3000.0  # kPa (limit for sand without load test)
+
+# Resistance Factors (Phi) - Table 10.5.5.2.4-1
+PHI_SIDE_CLAY = 0.45
+PHI_SIDE_SAND = 0.55
+PHI_TIP_CLAY = 0.40
+PHI_TIP_SAND = 0.50
+PHI_IGM = 0.60

pypiles-0.3.0/main.py

@@ -0,0 +1,31 @@
+from pypile.configs import EquipmentConfig, AnalysisConfig
+from pypile.core import SoilLayer, Borehole, Pile
+from pypile.solver import LRFDSolver
+
+
+def run_analysis():
+    # 1. 定义设备 (Define Equipment)
+    # 这台钻机是 Automatic Hammer (ER=90%)
+    rig_alpha = EquipmentConfig(hammer_energy_ratio=0.90)
+
+    # 2. 定义钻孔 (Define Borehole with that Equipment)
+    # 当 layer 被 add 进去时，N60 就已经被算出并固定了
+    bh = Borehole(water_table_depth=0.0, equipment=rig_alpha)
+
+    bh.add_layer(SoilLayer(0, 5, 'sand', n_field=10))
+    # ^ 此时 layer 内部: n60 = 10 * (0.9/0.6) = 15.0
+
+    # 3. 定义计算规则 (Define Analysis Rules)
+    # 使用标准 AASHTO 规范
+    aashto_rules = AnalysisConfig()
+
+    # 4. 运行
+    pile = Pile(diameter=1.0, length=10.0)
+    solver = LRFDSolver(pile, bh, config=aashto_rules)
+    result = solver.solve()
+
+    print(f"Capacity: {result['total_factored']:.2f} kN")
+
+
+if __name__ == "__main__":
+    run_analysis()

pypiles-0.3.0/pypile/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bill HU
+
+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.

pypiles-0.3.0/pypile/__init__.py

@@ -0,0 +1,22 @@
+from .core import SoilLayer, Borehole, Pile
+from .configs import AnalysisConfig
+from .solver import LRFDSolver
+
+# --- 智能版本号处理 ---
+try:
+    # 尝试读取 setuptools_scm 自动生成的文件
+    from ._version import version as __version__
+except ImportError:
+    # 如果文件不存在（比如你刚 clone 下来，还没 pip install），
+    # 或者你在纯源码模式下开发，
+    # 我们给它一个默认的开发占位符，防止代码报错。
+    __version__ = "0.0.0.dev0+unknown"
+
+__all__ = [
+    "SoilLayer",
+    "Borehole",
+    "Pile",
+    "AnalysisConfig",
+    "LRFDSolver",
+    "__version__"
+]

pypiles-0.3.0/pypile/_version.py

@@ -0,0 +1,24 @@
+# file generated by vcs-versioning
+# don't change, don't track in version control
+from __future__ import annotations
+
+__all__ = [
+    "__version__",
+    "__version_tuple__",
+    "version",
+    "version_tuple",
+    "__commit_id__",
+    "commit_id",
+]
+
+version: str
+__version__: str
+__version_tuple__: tuple[int | str, ...]
+version_tuple: tuple[int | str, ...]
+commit_id: str | None
+__commit_id__: str | None
+
+__version__ = version = '0.3.0'
+__version_tuple__ = version_tuple = (0, 3, 0)
+
+__commit_id__ = commit_id = 'g102510cf9'