kscale 0.0.2__tar.gz → 0.0.5__tar.gz

{kscale-0.0.2/kscale.egg-info → kscale-0.0.5}/PKG-INFO

@@ -1,15 +1,16 @@
 Metadata-Version: 2.1
 Name: kscale
-Version: 0.0.2
+Version: 0.0.5
 Summary: The kscale project
 Home-page: https://github.com/kscalelabs/kscale
 Author: Benjamin Bolte
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: omegaconf
-Requires-Dist: httpx
-Requires-Dist: requests
+Requires-Dist: omegaconf==2.3.0
+Requires-Dist: email_validator==2.2.0
+Requires-Dist: httpx==0.27.0
+Requires-Dist: requests==2.32.2
 Provides-Extra: dev
 Requires-Dist: black; extra == "dev"
 Requires-Dist: darglint; extra == "dev"
@@ -50,3 +51,32 @@ This is a command line tool for interacting with various services provided by K-
 ```bash
 pip install kscale
 ```
+
+## Usage
+
+### CLI
+
+Download a URDF from the K-Scale Store:
+
+```bash
+kscale urdf download <artifact_id>
+```
+
+Upload a URDF to the K-Scale Store:
+
+```bash
+kscale urdf upload <artifact_id> <root_dir>
+```
+
+### Python API
+
+Reference a URDF by ID from the K-Scale Store:
+
+```python
+from kscale import KScale
+
+async def main():
+  kscale = KScale()
+  urdf_dir_path = await kscale.store.urdf("123456")
+  print(urdf_dir_path)
+```

{kscale-0.0.2 → kscale-0.0.5}/README.md

@@ -30,3 +30,32 @@ This is a command line tool for interacting with various services provided by K-
 ```bash
 pip install kscale
 ```
+
+## Usage
+
+### CLI
+
+Download a URDF from the K-Scale Store:
+
+```bash
+kscale urdf download <artifact_id>
+```
+
+Upload a URDF to the K-Scale Store:
+
+```bash
+kscale urdf upload <artifact_id> <root_dir>
+```
+
+### Python API
+
+Reference a URDF by ID from the K-Scale Store:
+
+```python
+from kscale import KScale
+
+async def main():
+  kscale = KScale()
+  urdf_dir_path = await kscale.store.urdf("123456")
+  print(urdf_dir_path)
+```

kscale-0.0.5/kscale/__init__.py

@@ -0,0 +1,5 @@
+"""Defines the common interface for the K-Scale Python API."""
+
+__version__ = "0.0.5"
+
+from kscale.api import KScale

kscale-0.0.5/kscale/api.py

@@ -0,0 +1,14 @@
+"""Defines common functionality for the K-Scale API."""
+
+from kscale.store.api import StoreAPI
+from kscale.utils.api_base import APIBase
+
+
+class KScale(
+    StoreAPI,
+    APIBase,
+):
+    """Defines a common interface for the K-Scale API."""
+
+    def __init__(self, api_key: str | None = None) -> None:
+        self.api_key = api_key

{kscale-0.0.2 → kscale-0.0.5}/kscale/conf.py

@@ -17,7 +17,7 @@ def get_path() -> Path:
 
 @dataclass
 class StoreSettings:
-    api_key: str = field(default=II("oc.env:KSCALE_API_KEY,"))
+    api_key: str | None = field(default=None)
     cache_dir: str = field(default=II("oc.env:KSCALE_CACHE_DIR,'~/.kscale/cache/'"))
 
 

kscale-0.0.5/kscale/requirements.txt

@@ -0,0 +1,9 @@
+# requirements.txt
+
+# Configuration
+omegaconf==2.3.0
+email_validator==2.2.0
+
+# HTTP requests
+httpx==0.27.0
+requests==2.32.2

kscale-0.0.5/kscale/store/api.py

@@ -0,0 +1,20 @@
+"""Defines a common interface for the K-Scale Store API."""
+
+from pathlib import Path
+
+from kscale.store.urdf import download_urdf
+from kscale.utils.api_base import APIBase
+
+
+class StoreAPI(APIBase):
+    def __init__(
+        self,
+        *,
+        api_key: str | None = None,
+    ) -> None:
+        super().__init__()
+
+        self.api_key = api_key
+
+    async def urdf(self, artifact_id: str) -> Path:
+        return await download_urdf(artifact_id)

{kscale-0.0.2 → kscale-0.0.5}/kscale/store/cli.py

@@ -1,12 +1,13 @@
 """Defines the top-level KOL CLI."""
 
 import argparse
+import asyncio
 from typing import Sequence
 
 from kscale.store import pybullet, urdf
 
 
-def main(args: Sequence[str] | None = None) -> None:
+async def main(args: Sequence[str] | None = None) -> None:
     parser = argparse.ArgumentParser(description="K-Scale OnShape Library", add_help=False)
     parser.add_argument(
         "subcommand",
@@ -20,11 +21,15 @@ def main(args: Sequence[str] | None = None) -> None:
 
     match parsed_args.subcommand:
         case "urdf":
-            urdf.main(remaining_args)
+            await urdf.main(remaining_args)
         case "pybullet":
-            pybullet.main(remaining_args)
+            await pybullet.main(remaining_args)
+
+
+def sync_main(args: Sequence[str] | None = None) -> None:
+    asyncio.run(main(args))
 
 
 if __name__ == "__main__":
     # python3 -m kscale.store.cli
-    main()
+    sync_main()

kscale-0.0.5/kscale/store/client.py

@@ -0,0 +1,79 @@
+"""Defines a typed client for the K-Scale Store API."""
+
+import logging
+from types import TracebackType
+from typing import Any, Dict, Type
+from urllib.parse import urljoin
+
+import httpx
+from pydantic import BaseModel
+
+from kscale.store.gen.api import (
+    NewListingRequest,
+    NewListingResponse,
+    SingleArtifactResponse,
+    UploadArtifactResponse,
+)
+from kscale.store.utils import API_ROOT, get_api_key
+
+logger = logging.getLogger(__name__)
+
+
+class KScaleStoreClient:
+    def __init__(self, base_url: str = API_ROOT) -> None:
+        self.base_url = base_url
+        self.client = httpx.AsyncClient(
+            base_url=self.base_url,
+            headers={"Authorization": f"Bearer {get_api_key()}"},
+        )
+
+    async def _request(
+        self,
+        method: str,
+        endpoint: str,
+        *,
+        params: Dict[str, Any] | None = None,
+        data: BaseModel | None = None,
+        files: Dict[str, Any] | None = None,
+    ) -> Dict[str, Any]:
+        url = urljoin(self.base_url, endpoint)
+        kwargs: Dict[str, Any] = {"params": params}
+
+        if data:
+            kwargs["json"] = data.dict(exclude_unset=True)
+        if files:
+            kwargs["files"] = files
+
+        response = await self.client.request(method, url, **kwargs)
+        if response.is_error:
+            logger.error(f"Error response from K-Scale Store: {response.text}")
+        response.raise_for_status()
+        return response.json()
+
+    async def get_artifact_info(self, artifact_id: str) -> SingleArtifactResponse:
+        data = await self._request("GET", f"/artifacts/info/{artifact_id}")
+        return SingleArtifactResponse(**data)
+
+    async def upload_artifact(self, listing_id: str, file_path: str) -> UploadArtifactResponse:
+        with open(file_path, "rb") as f:
+            files = {"files": (f.name, f, "application/gzip")}
+            data = await self._request("POST", f"/artifacts/upload/{listing_id}", files=files)
+        return UploadArtifactResponse(**data)
+
+    async def create_listing(self, request: NewListingRequest) -> NewListingResponse:
+        data = await self._request("POST", "/listings", data=request)
+        return NewListingResponse(**data)
+
+    async def close(self) -> None:
+        await self.client.aclose()
+
+    async def __aenter__(self) -> "KScaleStoreClient":
+        return self
+
+    async def __aexit__(
+        self,
+        exc_type: Type[BaseException] | None,
+        exc_val: BaseException | None,
+        exc_tb: TracebackType | None,
+    ) -> None:
+        await self.close()

{kscale-0.0.2 → kscale-0.0.5}/kscale/store/gen/api.py

@@ -2,12 +2,12 @@
 
 # generated by datamodel-codegen:
 #   filename:  openapi.json
-#   timestamp: 2024-08-19T06:07:36+00:00
+#   timestamp: 2024-09-04T04:33:58+00:00
 
 from __future__ import annotations
 
 from enum import Enum
-from typing import List, Optional, Union
+from typing import Dict, List, Optional, Union
 
 from pydantic import BaseModel, EmailStr, Field
 
@@ -21,8 +21,9 @@ class AuthResponse(BaseModel):
     api_key: str = Field(..., title="Api Key")
 
 
-class BodySetUrdfUrdfUploadListingIdPost(BaseModel):
-    file: bytes = Field(..., title="File")
+class BodyPullOnshapeDocumentOnshapePullListingIdGet(BaseModel):
+    suffix_to_joint_effort: Optional[Dict[str, float]] = Field(None, title="Suffix To Joint Effort")
+    suffix_to_joint_velocity: Optional[Dict[str, float]] = Field(None, title="Suffix To Joint Velocity")
 
 
 class BodyUploadArtifactsUploadListingIdPost(BaseModel):
@@ -51,7 +52,13 @@ class GetListingResponse(BaseModel):
     description: Optional[str] = Field(..., title="Description")
     child_ids: List[str] = Field(..., title="Child Ids")
     tags: List[str] = Field(..., title="Tags")
+    onshape_url: Optional[str] = Field(..., title="Onshape Url")
     can_edit: bool = Field(..., title="Can Edit")
+    created_at: int = Field(..., title="Created At")
+    views: int = Field(..., title="Views")
+    score: int = Field(..., title="Score")
+    user_vote: Optional[bool] = Field(..., title="User Vote")
+    creator_id: str = Field(..., title="Creator Id")
 
 
 class GetTokenResponse(BaseModel):
@@ -82,42 +89,6 @@ class KeysResponseItem(BaseModel):
     permissions: Optional[List[Permission]] = Field(..., title="Permissions")
 
 
-class ArtifactType(Enum):
-    image = "image"
-
-
-class ArtifactType1(Enum):
-    urdf = "urdf"
-    mjcf = "mjcf"
-
-
-class ArtifactType2(Enum):
-    stl = "stl"
-    obj = "obj"
-    dae = "dae"
-    ply = "ply"
-
-
-class ArtifactType3(Enum):
-    tgz = "tgz"
-    zip = "zip"
-
-
-class ListArtifactsItem(BaseModel):
-    artifact_id: str = Field(..., title="Artifact Id")
-    listing_id: str = Field(..., title="Listing Id")
-    name: str = Field(..., title="Name")
-    artifact_type: Union[ArtifactType, ArtifactType1, ArtifactType2, ArtifactType3] = Field(..., title="Artifact Type")
-    description: Optional[str] = Field(..., title="Description")
-    timestamp: int = Field(..., title="Timestamp")
-    urls: ArtifactUrls
-    is_new: Optional[bool] = Field(None, title="Is New")
-
-
-class ListArtifactsResponse(BaseModel):
-    artifacts: List[ListArtifactsItem] = Field(..., title="Artifacts")
-
-
 class ListKeysResponse(BaseModel):
     keys: List[KeysResponseItem] = Field(..., title="Keys")
 
@@ -130,9 +101,16 @@ class ListListingsResponse(BaseModel):
 class Listing(BaseModel):
     id: str = Field(..., title="Id")
     user_id: str = Field(..., title="User Id")
+    created_at: int = Field(..., title="Created At")
+    updated_at: int = Field(..., title="Updated At")
     name: str = Field(..., title="Name")
     child_ids: List[str] = Field(..., title="Child Ids")
-    description: Optional[str] = Field(..., title="Description")
+    description: Optional[str] = Field(None, title="Description")
+    onshape_url: Optional[str] = Field(None, title="Onshape Url")
+    views: Optional[int] = Field(0, title="Views")
+    upvotes: Optional[int] = Field(0, title="Upvotes")
+    downvotes: Optional[int] = Field(0, title="Downvotes")
+    score: Optional[int] = Field(0, title="Score")
 
 
 class ListingInfoResponse(BaseModel):
@@ -141,6 +119,11 @@ class ListingInfoResponse(BaseModel):
     description: Optional[str] = Field(..., title="Description")
     child_ids: List[str] = Field(..., title="Child Ids")
     image_url: Optional[str] = Field(..., title="Image Url")
+    onshape_url: Optional[str] = Field(..., title="Onshape Url")
+    created_at: int = Field(..., title="Created At")
+    views: int = Field(..., title="Views")
+    score: int = Field(..., title="Score")
+    user_vote: Optional[bool] = Field(..., title="User Vote")
 
 
 class LoginRequest(BaseModel):
@@ -163,6 +146,10 @@ class MyUserInfoResponse(BaseModel):
     github_id: Optional[str] = Field(..., title="Github Id")
     google_id: Optional[str] = Field(..., title="Google Id")
     permissions: Optional[List[Permission1]] = Field(..., title="Permissions")
+    first_name: Optional[str] = Field(..., title="First Name")
+    last_name: Optional[str] = Field(..., title="Last Name")
+    name: Optional[str] = Field(..., title="Name")
+    bio: Optional[str] = Field(..., title="Bio")
 
 
 class NewKeyRequest(BaseModel):
@@ -200,6 +187,48 @@ class PublicUsersInfoResponse(BaseModel):
     users: List[PublicUserInfoResponseItem] = Field(..., title="Users")
 
 
+class SetRequest(BaseModel):
+    onshape_url: Optional[str] = Field(..., title="Onshape Url")
+
+
+class ArtifactType(Enum):
+    image = "image"
+
+
+class ArtifactType1(Enum):
+    urdf = "urdf"
+    mjcf = "mjcf"
+
+
+class ArtifactType2(Enum):
+    stl = "stl"
+    obj = "obj"
+    dae = "dae"
+    ply = "ply"
+
+
+class ArtifactType3(Enum):
+    tgz = "tgz"
+    zip = "zip"
+
+
+class SingleArtifactResponse(BaseModel):
+    artifact_id: str = Field(..., title="Artifact Id")
+    listing_id: str = Field(..., title="Listing Id")
+    name: str = Field(..., title="Name")
+    artifact_type: Union[ArtifactType, ArtifactType1, ArtifactType2, ArtifactType3] = Field(..., title="Artifact Type")
+    description: Optional[str] = Field(..., title="Description")
+    timestamp: int = Field(..., title="Timestamp")
+    urls: ArtifactUrls
+    is_new: Optional[bool] = Field(None, title="Is New")
+
+
+class SortOption(Enum):
+    newest = "newest"
+    most_viewed = "most_viewed"
+    most_upvoted = "most_upvoted"
+
+
 class UpdateArtifactRequest(BaseModel):
     name: Optional[str] = Field(None, title="Name")
     description: Optional[str] = Field(None, title="Description")
@@ -212,18 +241,19 @@ class UpdateListingRequest(BaseModel):
     tags: Optional[List[str]] = Field(None, title="Tags")
 
 
-class UploadArtifactResponse(BaseModel):
-    artifacts: List[ListArtifactsItem] = Field(..., title="Artifacts")
-
-
-class UrdfInfo(BaseModel):
-    artifact_id: str = Field(..., title="Artifact Id")
-    url: str = Field(..., title="Url")
+class UpdateUserRequest(BaseModel):
+    email: Optional[str] = Field(None, title="Email")
+    password: Optional[str] = Field(None, title="Password")
+    github_id: Optional[str] = Field(None, title="Github Id")
+    google_id: Optional[str] = Field(None, title="Google Id")
+    first_name: Optional[str] = Field(None, title="First Name")
+    last_name: Optional[str] = Field(None, title="Last Name")
+    name: Optional[str] = Field(None, title="Name")
+    bio: Optional[str] = Field(None, title="Bio")
 
 
-class UrdfResponse(BaseModel):
-    urdf: Optional[UrdfInfo]
-    listing_id: str = Field(..., title="Listing Id")
+class UploadArtifactResponse(BaseModel):
+    artifacts: List[SingleArtifactResponse] = Field(..., title="Artifacts")
 
 
 class UserInfoResponseItem(BaseModel):
@@ -235,7 +265,7 @@ class UserPublic(BaseModel):
     id: str = Field(..., title="Id")
     email: str = Field(..., title="Email")
     permissions: Optional[List[Permission1]] = Field(None, title="Permissions")
-    created_at: Optional[int] = Field(None, title="Created At")
+    created_at: int = Field(..., title="Created At")
     updated_at: Optional[int] = Field(None, title="Updated At")
     first_name: Optional[str] = Field(None, title="First Name")
     last_name: Optional[str] = Field(None, title="Last Name")
@@ -265,3 +295,7 @@ class GetBatchListingsResponse(BaseModel):
 
 class HTTPValidationError(BaseModel):
     detail: Optional[List[ValidationError]] = Field(None, title="Detail")
+
+
+class ListArtifactsResponse(BaseModel):
+    artifacts: List[SingleArtifactResponse] = Field(..., title="Artifacts")

{kscale-0.0.2 → kscale-0.0.5}/kscale/store/pybullet.py

@@ -1,6 +1,7 @@
 """Simple script to interact with a URDF in PyBullet."""
 
 import argparse
+import asyncio
 import itertools
 import logging
 import math
@@ -8,12 +9,14 @@ import time
 from pathlib import Path
 from typing import Sequence
 
+from kscale.store.urdf import download_urdf
+
 logger = logging.getLogger(__name__)
 
 
-def main(args: Sequence[str] | None = None) -> None:
+async def main(args: Sequence[str] | None = None) -> None:
     parser = argparse.ArgumentParser(description="Show a URDF in PyBullet")
-    parser.add_argument("urdf", nargs="?", help="Path to the URDF file")
+    parser.add_argument("listing_id", help="Listing ID for the URDF")
     parser.add_argument("--dt", type=float, default=0.01, help="Time step")
     parser.add_argument("-n", "--hide-gui", action="store_true", help="Hide the GUI")
     parser.add_argument("--no-merge", action="store_true", help="Do not merge fixed links")
@@ -23,6 +26,9 @@ def main(args: Sequence[str] | None = None) -> None:
     parser.add_argument("--show-collision", action="store_true", help="Show collision meshes")
     parsed_args = parser.parse_args(args)
 
+    # Gets the URDF path.
+    urdf_path = await download_urdf(parsed_args.listing_id)
+
     try:
         import pybullet as p  # type: ignore[import-not-found]
     except ImportError:
@@ -46,13 +52,6 @@ def main(args: Sequence[str] | None = None) -> None:
     # Loads the floor plane.
     floor = p.loadURDF(str((Path(__file__).parent / "bullet" / "plane.urdf").resolve()))
 
-    urdf_path = Path("robot" if parsed_args.urdf is None else parsed_args.urdf)
-    if urdf_path.is_dir():
-        try:
-            urdf_path = next(urdf_path.glob("*.urdf"))
-        except StopIteration:
-            raise FileNotFoundError(f"No URDF files found in {urdf_path}")
-
     # Load the robot URDF.
     start_position = [0.0, 0.0, 1.0]
     start_orientation = p.getQuaternionFromEuler([0.0, 0.0, 0.0])
@@ -175,4 +174,4 @@ def main(args: Sequence[str] | None = None) -> None:
 
 if __name__ == "__main__":
     # python -m kscale.store.pybullet
-    main()
+    asyncio.run(main())