seerapi-models 1.0.0__tar.gz

seerapi_models-1.0.0/LICENSE

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

seerapi_models-1.0.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.3
+Name: seerapi-models
+Version: 1.0.0
+Summary: SeerAPI 数据模型/ORM 定义
+Keywords: seerapi,models,orm
+Author: Nattsu39
+Author-email: Nattsu39 <Nattsu39@outlook.com>
+License: MIT License
+         
+         Copyright (c) 2025 SeerAPI
+         
+         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.
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: sqlmodel>=0.0.27
+Requires-Python: >=3.10
+Project-URL: Homepage, https://github.com/SeerAPI/seerapi-models
+Project-URL: Repository, https://github.com/SeerAPI/seerapi-models
+Description-Content-Type: text/markdown
+
+# seerapi-models
+
+SeerAPI 数据模型/ORM 定义，用于前后端开发。
+
+## 安装
+使用 uv：
+
+```bash
+uv add seerapi-models
+```
+或者使用 pip：
+
+```bash
+pip install seerapi-models
+```
+也可以使用其他包管理器，如 poetry 等。
+## 开发环境部署
+
+### 使用 uv 部署
+
+1. **安装 uv**
+   ```bash
+   # macOS/Linux
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   
+   # Windows
+   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+
+2. **克隆项目**
+   ```bash
+   git clone https://github.com/SeerAPI/seerapi-models.git
+   cd seerapi-models
+   ```
+
+3. **安装依赖**
+   ```bash
+   # 同步项目依赖
+   uv sync
+   ```
+
+4. **运行开发环境**
+   ```bash
+   # 在项目虚拟环境中运行 Python
+   uv run python
+   
+   # 运行测试
+   uv run pytest
+   
+   # 运行代码检查
+   uv run ruff check
+   uv run ruff format
+   ```
+
+### 开发容器 (推荐)
+
+项目提供了 Dev Container 配置，支持一键部署开发环境：
+
+1. 使用 VS Code 打开项目
+2. 安装 Dev Containers 扩展
+3. 按 `Ctrl+Shift+P` 打开命令面板
+4. 选择 "Dev Containers: Reopen in Container"
+
+容器会自动安装：
+- Python 3.10
+- uv 包管理器
+- Ruff 代码检查工具
+- 相关 VS Code 扩展
+
+### 环境要求
+
+- Python >= 3.10
+- uv >= 0.9.0 (推荐使用最新版)
+
+## 许可证
+
+本项目基于 [MIT License](LICENSE) 开源。

seerapi_models-1.0.0/README.md

@@ -0,0 +1,77 @@
+# seerapi-models
+
+SeerAPI 数据模型/ORM 定义，用于前后端开发。
+
+## 安装
+使用 uv：
+
+```bash
+uv add seerapi-models
+```
+或者使用 pip：
+
+```bash
+pip install seerapi-models
+```
+也可以使用其他包管理器，如 poetry 等。
+## 开发环境部署
+
+### 使用 uv 部署
+
+1. **安装 uv**
+   ```bash
+   # macOS/Linux
+   curl -LsSf https://astral.sh/uv/install.sh | sh
+   
+   # Windows
+   powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
+   ```
+
+2. **克隆项目**
+   ```bash
+   git clone https://github.com/SeerAPI/seerapi-models.git
+   cd seerapi-models
+   ```
+
+3. **安装依赖**
+   ```bash
+   # 同步项目依赖
+   uv sync
+   ```
+
+4. **运行开发环境**
+   ```bash
+   # 在项目虚拟环境中运行 Python
+   uv run python
+   
+   # 运行测试
+   uv run pytest
+   
+   # 运行代码检查
+   uv run ruff check
+   uv run ruff format
+   ```
+
+### 开发容器 (推荐)
+
+项目提供了 Dev Container 配置，支持一键部署开发环境：
+
+1. 使用 VS Code 打开项目
+2. 安装 Dev Containers 扩展
+3. 按 `Ctrl+Shift+P` 打开命令面板
+4. 选择 "Dev Containers: Reopen in Container"
+
+容器会自动安装：
+- Python 3.10
+- uv 包管理器
+- Ruff 代码检查工具
+- 相关 VS Code 扩展
+
+### 环境要求
+
+- Python >= 3.10
+- uv >= 0.9.0 (推荐使用最新版)
+
+## 许可证
+
+本项目基于 [MIT License](LICENSE) 开源。

seerapi_models-1.0.0/pyproject.toml

@@ -0,0 +1,90 @@
+[build-system]
+requires = ["uv_build>=0.8.14,<0.9.0"]
+build-backend = "uv_build"
+
+[project]
+name = "seerapi-models"
+version = "1.0.0"
+description = "SeerAPI 数据模型/ORM 定义"
+authors = [{ name = "Nattsu39", email = "Nattsu39@outlook.com" }]
+license = { file = "LICENSE" }
+keywords = ["seerapi", "models", "orm"]
+classifiers = [
+    "Operating System :: OS Independent",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "sqlmodel>=0.0.27",
+]
+
+[project.urls]
+Homepage = "https://github.com/SeerAPI/seerapi-models"
+Repository = "https://github.com/SeerAPI/seerapi-models"
+
+[tool.uv.build-backend]
+module-root = ""
+module-name = "seerapi_models"
+
+[tool.pyright]
+pythonVersion = "3.10"
+pythonPlatform = "All"
+typeCheckingMode = "standard"
+reportShadowedImports = false
+disableBytesTypePromotions = true
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+[tool.ruff.format]
+quote-style = "single"
+indent-style = "space"
+line-ending = "lf"
+docstring-code-format = false
+
+[tool.ruff.lint]
+select = [
+  "F",     # Pyflakes
+  "W",     # pycodestyle warnings
+  "E",     # pycodestyle errors
+  "UP",    # pyupgrade
+  "ASYNC", # flake8-async
+  "C4",    # flake8-comprehensions
+  "T10",   # flake8-debugger
+  "T20",   # flake8-print
+  "PYI",   # flake8-pyi
+  "PT",    # flake8-pytest-style
+  "Q",     # flake8-quotes
+  "I",     # isort
+  "RUF",   # Ruff-specific rules
+]
+ignore = [
+  "Q000",   # bad-quotes-inline-string
+  "Q001",   # bad-quotes-multiline-string
+  "Q002",   # bad-quotes-docstring
+  "Q003",   # avoidable-escaped-quote
+  "W191",   # tab-indentation
+  "E402",   # module-import-not-at-top-of-file
+  "UP037",  # quoted-annotation
+  "RUF001", # ambiguous-unicode-character-string
+  "RUF002", # ambiguous-unicode-character-docstring
+  "RUF003", # ambiguous-unicode-character-comment
+]
+
+[tool.ruff.lint.isort]
+force-sort-within-sections = true
+known-first-party = ["solaris", "tests/*"]
+extra-standard-library = ["typing_extensions"]
+
+[tool.ruff.lint.flake8-pytest-style]
+fixture-parentheses = false
+mark-parentheses = false

seerapi_models-1.0.0/seerapi_models/__init__.py

@@ -0,0 +1,244 @@
+from .battle_effect import (
+    BattleEffect,
+    BattleEffectCategory,
+    BattleEffectCategoryORM,
+    BattleEffectORM,
+)
+from .effect import (
+    PetEffect,
+    PetEffectGroup,
+    PetEffectGroupORM,
+    PetEffectORM,
+    VariationEffect,
+    VariationEffectORM,
+)
+from .element_type import (
+    ElementType,
+    ElementTypeORM,
+    TypeCombination,
+    TypeCombinationORM,
+)
+from .items import (
+    EnergyBead,
+    EnergyBeadBuffAttrORM,
+    EnergyBeadORM,
+    Equip,
+    EquipBonus,
+    EquipBonusAttrORM,
+    EquipBonusORM,
+    EquipEffectiveOccasion,
+    EquipEffectiveOccasionORM,
+    EquipORM,
+    EquipType,
+    EquipTypeORM,
+    Gem,
+    GemCategory,
+    GemCategoryORM,
+    GemGen1,
+    GemGen1PartORM,
+    GemGen2,
+    GemGen2PartORM,
+    GemGenCategory,
+    GemGenCategoryORM,
+    GemORM,
+    Item,
+    ItemORM,
+    SkillActivationItem,
+    SkillActivationItemORM,
+    SkillStone,
+    SkillStoneCategory,
+    SkillStoneCategoryORM,
+    SkillStoneEffect,
+    SkillStoneEffectORM,
+    SkillStoneORM,
+    Suit,
+    SuitBonus,
+    SuitBonusAttrORM,
+    SuitBonusORM,
+    SuitORM,
+)
+from .metadata import ApiMetadata, ApiMetadataORM
+from .mintmark import (
+    AbilityMintmark,
+    AbilityPartORM,
+    Mintmark,
+    MintmarkBaseAttrORM,
+    MintmarkClassCategory,
+    MintmarkClassCategoryORM,
+    MintmarkExtraAttrORM,
+    MintmarkMaxAttrORM,
+    MintmarkORM,
+    MintmarkRarityCategory,
+    MintmarkRarityCategoryORM,
+    MintmarkTypeCategory,
+    MintmarkTypeCategoryORM,
+    SkillMintmark,
+    SkillMintmarkEffect,
+    SkillPartORM,
+    UniversalMintmark,
+    UniversalPartORM,
+)
+from .pet import (
+    BaseStatORM,
+    DiyStatsRangeORM,
+    Pet,
+    PetArchiveStoryBook,
+    PetArchiveStoryBookORM,
+    PetArchiveStoryEntry,
+    PetArchiveStoryEntryORM,
+    PetClass,
+    PetClassORM,
+    PetEncyclopediaEntry,
+    PetEncyclopediaEntryORM,
+    PetGenderCategory,
+    PetGenderORM,
+    PetMountTypeCategory,
+    PetMountTypeORM,
+    PetORM,
+    PetSkin,
+    PetSkinCategory,
+    PetSkinCategoryORM,
+    PetSkinORM,
+    PetVipBuffCategory,
+    PetVipBuffORM,
+    SkillInPet,
+    SkillInPetORM,
+    Soulmark,
+    SoulmarkORM,
+    SoulmarkTagCategory,
+    SoulmarkTagORM,
+    YieldingEvORM,
+)
+from .skill import (
+    Skill,
+    SkillCategory,
+    SkillCategoryORM,
+    SkillEffectParam,
+    SkillEffectParamInType,
+    SkillEffectParamInTypeORM,
+    SkillEffectParamORM,
+    SkillEffectType,
+    SkillEffectTypeORM,
+    SkillEffectTypeTag,
+    SkillEffectTypeTagORM,
+    SkillHideEffect,
+    SkillHideEffectORM,
+    SkillORM,
+)
+
+__all__ = [
+    'AbilityMintmark',
+    'AbilityPartORM',
+    'ApiMetadata',
+    'ApiMetadataORM',
+    'BaseStatORM',
+    'BattleEffect',
+    'BattleEffectCategory',
+    'BattleEffectCategoryORM',
+    'BattleEffectORM',
+    'DiyStatsRangeORM',
+    'ElementType',
+    'ElementTypeORM',
+    'EnergyBead',
+    'EnergyBeadBuffAttrORM',
+    'EnergyBeadORM',
+    'Equip',
+    'EquipBonus',
+    'EquipBonusAttrORM',
+    'EquipBonusORM',
+    'EquipEffectiveOccasion',
+    'EquipEffectiveOccasionORM',
+    'EquipORM',
+    'EquipType',
+    'EquipTypeORM',
+    'Gem',
+    'GemCategory',
+    'GemCategoryORM',
+    'GemGen1',
+    'GemGen1PartORM',
+    'GemGen2',
+    'GemGen2PartORM',
+    'GemGenCategory',
+    'GemGenCategoryORM',
+    'GemORM',
+    'Item',
+    'ItemORM',
+    'Mintmark',
+    'MintmarkBaseAttrORM',
+    'MintmarkClassCategory',
+    'MintmarkClassCategoryORM',
+    'MintmarkExtraAttrORM',
+    'MintmarkMaxAttrORM',
+    'MintmarkORM',
+    'MintmarkRarityCategory',
+    'MintmarkRarityCategoryORM',
+    'MintmarkTypeCategory',
+    'MintmarkTypeCategoryORM',
+    'Pet',
+    'PetArchiveStoryBook',
+    'PetArchiveStoryBookORM',
+    'PetArchiveStoryEntry',
+    'PetArchiveStoryEntryORM',
+    'PetClass',
+    'PetClassORM',
+    'PetEffect',
+    'PetEffectGroup',
+    'PetEffectGroupORM',
+    'PetEffectORM',
+    'PetEncyclopediaEntry',
+    'PetEncyclopediaEntryORM',
+    'PetGenderCategory',
+    'PetGenderORM',
+    'PetMountTypeCategory',
+    'PetMountTypeORM',
+    'PetORM',
+    'PetSkin',
+    'PetSkinCategory',
+    'PetSkinCategoryORM',
+    'PetSkinORM',
+    'PetVipBuffCategory',
+    'PetVipBuffORM',
+    'Skill',
+    'SkillActivationItem',
+    'SkillActivationItemORM',
+    'SkillCategory',
+    'SkillCategoryORM',
+    'SkillEffectParam',
+    'SkillEffectParamInType',
+    'SkillEffectParamInTypeORM',
+    'SkillEffectParamORM',
+    'SkillEffectType',
+    'SkillEffectTypeORM',
+    'SkillEffectTypeTag',
+    'SkillEffectTypeTagORM',
+    'SkillHideEffect',
+    'SkillHideEffectORM',
+    'SkillInPet',
+    'SkillInPetORM',
+    'SkillMintmark',
+    'SkillMintmarkEffect',
+    'SkillORM',
+    'SkillPartORM',
+    'SkillStone',
+    'SkillStoneCategory',
+    'SkillStoneCategoryORM',
+    'SkillStoneEffect',
+    'SkillStoneEffectORM',
+    'SkillStoneORM',
+    'Soulmark',
+    'SoulmarkORM',
+    'SoulmarkTagCategory',
+    'SoulmarkTagORM',
+    'Suit',
+    'SuitBonus',
+    'SuitBonusAttrORM',
+    'SuitBonusORM',
+    'SuitORM',
+    'TypeCombination',
+    'TypeCombinationORM',
+    'UniversalMintmark',
+    'UniversalPartORM',
+    'VariationEffect',
+    'VariationEffectORM',
+    'YieldingEvORM',
+]

seerapi_models-1.0.0/seerapi_models/_utils.py

@@ -0,0 +1,27 @@
+def move_to_last(lst: list, index: int) -> None:
+    """
+    将列表中指定索引位置的元素移动到列表的最后一位。
+
+    Args:
+            lst: 要操作的列表
+            index: 要移动的元素的索引位置
+
+    """
+    if 0 <= index < len(lst):
+        # 弹出指定位置的元素并添加到列表末尾
+        element = lst.pop(index)
+        lst.append(element)
+
+
+def move_to_first(lst: list, index: int) -> None:
+    """
+    将列表中指定索引位置的元素移动到列表的第一位。
+
+    Args:
+            lst: 要操作的列表
+            index: 要移动的元素的索引位置
+
+    """
+    if 0 <= index < len(lst):
+        element = lst.pop(index)
+        lst.insert(0, element)