opendart-fss 0.1.1__tar.gz → 0.2.0__tar.gz

{opendart_fss-0.1.1 → opendart_fss-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: opendart-fss
-Version: 0.1.1
+Version: 0.2.0
 Summary: 금융감독원 전자공시시스템 OpenDART API Python SDK
 Project-URL: Homepage, https://github.com/hypn4/opendart-fss-python
 Project-URL: Documentation, https://github.com/hypn4/opendart-fss-python#readme
@@ -63,15 +63,13 @@ cp .env.example .env
 
 ```python
 # 환경변수가 설정되어 있으면 api_key 파라미터 생략 가능
-async with OpenDartClient() as client:
-    ...
+client = OpenDartClient()
 ```
 
 **2. 직접 전달**
 
 ```python
-async with OpenDartClient(api_key="YOUR_API_KEY") as client:
-    ...
+client = OpenDartClient(api_key="YOUR_API_KEY")
 ```
 
 ### 예제
@@ -81,31 +79,34 @@ import asyncio
 from opendart_fss import OpenDartClient
 
 async def main():
-    async with OpenDartClient() as client:  # 환경변수에서 API 키 로드
-        # 공시 검색
-        disclosures = await client.disclosure.search(
-            corp_code="00126380",
-            bgn_de="20240101",
-            end_de="20241231"
-        )
-
-        for item in disclosures:
-            print(f"{item.rcept_dt} - {item.report_nm}")
-
-        # 기업 개황
-        company = await client.disclosure.get_company("00126380")
-        print(f"회사명: {company.corp_name}")
-        print(f"대표자: {company.ceo_nm}")
-
-        # 재무제표 조회
-        financials = await client.financial.get_single_account(
-            corp_code="00126380",
-            bsns_year="2024",
-            reprt_code="11011"  # 사업보고서
-        )
-
-        for item in financials:
-            print(f"{item.account_nm}: {item.thstrm_amount}")
+    client = OpenDartClient()  # 환경변수에서 API 키 로드
+
+    # 공시 검색
+    disclosures = await client.disclosure.search(
+        corp_code="00126380",
+        bgn_de="20240101",
+        end_de="20241231"
+    )
+
+    for item in disclosures:
+        print(f"{item.rcept_dt} - {item.report_nm}")
+
+    # 기업 개황
+    company = await client.disclosure.get_company("00126380")
+    print(f"회사명: {company.corp_name}")
+    print(f"대표자: {company.ceo_nm}")
+
+    # 재무제표 조회
+    financials = await client.financial.get_single_account(
+        corp_code="00126380",
+        bsns_year="2024",
+        reprt_code="11011"  # 사업보고서
+    )
+
+    for item in financials:
+        print(f"{item.account_nm}: {item.thstrm_amount}")
+
+    await client.close()
 
 asyncio.run(main())
 ```

{opendart_fss-0.1.1 → opendart_fss-0.2.0}/README.md

@@ -36,15 +36,13 @@ cp .env.example .env
 
 ```python
 # 환경변수가 설정되어 있으면 api_key 파라미터 생략 가능
-async with OpenDartClient() as client:
-    ...
+client = OpenDartClient()
 ```
 
 **2. 직접 전달**
 
 ```python
-async with OpenDartClient(api_key="YOUR_API_KEY") as client:
-    ...
+client = OpenDartClient(api_key="YOUR_API_KEY")
 ```
 
 ### 예제
@@ -54,31 +52,34 @@ import asyncio
 from opendart_fss import OpenDartClient
 
 async def main():
-    async with OpenDartClient() as client:  # 환경변수에서 API 키 로드
-        # 공시 검색
-        disclosures = await client.disclosure.search(
-            corp_code="00126380",
-            bgn_de="20240101",
-            end_de="20241231"
-        )
-
-        for item in disclosures:
-            print(f"{item.rcept_dt} - {item.report_nm}")
-
-        # 기업 개황
-        company = await client.disclosure.get_company("00126380")
-        print(f"회사명: {company.corp_name}")
-        print(f"대표자: {company.ceo_nm}")
-
-        # 재무제표 조회
-        financials = await client.financial.get_single_account(
-            corp_code="00126380",
-            bsns_year="2024",
-            reprt_code="11011"  # 사업보고서
-        )
-
-        for item in financials:
-            print(f"{item.account_nm}: {item.thstrm_amount}")
+    client = OpenDartClient()  # 환경변수에서 API 키 로드
+
+    # 공시 검색
+    disclosures = await client.disclosure.search(
+        corp_code="00126380",
+        bgn_de="20240101",
+        end_de="20241231"
+    )
+
+    for item in disclosures:
+        print(f"{item.rcept_dt} - {item.report_nm}")
+
+    # 기업 개황
+    company = await client.disclosure.get_company("00126380")
+    print(f"회사명: {company.corp_name}")
+    print(f"대표자: {company.ceo_nm}")
+
+    # 재무제표 조회
+    financials = await client.financial.get_single_account(
+        corp_code="00126380",
+        bsns_year="2024",
+        reprt_code="11011"  # 사업보고서
+    )
+
+    for item in financials:
+        print(f"{item.account_nm}: {item.thstrm_amount}")
+
+    await client.close()
 
 asyncio.run(main())
 ```

{opendart_fss-0.1.1 → opendart_fss-0.2.0}/opendart_fss/__init__.py

@@ -8,28 +8,31 @@ Example:
     from opendart_fss import OpenDartClient
 
     async def main():
-        async with OpenDartClient(api_key="YOUR_API_KEY") as client:
-            # 공시 검색
-            disclosures = await client.disclosure.search(
-                corp_code="00126380",
-                bgn_de="20240101",
-                end_de="20241231"
-            )
+        client = OpenDartClient(api_key="YOUR_API_KEY")
 
-            # 기업 개황
-            company = await client.disclosure.get_company("00126380")
-            print(f"회사명: {company.corp_name}")
-            print(f"대표자: {company.ceo_nm}")
+        # 공시 검색
+        disclosures = await client.disclosure.search(
+            corp_code="00126380",
+            bgn_de="20240101",
+            end_de="20241231"
+        )
 
-            # 재무제표 조회
-            financials = await client.financial.get_single_account(
-                corp_code="00126380",
-                bsns_year="2024",
-                reprt_code="11011"  # 사업보고서
-            )
+        # 기업 개황
+        company = await client.disclosure.get_company("00126380")
+        print(f"회사명: {company.corp_name}")
+        print(f"대표자: {company.ceo_nm}")
 
-            for item in financials:
-                print(f"{item.account_nm}: {item.thstrm_amount}")
+        # 재무제표 조회
+        financials = await client.financial.get_single_account(
+            corp_code="00126380",
+            bsns_year="2024",
+            reprt_code="11011"  # 사업보고서
+        )
+
+        for item in financials:
+            print(f"{item.account_nm}: {item.thstrm_amount}")
+
+        await client.close()
 
     asyncio.run(main())
     ```

{opendart_fss-0.1.1 → opendart_fss-0.2.0}/opendart_fss/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.1.1'
-__version_tuple__ = version_tuple = (0, 1, 1)
+__version__ = version = '0.2.0'
+__version_tuple__ = version_tuple = (0, 2, 0)
 
 __commit_id__ = commit_id = None

{opendart_fss-0.1.1 → opendart_fss-0.2.0}/opendart_fss/client.py

@@ -1,7 +1,6 @@
 """OpenDART API 클라이언트."""
 
 import os
-from types import TracebackType
 
 import httpx
 from dotenv import load_dotenv
@@ -21,24 +20,27 @@ class OpenDartClient:
 
     Example:
         ```python
-        async with OpenDartClient(api_key="YOUR_API_KEY") as client:
-            # 공시 검색
-            disclosures = await client.disclosure.search(
-                corp_code="00126380",
-                bgn_de="20240101",
-                end_de="20241231"
-            )
-
-            # 기업 개황
-            company = await client.disclosure.get_company("00126380")
-            print(f"회사명: {company.corp_name}")
-
-            # 재무제표 조회
-            financials = await client.financial.get_single_account(
-                corp_code="00126380",
-                bsns_year="2024",
-                reprt_code="11011"
-            )
+        client = OpenDartClient(api_key="YOUR_API_KEY")
+
+        # 공시 검색
+        disclosures = await client.disclosure.search(
+            corp_code="00126380",
+            bgn_de="20240101",
+            end_de="20241231"
+        )
+
+        # 기업 개황
+        company = await client.disclosure.get_company("00126380")
+        print(f"회사명: {company.corp_name}")
+
+        # 재무제표 조회
+        financials = await client.financial.get_single_account(
+            corp_code="00126380",
+            bsns_year="2024",
+            reprt_code="11011"
+        )
+
+        await client.close()  # 또는 contextlib.aclosing() 사용
         ```
     """
 
@@ -77,20 +79,9 @@ class OpenDartClient:
         self.major_event = MajorEventAPI(self)
         self.registration = RegistrationAPI(self)
 
-    async def __aenter__(self) -> "OpenDartClient":
-        """컨텍스트 매니저 진입."""
-        return self
-
-    async def __aexit__(
-        self,
-        _exc_type: type[BaseException] | None,
-        _exc_val: BaseException | None,
-        _exc_tb: TracebackType | None,
-    ) -> None:
-        """컨텍스트 매니저 종료."""
-        await self.close()
-
-    async def close(self) -> None:
+    async def aclose(self) -> None:
         """HTTP 클라이언트 종료."""
         if not self._external_client:
             await self._http.aclose()
+
+    close = aclose  # alias

{opendart_fss-0.1.1 → opendart_fss-0.2.0}/opendart_fss/verification/runner.py

@@ -60,13 +60,12 @@ class EndpointVerifier:
     async def __aenter__(self) -> "EndpointVerifier":
         """컨텍스트 매니저 진입."""
         self._client = OpenDartClient(api_key=self._api_key)
-        await self._client.__aenter__()
         return self
 
     async def __aexit__(self, *args: Any) -> None:
         """컨텍스트 매니저 종료."""
         if self._client:
-            await self._client.__aexit__(*args)
+            await self._client.close()
 
     async def verify_all(
         self,

{opendart_fss-0.1.1 → opendart_fss-0.2.0}/tests/test_client.py

@@ -1,5 +1,7 @@
 """클라이언트 테스트."""
 
+from contextlib import aclosing
+
 import pytest
 
 from opendart_fss import OpenDartClient
@@ -27,13 +29,13 @@ class TestOpenDartClient:
         assert isinstance(client.registration, RegistrationAPI)
 
     @pytest.mark.asyncio
-    async def test_client_context_manager(self, api_key: str) -> None:
-        """컨텍스트 매니저 테스트."""
-        async with OpenDartClient(api_key=api_key) as client:
+    async def test_client_aclosing(self, api_key: str) -> None:
+        """contextlib.aclosing을 통한 자동 정리 테스트."""
+        async with aclosing(OpenDartClient(api_key=api_key)) as client:
             assert client.api_key == api_key
             assert not client._http.is_closed
 
-        # 컨텍스트 종료 후 HTTP 클라이언트가 닫혀야 함
+        # aclosing 종료 후 HTTP 클라이언트가 닫혀야 함
         assert client._http.is_closed
 
     @pytest.mark.asyncio

{opendart_fss-0.1.1 → opendart_fss-0.2.0}/uv.lock

@@ -1134,7 +1134,7 @@ wheels = [
 ]
 
 [[package]]
-name = "opendart-fss-python"
+name = "opendart-fss"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },