datamaker-py 0.7.0__py3-none-any.whl

datamaker/routes/templates.py

@@ -0,0 +1,69 @@
+from .base import BaseClient
+from ..error import DataMakerError
+from typing import Dict, List
+
+
+class TemplatesClient(BaseClient):
+    """Client for template operations."""
+
+    def get_templates(self) -> List[Dict]:
+        """Fetch all templates from the API."""
+        response = self._make_request("GET", "/templates")
+        return response.json()
+
+    def create_template(
+        self, template_data: Dict, project_id: str, team_id: str
+    ) -> Dict:
+        """Create a new template."""
+        # Ensure required fields are present
+        template_data["projectId"] = project_id
+        template_data["teamId"] = team_id
+
+        # Ensure all fields have the 'active' property set to True by default
+        if "fields" in template_data:
+            for field in template_data["fields"]:
+                if "active" not in field:
+                    field["active"] = True
+
+        response = self._make_request("POST", "/templates", json=template_data)
+        return response.json()
+
+    def get_template(self, template_id: str) -> Dict:
+        """Get a specific template by ID."""
+        response = self._make_request("GET", f"/templates/{template_id}")
+        return response.json()
+
+    def update_template(self, template_id: str, template_data: Dict) -> Dict:
+        """Update a template."""
+        response = self._make_request(
+            "PUT", f"/templates/{template_id}", json=template_data
+        )
+        return response.json()
+
+    def delete_template(self, template_id: str) -> Dict:
+        """Delete a template."""
+        response = self._make_request("DELETE", f"/templates/{template_id}")
+        return response.json()
+
+    def get_template_by_id(self, template_id: str) -> Dict:
+        """Get a specific template by ID (legacy method for backward compatibility)."""
+        try:
+            # Try direct API call first (more efficient)
+            return self.get_template(template_id)
+        except:
+            # Fallback to searching through all templates (legacy behavior)
+            templates = self.get_templates()
+
+            if not templates:
+                raise DataMakerError("No templates found in your account.")
+
+            template = next(
+                (temp for temp in templates if temp["id"] == template_id), None
+            )
+
+            if not template:
+                raise DataMakerError(
+                    "You must provide ID of a template from your account."
+                )
+
+            return template

datamaker/routes/users.py

@@ -0,0 +1,43 @@
+from .base import BaseClient
+from typing import Optional, Dict, List
+
+
+class UsersClient(BaseClient):
+    """Client for user management operations."""
+
+    def get_users(self) -> List[Dict]:
+        """Get all users."""
+        response = self._make_request("GET", "/users")
+        return response.json()
+
+    def create_user(self, user_data: Dict, user_id: str) -> Dict:
+        """Create a new user."""
+        # Ensure required id is present
+        user_data["id"] = user_id
+        response = self._make_request("POST", "/users", json=user_data)
+        return response.json()
+
+    def get_current_user(self) -> Dict:
+        """Get current user information."""
+        response = self._make_request("GET", "/users/me")
+        return response.json()
+
+    def provision_user(self, user_data: Dict) -> Dict:
+        """Provision a new user."""
+        response = self._make_request("POST", "/users/provision", json=user_data)
+        return response.json()
+
+    def update_user(self, user_id: str, user_data: Dict) -> Dict:
+        """Update a user."""
+        response = self._make_request("PUT", f"/users/{user_id}", json=user_data)
+        return response.json()
+
+    def patch_user(self, user_id: str, user_data: Dict) -> Dict:
+        """Partially update a user."""
+        response = self._make_request("PATCH", f"/users/{user_id}", json=user_data)
+        return response.json()
+
+    def delete_user(self, user_id: str) -> Dict:
+        """Delete a user."""
+        response = self._make_request("DELETE", f"/users/{user_id}")
+        return response.json()

datamaker/template.py

@@ -0,0 +1,162 @@
+from typing import Optional, Dict, List, Union
+
+
+class WordsField:
+    def __init__(self, name: str, options: Optional[Dict[str, int]] = None):
+        self.name = name
+        self.type = "Words"
+        self.options = options
+
+
+class UUIDField:
+    def __init__(self, name: str, options: Optional[Dict[str, bool]] = None):
+        self.name = name
+        self.type = "UUID"
+        self.options = options
+
+
+class NumberField:
+    def __init__(
+        self, name: str, options: Optional[Dict[str, Union[int, bool]]] = None
+    ):
+        self.name = name
+        self.type = "Number"
+        self.options = options
+
+
+class FloatField:
+    def __init__(
+        self, name: str, options: Optional[Dict[str, Union[int, float]]] = None
+    ):
+        self.name = name
+        self.type = "Float"
+        self.options = options
+
+
+class BooleanField:
+    def __init__(self, name: str, options: Optional[Dict[str, bool]] = None):
+        self.name = name
+        self.type = "Boolean"
+        self.options = options
+
+
+class AIField:
+    def __init__(self, name: str, prompt: str):
+        self.name = name
+        self.type = "AI"
+        self.options = {"prompt": prompt}
+
+
+class CustomField:
+    def __init__(self, name: str, values: List[str]):
+        self.name = name
+        self.type = "Custom"
+        self.options = {"values": values}
+
+
+# Similar classes would follow for each field type defined in the TypeScript code
+
+DataMakerField = Union[
+    WordsField,
+    UUIDField,
+    NumberField,
+    FloatField,
+    BooleanField,
+    AIField,
+    CustomField,  # Add other field classes here
+]
+
+
+class Template:
+    def __init__(
+        self,
+        fields: List[DataMakerField],
+        name: Optional[str] = None,
+        quantity: Optional[int] = None,
+    ):
+        self.name = name
+        self.fields = fields
+        self.quantity = quantity
+
+    def to_dict(self):
+        return {
+            "name": self.name,
+            "fields": [
+                field.__dict__ if hasattr(field, "__dict__") else field
+                for field in self.fields
+            ],
+            "quantity": self.quantity,
+        }
+
+
+class AccountTemplate:
+    def __init__(
+        self,
+        id: str,
+        name: str,
+        fields: List[DataMakerField],
+        created_at: str,
+        created_by: str,
+        template_folder_id: Optional[None] = None,
+        team_id: str = "",
+        seed: Optional[None] = None,
+    ):
+        self.id = id
+        self.name = name
+        self.fields = fields
+        self.created_at = created_at
+        self.created_by = created_by
+        self.template_folder_id = template_folder_id
+        self.team_id = team_id
+        self.seed = seed
+
+
+class Endpoint:
+    def __init__(
+        self,
+        id: str,
+        name: str,
+        method: str,
+        url: str,
+        headers: Optional[Dict] = None,
+        query_params: Optional[Dict] = None,
+        created_at: str = "",
+        created_by: str = "",
+        team_id: Optional[str] = None,
+        endpoint_folder_id: Optional[Union[str, None]] = None,
+    ):
+        self.id = id
+        self.name = name
+        self.method = method
+        self.url = url
+        self.headers = headers
+        self.query_params = query_params
+        self.created_at = created_at
+        self.created_by = created_by
+        self.team_id = team_id
+        self.endpoint_folder_id = endpoint_folder_id
+
+
+class Headers:
+    def __init__(
+        self, authorization: Optional[str], content_type: str, credentials: str
+    ):
+        self.Authorization = authorization
+        self.Content_type = content_type
+        self.Credentials = credentials
+
+
+Data = Dict[str, Union[str, int]]
+
+
+class CustomEndpoint:
+    def __init__(self, url: str, method: str, headers: Optional[Dict] = None):
+        self.url = url
+        self.method = method
+        self.headers = headers
+
+
+class DBQuery:
+    def __init__(self, connection_id: str, query: str):
+        self.connection_id = connection_id
+        self.query = query

datamaker_py-0.7.0.dist-info/METADATA

@@ -0,0 +1,79 @@
+Metadata-Version: 2.4
+Name: datamaker-py
+Version: 0.7.0
+Summary: The official Python library for the Automators DataMaker API.
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-dotenv>=1.0.1
+Requires-Dist: requests>=2.32.3
+Dynamic: license-file
+
+# DataMaker
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)](https://github.com/charliermarsh/ruff)
+
+The official Python library for the Automators DataMaker API.
+
+## Installation
+
+You can install the package using pip:
+
+```sh
+pip install datamaker-py
+```
+
+## Quick start
+
+Basic example:
+
+```python
+from datamaker import DataMaker, Template
+
+# Create an instance of DataMaker
+datamaker = DataMaker()
+
+
+def main():
+    # Define the template
+    template = Template(
+        name="basic template",
+        quantity=2,
+        fields=[
+            {"name": "first_name", "type": "First Name"},
+            {"name": "last_name", "type": "Last Name"},
+            {
+                "name": "email",
+                "type": "Derived",
+                "options": {"value": "{{first_name}}.{{last_name}}@automators.com"},
+            },
+        ],
+    )
+
+    # Generate data using the template
+    result = datamaker.generate(template)
+    print(result)
+
+
+if __name__ == "__main__":
+    main()
+
+```
+
+## Autocomplete Types
+
+This SDK automatically generates TypeScript autocomplete definitions for use in the [datamaker application](https://github.com/automators/datamaker). 
+
+The artifact is generated automatically on every push to the `main` branch and can be fetched from:
+
+```
+https://raw.githubusercontent.com/automators/datamaker-py/main/artifacts/autocomplete-types.ts
+```
+
+See [`artifacts/README.md`](artifacts/README.md) for more details.
+
+## Development & Contibutions
+
+See the [contributing.md](/CONTRIBUTING.md) guide for details on how to contribute to this project.

datamaker_py-0.7.0.dist-info/RECORD

@@ -0,0 +1,24 @@
+datamaker/__init__.py,sha256=B1tXOTZGJzrXaK96J1Wl2BbZSOocAwb6Sd2e_4dF3Bg,75
+datamaker/core.py,sha256=nuXORr4CM4q3evkeQqH79A9FjVPXHEEBcs9E1xpCpKs,397
+datamaker/error.py,sha256=dM8WkfFH5I_2gLS6pMtheSW8AQ2XPByF9tiXU8FIHus,42
+datamaker/main.py,sha256=UdxPYSY-Z3e-F2nVzyqmsrSpgYYq4TuMDK2XtiF8Kak,31352
+datamaker/template.py,sha256=-aeOKErtcgOq8zYzwg2802ErfqSahQ22ZvSiTMpmuns,4005
+datamaker/routes/__init__.py,sha256=9DDq_O0ZmQfNgFMG0jN_2QupmoN78XqnBDU6igkXkzA,1129
+datamaker/routes/api_keys.py,sha256=RmmK4_ZyNRolfzviW8SWokNSd1osnCVc1gQKV5-yQfw,1404
+datamaker/routes/base.py,sha256=0CNj3q_W5be8DVlXDZiUCLjtBPK8lzAIdJdquv7nsec,1438
+datamaker/routes/connections.py,sha256=6uoSCN-Pz74EV33DoEfETO2zOFLrw96XHDpR1setfl4,2926
+datamaker/routes/custom_types.py,sha256=r5IkJdPiQ-EvsISHcyrm0uYakCOGrALl6hgeiDMQVCE,3928
+datamaker/routes/export_and_validation.py,sha256=rqv-H7XEFcYg0HBD0H8pu9B_JmWbaLe0qNEsAPyVV1w,807
+datamaker/routes/folders_and_utils.py,sha256=LUezjta6N4lWgDnM7JJGAfqeo-xVFdMzAB99kYSw19w,2906
+datamaker/routes/generation.py,sha256=TNraoMdX8NFpD2I1R-I_BNOU1agxNfdIQIAlP8tanqY,406
+datamaker/routes/projects.py,sha256=MzkWll4GOzwNumoi5NuSQVkNV8GBYz_7SjU5rl0Z-io,1270
+datamaker/routes/scenario_files.py,sha256=gM5zkGO-rFVrrtJjDhWZmV-Eagmm8Z_DM6TD_bU5sGM,17494
+datamaker/routes/sets.py,sha256=eleaL6p9IuoxLr71BYHj81obmjDSi6vcAIiCMcGF3H4,6100
+datamaker/routes/teams.py,sha256=NMZOakveoaCf1rRLHbDUowRfn8nRFBeyKAS3PkNAQcc,2235
+datamaker/routes/templates.py,sha256=Xhp6CmYf8j0xVW1-OjqsJ_n00bR0i9KDVxRXFhcme8o,2487
+datamaker/routes/users.py,sha256=jCQUyFpfhJorYciYpVZiTUIXF4YFlIs0d1VE0VwnpU0,1570
+datamaker_py-0.7.0.dist-info/licenses/LICENSE,sha256=ulaO3UjPXJc6FMQJ_BvZaGps8NI0bw368TEqkswlayA,1067
+datamaker_py-0.7.0.dist-info/METADATA,sha256=HwDuoOrV29O9qRL1XclwexMhx8c4bJI81BIN1ujocU0,2211
+datamaker_py-0.7.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+datamaker_py-0.7.0.dist-info/top_level.txt,sha256=XQUROqf8JRZ7xLJLziM8GWUf6HbRJIKhVSLNxTqoqQk,10
+datamaker_py-0.7.0.dist-info/RECORD,,

datamaker_py-0.7.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

datamaker_py-0.7.0.dist-info/licenses/LICENSE

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

datamaker_py-0.7.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+datamaker