Merge pull request #1 from themoment-team/feature/club-status-and-year-fields

[update] 동아리 운영 상태 및 학년도 관련 필드 추가

Author: snowykte0426

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "datagsm-openapi-sdk"
-version = "1.0.1"
+version = "1.0.2"
 description = "Python SDK for DataGSM OpenAPI"
 readme = "README.md"
 requires-python = ">=3.9"

src/datagsm_openapi/__init__.py

@@ -36,7 +36,7 @@
     ValidationException,
 )
 
-__version__ = "0.1.0"
+__version__ = "1.0.2"
 
 __all__ = [
     "BadRequestException",

src/datagsm_openapi/_http.py

@@ -4,6 +4,7 @@
 
 import httpx
 
+from . import __version__
 from .exceptions import (
     BadRequestException,
     DataGsmException,
@@ -68,7 +69,7 @@ def _get_headers(self) -> dict[str, str]:
         return {
             "X-API-KEY": self.api_key,
             "Accept": "application/json",
-            "User-Agent": "datagsm-openapi-sdk-python/0.1.0",
+            "User-Agent": f"datagsm-openapi-sdk-python/{__version__}",
         }
 
     def _get_client(self) -> httpx.Client:

src/datagsm_openapi/api/club.py

@@ -3,7 +3,7 @@
 from dataclasses import dataclass
 from typing import Optional
 
-from ..models import ClubDetail, ClubResponse, ClubSortBy, ClubType, SortDirection
+from ..models import ClubDetail, ClubResponse, ClubSortBy, ClubStatus, ClubType, SortDirection
 from ._base import BaseApi
 
 
@@ -14,7 +14,8 @@ class ClubRequest:
     Attributes:
         club_id: Club ID for exact match
         club_name: Club name for filtering
-        club_type: Club type filter (MAJOR_CLUB, JOB_CLUB, AUTONOMOUS_CLUB)
+        club_type: Club type filter (MAJOR_CLUB, AUTONOMOUS_CLUB)
+        status: Club operation status filter (ACTIVE, ABOLISHED)
         page: Page number (default: 0)
         size: Page size (default: 100)
         include_leader_in_participants: Include leader in participants list (default: False)
@@ -25,6 +26,7 @@ class ClubRequest:
     club_id: Optional[int] = None
     club_name: Optional[str] = None
     club_type: Optional[ClubType] = None
+    status: Optional[ClubStatus] = None
     page: int = 0
     size: int = 100
     include_leader_in_participants: bool = False
@@ -41,6 +43,7 @@ def to_params(self) -> dict[str, Optional[object]]:
             "clubId": self.club_id,
             "clubName": self.club_name,
             "clubType": self.club_type.value if self.club_type else None,
+            "status": self.status.value if self.status else None,
             "page": self.page,
             "size": self.size,
             "includeLeaderInParticipants": self.include_leader_in_participants,

src/datagsm_openapi/models/__init__.py

@@ -4,6 +4,7 @@
 from .club import Club, ClubDetail, ClubResponse
 from .enums import (
     ClubSortBy,
+    ClubStatus,
     ClubType,
     Major,
     MealType,
@@ -22,6 +23,7 @@
     "ClubDetail",
     "ClubResponse",
     "ClubSortBy",
+    "ClubStatus",
     "ClubType",
     "CommonApiResponse",
     "Major",

src/datagsm_openapi/models/club.py

@@ -1,10 +1,10 @@
 """Club-related models for DataGSM OpenAPI SDK."""
 
-from typing import TYPE_CHECKING
+from typing import TYPE_CHECKING, Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
-from .enums import ClubType
+from .enums import ClubStatus, ClubType
 
 if TYPE_CHECKING:
     from .project import ParticipantInfo
@@ -37,13 +37,23 @@ class ClubDetail(BaseModel):
         id: Club ID
         name: Club name
         type: Club type
+        status: Club operation status (ACTIVE or ABOLISHED)
+        founded_year: Year the club was founded
+        abolished_year: Year the club was abolished (None if still active)
         leader: Club leader information
         participants: List of club members
     """
 
     id: int = Field(..., description="Club ID")
     name: str = Field(..., description="Club name")
     type: ClubType = Field(..., description="Club type")
+    status: Optional[ClubStatus] = Field(None, description="Club operation status")
+    founded_year: Optional[int] = Field(
+        None, alias="foundedYear", description="Year the club was founded"
+    )
+    abolished_year: Optional[int] = Field(
+        None, alias="abolishedYear", description="Year the club was abolished"
+    )
     leader: "ParticipantInfo" = Field(..., description="Club leader")
     participants: list["ParticipantInfo"] = Field(
         default_factory=list, description="Club members"

src/datagsm_openapi/models/enums.py

@@ -66,12 +66,22 @@ class StudentSortBy(str, Enum):
     DORMITORY_ROOM = "DORMITORY_ROOM"
 
 
+class ClubStatus(str, Enum):
+    """동아리 운영 상태 (Club Status)."""
+
+    ACTIVE = "ACTIVE"
+    ABOLISHED = "ABOLISHED"
+
+
 class ClubSortBy(str, Enum):
     """동아리 정렬 기준 (Club Sort By)."""
 
     ID = "ID"
     NAME = "NAME"
     TYPE = "TYPE"
+    FOUNDED_YEAR = "FOUNDED_YEAR"
+    ABOLISHED_YEAR = "ABOLISHED_YEAR"
+    STATUS = "STATUS"
 
 
 class ProjectSortBy(str, Enum):