getme-python-sdk 1.0.0__py3-none-any.whl

getme_python_sdk/__init__.py

@@ -0,0 +1,22 @@
+from .core.client import GetMeClient
+
+__all__ = ["GetMeClient"]
+
+# ==========================================
+# Example Usage (Flask Server integration):
+# ==========================================
+# from flask import Flask, request
+# from getme import GetMeClient
+#
+# server = Flask(__name__)
+# getMeClient = GetMeClient()
+#
+# @server.route('/get', methods=['GET'])
+# def get_value():
+#     key = request.args.get('key')
+#     if not key:
+#         return "Key parameter is required", 400
+#     return getMeClient.get(key), 200
+#
+# if __name__ == '__main__':
+#     server.run(port=3001, debug=True)

getme_python_sdk/core/client.py

@@ -0,0 +1,154 @@
+import os
+
+import requests_unixsocket
+from dotenv import load_dotenv
+import json
+from urllib.parse import quote_plus
+
+from .constants import Constants
+
+
+class GetMeClient:
+    """
+    A client for interacting with the getMe daemon over a Unix Domain Socket.
+    """
+
+    def __init__(self):
+        load_dotenv()
+        self.unix_session = requests_unixsocket.Session()
+        self.sock_path = quote_plus(
+            os.getenv("GETME_SOCK_PATH", "/tmp/getMeStore/sockDir/getMe.sock")
+        )
+
+    def put(self, key, value):
+        """
+        Puts a key-value pair into the store. The value is sent in the request body.
+
+        :param key: The key for the entry.
+        :param value: The value to store.
+        :raises Exception: If the server returns a non-200 status code.
+        """
+
+        url = f"{Constants.BaseUrl}{self.sock_path}/put"
+
+        payload = {"key": key, "value": value}
+        headers = {"Content-Type": "application/json"}
+
+        response = self.unix_session.post(
+            url, data=json.dumps(payload), headers=headers
+        )
+        if response.status_code != 200:
+            raise Exception(f"Failed to put key-value pair: {response.text}")
+
+        return response.json()
+
+    def put_json(self, key, value):
+        """Serializes value as JSON and stores it under the given key."""
+
+        json_string = json.dumps(value, separators=(",", ":"))
+        return self.put(key, json_string)
+
+    def get(self, key) -> str:
+        """
+        Gets a value for a given key from the store.
+
+        :param key: The key to retrieve.
+        :return: The value associated with the key as a string.
+        :raises Exception: If the server returns a non-200 status code.
+        """
+        resp = self.unix_session.get(
+            f"{Constants.BaseUrl}{self.sock_path}/get", params={"key": key}
+        )
+
+        if resp.status_code != 200:
+            raise Exception(f"Failed to get value for key '{key}': {resp.text}")
+
+        print(resp.content.decode("utf-8"))
+        return resp.content.decode("utf-8")
+
+    def get_json(self, key):
+        """Gets the value for key and parses it as JSON."""
+
+        raw = self.get(key)
+        try:
+            return json.loads(raw)
+        except json.JSONDecodeError as exc:
+            raise Exception(f"value for key '{key}' is not valid JSON: {exc}") from exc
+
+    def delete(self, key):
+        """
+        Deletes a key from the store.
+
+        :param key: The key to delete.
+        :raises Exception: If the server returns a non-200 status code.
+        """
+        url = f"{Constants.BaseUrl}{self.sock_path}/delete"
+        response = self.unix_session.delete(url, params={"key": key})
+        if response.status_code != 200:
+            raise Exception(f"Failed to delete key-value pair: {response.text}")
+
+    def clearStore(self):
+        """
+        Clears the entire store.
+
+        :raises Exception: If the server returns a non-200 status code.
+        """
+        url = f"{Constants.BaseUrl}{self.sock_path}/clearStore"
+        response = self.unix_session.delete(url)
+        if response.status_code != 200:
+            raise Exception(f"Failed to clear store: {response.text}")
+
+    def batch_put(self, batch: dict):
+        """
+        Puts multiple key-value pairs into the store.
+
+        :param batch: A dict of key-value pairs to store.
+        :raises Exception: If the server returns a non-200 status code.
+        """
+        url = f"{Constants.BaseUrl}{self.sock_path}/batchPut"
+        headers = {"Content-Type": "application/json"}
+
+        response = self.unix_session.post(url, data=json.dumps(batch), headers=headers)
+        if response.status_code != 200:
+            raise Exception(f"Failed to batch put key-value pairs: {response.text}")
+
+        return response.json()
+
+    def batch_get(self, keys: list):
+        """
+        Gets multiple values for given keys from the store.
+
+        :param keys: A list of keys to retrieve.
+        :return: A dictionary mapping the requested keys to their retrieved values.
+        :raises Exception: If the server returns a non-200 status code.
+        """
+        url = f"{Constants.BaseUrl}{self.sock_path}/batchGet"
+        payload = {"keys": keys}
+        headers = {"Content-Type": "application/json"}
+
+        response = self.unix_session.post(
+            url, data=json.dumps(payload), headers=headers
+        )
+        if response.status_code != 200:
+            raise Exception(f"Failed to batch get keys: {response.text}")
+
+        return response.json()
+
+    def batch_delete(self, keys: list):
+        """
+        Deletes multiple keys from the store.
+
+        :param keys: A list of keys to delete.
+        :raises Exception: If the server returns a non-200 status code.
+        """
+        url = f"{Constants.BaseUrl}{self.sock_path}/batchDelete"
+        payload = {"keys": keys}
+        headers = {"Content-Type": "application/json"}
+
+        response = self.unix_session.delete(
+            url, data=json.dumps(payload), headers=headers
+        )
+        if response.status_code != 200:
+            raise Exception(f"Failed to batch delete keys: {response.text}")
+
+        return response.json()

getme_python_sdk/core/constants.py

@@ -0,0 +1,3 @@
+class Constants:
+    GETME_SOCKET_PATH = "/tmp/getMeStore/sockDir/getMe.sock"
+    BaseUrl = "http+unix://"

getme_python_sdk-1.0.0.dist-info/METADATA

@@ -0,0 +1,16 @@
+Metadata-Version: 2.3
+Name: getme-python-sdk
+Version: 1.0.0
+Summary: Add your description here
+Author: AatirNadim
+Author-email: AatirNadim <aatir.nadim@gmail.com>
+Requires-Dist: certifi==2025.8.3
+Requires-Dist: charset-normalizer==3.4.3
+Requires-Dist: idna==3.10
+Requires-Dist: python-dotenv==1.1.1
+Requires-Dist: requests==2.32.5
+Requires-Dist: requests-unixsocket==0.4.1
+Requires-Dist: urllib3==2.5.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+

getme_python_sdk-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+getme_python_sdk/__init__.py,sha256=vcR-vBr_d9Wq7BBfIdKfGWlpg88cgSBgIefkpKzfe9M,601
+getme_python_sdk/core/client.py,sha256=hQXDIx6H832WSJcur6EO_DhbZ3v9-v4bu_E9vDHswR0,5184
+getme_python_sdk/core/constants.py,sha256=7WpHnjHNXUzJBheIc-_FOU9j7uSFVXFVYpJvIkG9tVk,107
+getme_python_sdk/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+getme_python_sdk-1.0.0.dist-info/WHEEL,sha256=f5fWSvWsg5Knq5GWa6t1nJIug0Tqo69GqAWD_9LbBKw,81
+getme_python_sdk-1.0.0.dist-info/METADATA,sha256=5QRPwYF5NA4QL9VOKYPJavLRt3hAItK_uUxnJqouSaw,468
+getme_python_sdk-1.0.0.dist-info/RECORD,,

getme_python_sdk-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: uv 0.11.16
+Root-Is-Purelib: true
+Tag: py3-none-any