keatpy 0.1.0__tar.gz

keatpy-0.1.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: keatpy
+Version: 0.1.0
+Summary: Official Python SDK for Synapse by Keaton Technologies
+License: MIT
+Project-URL: Homepage, https://keatontechnologies.com/synapse
+Project-URL: Repository, https://github.com/microphonicwire-blip/keatpy
+Keywords: keaton,synapse,api,currency,weather,stocks,news
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# keatpy
+
+Official Python SDK for [Synapse](https://keatontechnologies.com/synapse) by Keaton Technologies.
+
+One API key. Currency, weather, stocks, news, and Wikipedia — unified.
+
+## Install
+
+```bash
+pip install keatpy
+```
+
+## Quick Start
+
+```python
+from keatpy import Synapse
+
+client = Synapse(api_key="syn_yourkey")
+
+# Currency conversion
+result = client.currency.convert("CAD", "USD", 100)
+print(f"100 CAD = {result.result} USD")
+
+# Weather
+w = client.weather.current("Vancouver")
+print(f"{w.city}: {w.temperature}°C, {w.description}")
+
+# Stock quote
+s = client.stocks.quote("NVDA")
+print(f"NVDA: ${s.price} ({s.change_pct})")
+
+# Wikipedia
+wiki = client.wiki.search("quantum computing", sentences=2)
+print(wiki.summary)
+
+# News
+news = client.news.search("PC hardware", limit=3)
+for article in news.articles:
+    print(article.title, "—", article.source)
+```
+
+## Get an API Key
+
+Visit [keatontechnologies.com/synapse](https://keatontechnologies.com/synapse)
+
+## License
+
+MIT

keatpy-0.1.0/README.md

@@ -0,0 +1,48 @@
+# keatpy
+
+Official Python SDK for [Synapse](https://keatontechnologies.com/synapse) by Keaton Technologies.
+
+One API key. Currency, weather, stocks, news, and Wikipedia — unified.
+
+## Install
+
+```bash
+pip install keatpy
+```
+
+## Quick Start
+
+```python
+from keatpy import Synapse
+
+client = Synapse(api_key="syn_yourkey")
+
+# Currency conversion
+result = client.currency.convert("CAD", "USD", 100)
+print(f"100 CAD = {result.result} USD")
+
+# Weather
+w = client.weather.current("Vancouver")
+print(f"{w.city}: {w.temperature}°C, {w.description}")
+
+# Stock quote
+s = client.stocks.quote("NVDA")
+print(f"NVDA: ${s.price} ({s.change_pct})")
+
+# Wikipedia
+wiki = client.wiki.search("quantum computing", sentences=2)
+print(wiki.summary)
+
+# News
+news = client.news.search("PC hardware", limit=3)
+for article in news.articles:
+    print(article.title, "—", article.source)
+```
+
+## Get an API Key
+
+Visit [keatontechnologies.com/synapse](https://keatontechnologies.com/synapse)
+
+## License
+
+MIT

keatpy-0.1.0/keatpy/__init__.py.py

@@ -0,0 +1,350 @@
+"""
+keatpy — Official Python SDK for Synapse by Keaton Technologies
+pip install keatpy
+
+Usage:
+    from keatpy import Synapse
+
+    client = Synapse(api_key="syn_yourkey")
+    result = client.currency.convert("CAD", "USD", 100)
+    print(result.rate)
+"""
+
+import urllib.request
+import urllib.parse
+import json
+from typing import Optional
+
+
+BASE_URL = "https://keaton-api.microphonicwire.workers.dev"
+VERSION  = "0.1.0"
+
+
+# ── RESPONSE OBJECTS ──────────────────────────────────────────
+
+class SynapseResponse:
+    """Base response wrapper — access fields as attributes or dict."""
+    def __init__(self, data: dict):
+        self._data = data
+        for k, v in data.items():
+            setattr(self, k, v)
+
+    def __repr__(self):
+        return f"{self.__class__.__name__}({self._data})"
+
+    def to_dict(self):
+        return self._data
+
+
+class CurrencyResult(SynapseResponse):
+    """
+    Attributes:
+        from_currency (str): Source currency code
+        to_currency (str):   Target currency code
+        amount (float):      Input amount
+        rate (float):        Exchange rate
+        result (float):      Converted amount
+        timestamp (str):     ISO timestamp
+        cached (bool):       Whether response was cached
+    """
+    def __init__(self, data: dict, cached: bool):
+        super().__init__(data)
+        self.from_currency = data.get("from")
+        self.to_currency   = data.get("to")
+        self.cached        = cached
+
+
+class WeatherResult(SynapseResponse):
+    """
+    Attributes:
+        city (str):          City name
+        country (str):       Country code
+        temperature (float): Current temperature
+        feels_like (float):  Feels like temperature
+        humidity (int):      Humidity percentage
+        description (str):   Weather description
+        icon (str):          Icon URL
+        wind_speed (float):  Wind speed
+        units (str):         metric or imperial
+    """
+    pass
+
+
+class StockResult(SynapseResponse):
+    """
+    Attributes:
+        ticker (str):     Stock ticker symbol
+        price (float):    Current price
+        change (float):   Price change
+        change_pct (str): Percentage change
+        volume (int):     Trading volume
+        high (float):     Day high
+        low (float):      Day low
+        prev_close (float): Previous close
+    """
+    pass
+
+
+class WikiResult(SynapseResponse):
+    """
+    Attributes:
+        title (str):   Article title
+        summary (str): Article summary
+        url (str):     Wikipedia URL
+        image (str):   Thumbnail image URL
+        query (str):   Original query
+    """
+    pass
+
+
+class NewsArticle(SynapseResponse):
+    """
+    Attributes:
+        title (str):       Article title
+        description (str): Article description
+        url (str):         Article URL
+        source (str):      Source name
+        published (str):   Publication date
+        image (str):       Article image URL
+    """
+    pass
+
+
+class NewsResult(SynapseResponse):
+    """
+    Attributes:
+        topic (str):          Search topic
+        count (int):          Number of articles
+        articles (list):      List of NewsArticle objects
+    """
+    def __init__(self, data: dict, cached: bool):
+        super().__init__(data)
+        self.articles = [NewsArticle(a) for a in data.get("articles", [])]
+        self.cached   = cached
+
+
+# ── API MODULES ───────────────────────────────────────────────
+
+class CurrencyAPI:
+    def __init__(self, client):
+        self._client = client
+
+    def convert(self, from_currency: str, to_currency: str, amount: float = 1.0) -> CurrencyResult:
+        """
+        Convert between currencies.
+
+        Args:
+            from_currency: Source currency code (e.g. 'CAD')
+            to_currency:   Target currency code (e.g. 'USD')
+            amount:        Amount to convert (default 1.0)
+
+        Returns:
+            CurrencyResult with rate and result
+
+        Example:
+            result = client.currency.convert("CAD", "USD", 500)
+            print(f"500 CAD = {result.result} USD at rate {result.rate}")
+        """
+        res = self._client._get("/api/v1/currency/convert", {
+            "from": from_currency.upper(),
+            "to":   to_currency.upper(),
+            "amount": str(amount),
+        })
+        return CurrencyResult(res["data"], res.get("cached", False))
+
+
+class WeatherAPI:
+    def __init__(self, client):
+        self._client = client
+
+    def current(self, city: str, units: str = "metric") -> WeatherResult:
+        """
+        Get current weather for a city.
+
+        Args:
+            city:  City name (e.g. 'Vancouver')
+            units: 'metric' (°C) or 'imperial' (°F), default 'metric'
+
+        Returns:
+            WeatherResult with temperature, humidity, description, etc.
+
+        Example:
+            w = client.weather.current("Vancouver")
+            print(f"{w.city}: {w.temperature}°C, {w.description}")
+        """
+        res = self._client._get("/api/v1/weather", {"city": city, "units": units})
+        return WeatherResult(res["data"])
+
+
+class StocksAPI:
+    def __init__(self, client):
+        self._client = client
+
+    def quote(self, ticker: str) -> StockResult:
+        """
+        Get a real-time stock quote.
+
+        Args:
+            ticker: Stock ticker symbol (e.g. 'AAPL', 'NVDA')
+
+        Returns:
+            StockResult with price, change, volume, etc.
+
+        Example:
+            stock = client.stocks.quote("NVDA")
+            print(f"NVDA: ${stock.price} ({stock.change_pct})")
+        """
+        res = self._client._get("/api/v1/stocks/quote", {"ticker": ticker.upper()})
+        return StockResult(res["data"])
+
+
+class WikiAPI:
+    def __init__(self, client):
+        self._client = client
+
+    def search(self, query: str, sentences: int = 3) -> WikiResult:
+        """
+        Search Wikipedia and get a clean summary.
+
+        Args:
+            query:     Search query (e.g. 'quantum computing')
+            sentences: Number of sentences to return (default 3)
+
+        Returns:
+            WikiResult with title, summary, url, and image
+
+        Example:
+            result = client.wiki.search("Keaton Technologies")
+            print(result.summary)
+        """
+        res = self._client._get("/api/v1/wiki", {"q": query, "sentences": str(sentences)})
+        return WikiResult(res["data"])
+
+
+class NewsAPI:
+    def __init__(self, client):
+        self._client = client
+
+    def search(self, topic: str, limit: int = 5, lang: str = "en") -> NewsResult:
+        """
+        Get latest news articles on a topic.
+
+        Args:
+            topic: Search topic (e.g. 'technology', 'AMD GPU')
+            limit: Number of articles 1-10 (default 5)
+            lang:  Language code (default 'en')
+
+        Returns:
+            NewsResult with list of NewsArticle objects
+
+        Example:
+            news = client.news.search("PC hardware", limit=3)
+            for article in news.articles:
+                print(article.title, "-", article.source)
+        """
+        res = self._client._get("/api/v1/news", {
+            "topic": topic, "limit": str(limit), "lang": lang
+        })
+        return NewsResult(res["data"], res.get("cached", False))
+
+
+# ── MAIN CLIENT ───────────────────────────────────────────────
+
+class Synapse:
+    """
+    Synapse API client by Keaton Technologies.
+
+    Args:
+        api_key: Your Synapse API key (get one at keatontechnologies.com/synapse)
+        base_url: Override the API base URL (optional)
+
+    Example:
+        from keatpy import Synapse
+
+        client = Synapse(api_key="syn_yourkey")
+
+        # Currency
+        result = client.currency.convert("CAD", "USD", 100)
+        print(result.result)  # 71.8
+
+        # Weather
+        w = client.weather.current("Vancouver")
+        print(w.temperature)  # 14.2
+
+        # Stocks
+        s = client.stocks.quote("AAPL")
+        print(s.price)  # 213.45
+
+        # Wikipedia
+        wiki = client.wiki.search("quantum computing")
+        print(wiki.summary)
+
+        # News
+        news = client.news.search("PC hardware", limit=3)
+        for article in news.articles:
+            print(article.title)
+    """
+
+    def __init__(self, api_key: str, base_url: Optional[str] = None):
+        if not api_key:
+            raise ValueError("api_key is required. Get one at keatontechnologies.com/synapse")
+        self.api_key  = api_key
+        self.base_url = (base_url or BASE_URL).rstrip("/")
+
+        # API modules
+        self.currency = CurrencyAPI(self)
+        self.weather  = WeatherAPI(self)
+        self.stocks   = StocksAPI(self)
+        self.wiki     = WikiAPI(self)
+        self.news     = NewsAPI(self)
+
+    def _get(self, path: str, params: dict = None) -> dict:
+        query = ("?" + urllib.parse.urlencode(params)) if params else ""
+        url   = self.base_url + path + query
+
+        req = urllib.request.Request(url, headers={
+            "X-Synapse-Key": self.api_key,
+            "User-Agent":    f"keatpy/{VERSION}",
+        })
+
+        try:
+            with urllib.request.urlopen(req, timeout=10) as response:
+                raw  = response.read().decode("utf-8")
+                data = json.loads(raw)
+        except urllib.error.HTTPError as e:
+            raw  = e.read().decode("utf-8")
+            data = json.loads(raw)
+            raise SynapseError(data.get("error", "Request failed"), e.code)
+        except urllib.error.URLError as e:
+            raise SynapseError(f"Connection failed: {e.reason}")
+
+        if not data.get("success"):
+            raise SynapseError(data.get("error", "Unknown error"))
+
+        return data
+
+    def status(self) -> dict:
+        """Check API status and list available endpoints."""
+        return self._get("/api/v1/status")
+
+
+class SynapseError(Exception):
+    """Raised when the Synapse API returns an error."""
+    def __init__(self, message: str, status_code: int = None):
+        super().__init__(message)
+        self.status_code = status_code
+
+
+# ── CONVENIENCE EXPORTS ───────────────────────────────────────
+__all__ = [
+    "Synapse",
+    "SynapseError",
+    "CurrencyResult",
+    "WeatherResult",
+    "StockResult",
+    "WikiResult",
+    "NewsResult",
+    "NewsArticle",
+]
+
+__version__ = VERSION

keatpy-0.1.0/keatpy.egg-info/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: keatpy
+Version: 0.1.0
+Summary: Official Python SDK for Synapse by Keaton Technologies
+License: MIT
+Project-URL: Homepage, https://keatontechnologies.com/synapse
+Project-URL: Repository, https://github.com/microphonicwire-blip/keatpy
+Keywords: keaton,synapse,api,currency,weather,stocks,news
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# keatpy
+
+Official Python SDK for [Synapse](https://keatontechnologies.com/synapse) by Keaton Technologies.
+
+One API key. Currency, weather, stocks, news, and Wikipedia — unified.
+
+## Install
+
+```bash
+pip install keatpy
+```
+
+## Quick Start
+
+```python
+from keatpy import Synapse
+
+client = Synapse(api_key="syn_yourkey")
+
+# Currency conversion
+result = client.currency.convert("CAD", "USD", 100)
+print(f"100 CAD = {result.result} USD")
+
+# Weather
+w = client.weather.current("Vancouver")
+print(f"{w.city}: {w.temperature}°C, {w.description}")
+
+# Stock quote
+s = client.stocks.quote("NVDA")
+print(f"NVDA: ${s.price} ({s.change_pct})")
+
+# Wikipedia
+wiki = client.wiki.search("quantum computing", sentences=2)
+print(wiki.summary)
+
+# News
+news = client.news.search("PC hardware", limit=3)
+for article in news.articles:
+    print(article.title, "—", article.source)
+```
+
+## Get an API Key
+
+Visit [keatontechnologies.com/synapse](https://keatontechnologies.com/synapse)
+
+## License
+
+MIT

keatpy-0.1.0/keatpy.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+pyproject.toml
+keatpy/__init__.py.py
+keatpy.egg-info/PKG-INFO
+keatpy.egg-info/SOURCES.txt
+keatpy.egg-info/dependency_links.txt
+keatpy.egg-info/top_level.txt

keatpy-0.1.0/keatpy.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

keatpy-0.1.0/keatpy.egg-info/top_level.txt

@@ -0,0 +1 @@
+keatpy

keatpy-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "keatpy"
+version = "0.1.0"
+description = "Official Python SDK for Synapse by Keaton Technologies"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.8"
+keywords = ["keaton", "synapse", "api", "currency", "weather", "stocks", "news"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage    = "https://keatontechnologies.com/synapse"
+Repository  = "https://github.com/microphonicwire-blip/keatpy"

keatpy-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+