nextfarm-sdk 0.1.0__tar.gz

nextfarm_sdk-0.1.0/LICENSE

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

nextfarm_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,59 @@
+Metadata-Version: 2.1
+Name: nextfarm-sdk
+Version: 0.1.0
+Summary: NextFarm API cho Python — sinh từ OpenAPI công khai, có kiểu đầy đủ
+Keywords: nextfarm,agriculture,api,sdk,openapi,iot,gis,traceability
+Author-Email: NextFarm <support@nextfarm.vn>
+License: MIT
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Project-URL: Homepage, https://developers.nextfarm.vn/docs/sdk
+Project-URL: Documentation, https://developers.nextfarm.vn
+Project-URL: Source, https://github.com/nextx-organization/nextfarm-sdk-python
+Project-URL: Changelog, https://github.com/nextx-organization/nextfarm-sdk-python/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/nextx-organization/nextfarm-sdk-python/issues
+Requires-Python: >=3.11
+Requires-Dist: httpx<0.29.0,>=0.23.1
+Requires-Dist: attrs>=22.2.0
+Description-Content-Type: text/markdown
+
+# nextfarm-sdk
+
+> Mã trong kho này được sinh tự động từ [OpenAPI công khai](https://developers.nextfarm.vn/openapi.json). Đừng sửa tay — xem [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Gọi NextFarm API từ Python, có kiểu đầy đủ (đồng bộ và `async`). Mã sinh từ [`/openapi.json`](https://developers.nextfarm.vn/openapi.json)
+và chỉ gồm các tuyến khoá API gọi được.
+
+```sh
+pip install nextfarm-sdk
+```
+
+```python
+import os
+from nextfarm_sdk import create_client, SANDBOX_URL
+from nextfarm_sdk.api.iot import get_api_v1_iot_devices
+
+nf = create_client(api_key=os.environ["NEXTFARM_API_KEY"], base_url=SANDBOX_URL)
+
+page = get_api_v1_iot_devices.sync(client=nf, page=1, page_size=20)
+for d in page.items or []:
+    print(d.name)
+
+# async
+page = await get_api_v1_iot_devices.asyncio(client=nf, page=1)
+```
+
+- Python ≥ 3.11. Mỗi tuyến là một mô-đun trong `nextfarm_sdk.api.<phân hệ>` với 4 hàm: `sync`, `sync_detailed`, `asyncio`, `asyncio_detailed`.
+  Bản `*_detailed` trả thêm mã trạng thái và header.
+- Mặc định gọi prod (`PROD_URL`). Thử nghiệm thì dùng `SANDBOX_URL` với khoá sandbox.
+- Mã trạng thái ngoài tài liệu ném `nextfarm_sdk.errors.UnexpectedStatus`.
+
+Tài liệu: https://developers.nextfarm.vn/docs/sdk · Phiên bản và bỏ dần: [VERSIONING.md](https://github.com/nextx-organization/nextfarm-sdk-python/blob/main/VERSIONING.md) · Giấy phép MIT

nextfarm_sdk-0.1.0/README.md

@@ -0,0 +1,32 @@
+# nextfarm-sdk
+
+> Mã trong kho này được sinh tự động từ [OpenAPI công khai](https://developers.nextfarm.vn/openapi.json). Đừng sửa tay — xem [CONTRIBUTING.md](CONTRIBUTING.md).
+
+Gọi NextFarm API từ Python, có kiểu đầy đủ (đồng bộ và `async`). Mã sinh từ [`/openapi.json`](https://developers.nextfarm.vn/openapi.json)
+và chỉ gồm các tuyến khoá API gọi được.
+
+```sh
+pip install nextfarm-sdk
+```
+
+```python
+import os
+from nextfarm_sdk import create_client, SANDBOX_URL
+from nextfarm_sdk.api.iot import get_api_v1_iot_devices
+
+nf = create_client(api_key=os.environ["NEXTFARM_API_KEY"], base_url=SANDBOX_URL)
+
+page = get_api_v1_iot_devices.sync(client=nf, page=1, page_size=20)
+for d in page.items or []:
+    print(d.name)
+
+# async
+page = await get_api_v1_iot_devices.asyncio(client=nf, page=1)
+```
+
+- Python ≥ 3.11. Mỗi tuyến là một mô-đun trong `nextfarm_sdk.api.<phân hệ>` với 4 hàm: `sync`, `sync_detailed`, `asyncio`, `asyncio_detailed`.
+  Bản `*_detailed` trả thêm mã trạng thái và header.
+- Mặc định gọi prod (`PROD_URL`). Thử nghiệm thì dùng `SANDBOX_URL` với khoá sandbox.
+- Mã trạng thái ngoài tài liệu ném `nextfarm_sdk.errors.UnexpectedStatus`.
+
+Tài liệu: https://developers.nextfarm.vn/docs/sdk · Phiên bản và bỏ dần: [VERSIONING.md](https://github.com/nextx-organization/nextfarm-sdk-python/blob/main/VERSIONING.md) · Giấy phép MIT

nextfarm_sdk-0.1.0/nextfarm_sdk/__init__.py

@@ -0,0 +1,13 @@
+
+""" A client library for accessing NextFarm API """
+from .client import AuthenticatedClient, Client
+
+__all__ = (
+    "AuthenticatedClient",
+    "Client",
+)
+
+from ._version import VERSION
+from .nextfarm import PROD_URL, SANDBOX_URL, create_client
+
+__all__ = (*__all__, "VERSION", "PROD_URL", "SANDBOX_URL", "create_client")

nextfarm_sdk-0.1.0/nextfarm_sdk/_version.py

@@ -0,0 +1 @@
+VERSION = "0.1.0"

nextfarm_sdk-0.1.0/nextfarm_sdk/api/__init__.py

@@ -0,0 +1 @@
+""" Contains methods for accessing the API """

nextfarm_sdk-0.1.0/nextfarm_sdk/api/gis/__init__.py

@@ -0,0 +1 @@
+""" Contains endpoint functions for accessing the API """

nextfarm_sdk-0.1.0/nextfarm_sdk/api/gis/get_api_v1_gis_care_schedules.py

@@ -0,0 +1,189 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.gis_care_activation_dto import GisCareActivationDto
+from ...types import UNSET, Unset
+from typing import cast
+from uuid import UUID
+
+
+
+def _get_kwargs(
+    *,
+    parcel_id: UUID | Unset = UNSET,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    params: dict[str, Any] = {}
+
+    json_parcel_id: str | Unset = UNSET
+    if not isinstance(parcel_id, Unset):
+        json_parcel_id = str(parcel_id)
+    params["parcelId"] = json_parcel_id
+
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/v1/gis/care-schedules",
+        "params": params,
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> list[GisCareActivationDto] | None:
+    if response.status_code == 200:
+        response_200 = []
+        _response_200 = response.json()
+        for response_200_item_data in (_response_200):
+            response_200_item = GisCareActivationDto.from_dict(response_200_item_data)
+
+
+
+            response_200.append(response_200_item)
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[list[GisCareActivationDto]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    parcel_id: UUID | Unset = UNSET,
+
+) -> Response[list[GisCareActivationDto]]:
+    """ Các kích hoạt lịch chăm sóc (lọc theo thửa)
+
+    Args:
+        parcel_id (UUID | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[list[GisCareActivationDto]]
+     """
+
+
+    kwargs = _get_kwargs(
+        parcel_id=parcel_id,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    *,
+    client: AuthenticatedClient | Client,
+    parcel_id: UUID | Unset = UNSET,
+
+) -> list[GisCareActivationDto] | None:
+    """ Các kích hoạt lịch chăm sóc (lọc theo thửa)
+
+    Args:
+        parcel_id (UUID | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        list[GisCareActivationDto]
+     """
+
+
+    return sync_detailed(
+        client=client,
+parcel_id=parcel_id,
+
+    ).parsed
+
+async def asyncio_detailed(
+    *,
+    client: AuthenticatedClient | Client,
+    parcel_id: UUID | Unset = UNSET,
+
+) -> Response[list[GisCareActivationDto]]:
+    """ Các kích hoạt lịch chăm sóc (lọc theo thửa)
+
+    Args:
+        parcel_id (UUID | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[list[GisCareActivationDto]]
+     """
+
+
+    kwargs = _get_kwargs(
+        parcel_id=parcel_id,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    *,
+    client: AuthenticatedClient | Client,
+    parcel_id: UUID | Unset = UNSET,
+
+) -> list[GisCareActivationDto] | None:
+    """ Các kích hoạt lịch chăm sóc (lọc theo thửa)
+
+    Args:
+        parcel_id (UUID | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        list[GisCareActivationDto]
+     """
+
+
+    return (await asyncio_detailed(
+        client=client,
+parcel_id=parcel_id,
+
+    )).parsed

nextfarm_sdk-0.1.0/nextfarm_sdk/api/gis/get_api_v1_gis_care_schedules_id_calendar.py

@@ -0,0 +1,194 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.gis_care_preview_dto import GisCarePreviewDto
+from ...types import UNSET, Unset
+from typing import cast
+from uuid import UUID
+
+
+
+def _get_kwargs(
+    id: UUID,
+    *,
+    year: int | Unset = UNSET,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    params: dict[str, Any] = {}
+
+    params["year"] = year
+
+
+    params = {k: v for k, v in params.items() if v is not UNSET and v is not None}
+
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/v1/gis/care-schedules/{id}/calendar".format(id=quote(str(id), safe=""),),
+        "params": params,
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> GisCarePreviewDto | None:
+    if response.status_code == 200:
+        response_200 = GisCarePreviewDto.from_dict(response.json())
+
+
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[GisCarePreviewDto]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+    year: int | Unset = UNSET,
+
+) -> Response[GisCarePreviewDto]:
+    """ Lịch cả năm của một kích hoạt
+
+    Args:
+        id (UUID):
+        year (int | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[GisCarePreviewDto]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+year=year,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+    year: int | Unset = UNSET,
+
+) -> GisCarePreviewDto | None:
+    """ Lịch cả năm của một kích hoạt
+
+    Args:
+        id (UUID):
+        year (int | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        GisCarePreviewDto
+     """
+
+
+    return sync_detailed(
+        id=id,
+client=client,
+year=year,
+
+    ).parsed
+
+async def asyncio_detailed(
+    id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+    year: int | Unset = UNSET,
+
+) -> Response[GisCarePreviewDto]:
+    """ Lịch cả năm của một kích hoạt
+
+    Args:
+        id (UUID):
+        year (int | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[GisCarePreviewDto]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+year=year,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+    year: int | Unset = UNSET,
+
+) -> GisCarePreviewDto | None:
+    """ Lịch cả năm của một kích hoạt
+
+    Args:
+        id (UUID):
+        year (int | Unset):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        GisCarePreviewDto
+     """
+
+
+    return (await asyncio_detailed(
+        id=id,
+client=client,
+year=year,
+
+    )).parsed

nextfarm_sdk-0.1.0/nextfarm_sdk/api/gis/get_api_v1_gis_care_schedules_id_generations.py

@@ -0,0 +1,177 @@
+from http import HTTPStatus
+from typing import Any, cast
+from urllib.parse import quote
+
+import httpx
+
+from ...client import AuthenticatedClient, Client
+from ...types import Response, UNSET
+from ... import errors
+
+from ...models.gis_care_generation_dto import GisCareGenerationDto
+from typing import cast
+from uuid import UUID
+
+
+
+def _get_kwargs(
+    id: UUID,
+
+) -> dict[str, Any]:
+    
+
+    
+
+    
+
+    _kwargs: dict[str, Any] = {
+        "method": "get",
+        "url": "/api/v1/gis/care-schedules/{id}/generations".format(id=quote(str(id), safe=""),),
+    }
+
+
+    return _kwargs
+
+
+
+def _parse_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> list[GisCareGenerationDto] | None:
+    if response.status_code == 200:
+        response_200 = []
+        _response_200 = response.json()
+        for response_200_item_data in (_response_200):
+            response_200_item = GisCareGenerationDto.from_dict(response_200_item_data)
+
+
+
+            response_200.append(response_200_item)
+
+        return response_200
+
+    if client.raise_on_unexpected_status:
+        raise errors.UnexpectedStatus(response.status_code, response.content)
+    else:
+        return None
+
+
+def _build_response(*, client: AuthenticatedClient | Client, response: httpx.Response) -> Response[list[GisCareGenerationDto]]:
+    return Response(
+        status_code=HTTPStatus(response.status_code),
+        content=response.content,
+        headers=response.headers,
+        parsed=_parse_response(client=client, response=response),
+    )
+
+
+def sync_detailed(
+    id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[list[GisCareGenerationDto]]:
+    """ Lịch sử đã sinh của một kích hoạt
+
+    Args:
+        id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[list[GisCareGenerationDto]]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+
+    )
+
+    response = client.get_httpx_client().request(
+        **kwargs,
+    )
+
+    return _build_response(client=client, response=response)
+
+def sync(
+    id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> list[GisCareGenerationDto] | None:
+    """ Lịch sử đã sinh của một kích hoạt
+
+    Args:
+        id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        list[GisCareGenerationDto]
+     """
+
+
+    return sync_detailed(
+        id=id,
+client=client,
+
+    ).parsed
+
+async def asyncio_detailed(
+    id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> Response[list[GisCareGenerationDto]]:
+    """ Lịch sử đã sinh của một kích hoạt
+
+    Args:
+        id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        Response[list[GisCareGenerationDto]]
+     """
+
+
+    kwargs = _get_kwargs(
+        id=id,
+
+    )
+
+    response = await client.get_async_httpx_client().request(
+        **kwargs
+    )
+
+    return _build_response(client=client, response=response)
+
+async def asyncio(
+    id: UUID,
+    *,
+    client: AuthenticatedClient | Client,
+
+) -> list[GisCareGenerationDto] | None:
+    """ Lịch sử đã sinh của một kích hoạt
+
+    Args:
+        id (UUID):
+
+    Raises:
+        errors.UnexpectedStatus: If the server returns an undocumented status code and Client.raise_on_unexpected_status is True.
+        httpx.TimeoutException: If the request takes longer than Client.timeout.
+
+    Returns:
+        list[GisCareGenerationDto]
+     """
+
+
+    return (await asyncio_detailed(
+        id=id,
+client=client,
+
+    )).parsed