aisles-client 1.0.0__tar.gz

aisles_client-1.0.0/LICENSE

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

aisles_client-1.0.0/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: aisles-client
+Version: 1.0.0
+Summary: Python client for Aisles: is a product in stock at stores near a US city or ZIP, with the store, price and the time Aisles checked. Read-only, no key.
+Author: Aisles Inc.
+License: MIT
+Project-URL: Homepage, https://aislesinventory.com
+Project-URL: Documentation, https://aislesinventory.com/developers
+Project-URL: Source, https://github.com/aislesinventory/aisles
+Keywords: aisles,aislesinventory,local inventory,in stock,shopping,sdk
+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
+License-File: LICENSE
+Dynamic: license-file
+
+# aisles-client (Python)
+
+Python client for [Aisles](https://aislesinventory.com): whether a product is in stock at stores near a covered US city or ZIP, with the store, price and the time Aisles last checked. Read-only, free, no key. Standard library only.
+
+```
+pip install aisles-client
+```
+
+```python
+from aisles_client import Aisles
+
+r = Aisles().search("oat milk", city="chicago", availability="available")
+for l in r["results"]:
+    print(l["summary"], l["links"]["aisles_offer_url"])
+```
+
+Also `search_batch([...])`, `ask("oat milk in Chicago")` and `locations("TX")`, and a command line: `aisles-py search "oat milk" --city chicago`.
+
+Docs: https://aislesinventory.com/developers · Source: https://github.com/aislesinventory/aisles

aisles_client-1.0.0/README.md

@@ -0,0 +1,19 @@
+# aisles-client (Python)
+
+Python client for [Aisles](https://aislesinventory.com): whether a product is in stock at stores near a covered US city or ZIP, with the store, price and the time Aisles last checked. Read-only, free, no key. Standard library only.
+
+```
+pip install aisles-client
+```
+
+```python
+from aisles_client import Aisles
+
+r = Aisles().search("oat milk", city="chicago", availability="available")
+for l in r["results"]:
+    print(l["summary"], l["links"]["aisles_offer_url"])
+```
+
+Also `search_batch([...])`, `ask("oat milk in Chicago")` and `locations("TX")`, and a command line: `aisles-py search "oat milk" --city chicago`.
+
+Docs: https://aislesinventory.com/developers · Source: https://github.com/aislesinventory/aisles

aisles_client-1.0.0/aisles_client/__init__.py

@@ -0,0 +1,64 @@
+"""Client for Aisles (https://aislesinventory.com): whether a product is in stock at stores near a
+covered US city or ZIP, with the store, price and the time Aisles last checked. Read-only, no key.
+
+    from aisles_client import Aisles
+    r = Aisles().search("oat milk", city="chicago", availability="available")
+"""
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+
+__version__ = "1.0.0"
+DEFAULT_BASE = "https://aislesinventory.com"
+
+
+class AislesError(Exception):
+    def __init__(self, code, message, status=0):
+        super().__init__(f"{code} ({status}): {message}")
+        self.code, self.message, self.status = code, message, status
+
+
+class Aisles:
+    def __init__(self, base_url=DEFAULT_BASE, timeout=30):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def _request(self, path, body=None):
+        data = json.dumps(body).encode() if body is not None else None
+        req = urllib.request.Request(self.base_url + path, data=data, method="POST" if data else "GET",
+                                     headers={"Accept": "application/json", "Content-Type": "application/json",
+                                              "User-Agent": f"aisles-python/{__version__}"})
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as res:
+                return json.loads(res.read().decode())
+        except urllib.error.HTTPError as e:
+            try:
+                err = json.loads(e.read().decode()).get("error", {})
+            except ValueError:
+                err = {}
+            raise AislesError(err.get("code", "http_error"), err.get("message", str(e)), e.code) from None
+
+    def search(self, q, city=None, zip=None, availability=None, fulfillment=None, max_price=None, per_page=None, cursor=None):
+        """Listings for a product near a covered city or ZIP: {"pagination": {...}, "results": [...]}."""
+        params = {"q": q, "city": city, "zip": zip, "availability": availability,
+                  "fulfillment": ",".join(fulfillment) if isinstance(fulfillment, (list, tuple)) else fulfillment,
+                  "max_price": max_price, "per_page": per_page, "cursor": cursor}
+        return self._request("/api/v1/search?" + urllib.parse.urlencode({k: v for k, v in params.items() if v is not None}))
+
+    def search_batch(self, queries):
+        """Up to 10 searches at once, each a dict like {"q": "oat milk", "city": "chicago"}."""
+        return self._request("/api/v1/search/batch", {"queries": queries})
+
+    def ask(self, question):
+        """A question in plain words ("oat milk in Chicago"): NLWeb {"query_id", "results"}."""
+        return self._request("/ask?" + urllib.parse.urlencode({"query": question}))
+
+    def locations(self, filter=None):
+        """Covered metros; filter narrows them, e.g. "TX" or "Kroger"."""
+        args = {"filter": filter} if filter else {}
+        reply = self._request("/mcp", {"jsonrpc": "2.0", "id": 1, "method": "tools/call",
+                                       "params": {"name": "list_locations", "arguments": args}})
+        if "error" in reply:
+            raise AislesError("mcp_error", reply["error"].get("message", ""))
+        return reply["result"].get("structuredContent", {}).get("locations", [])

aisles_client-1.0.0/aisles_client/cli.py

@@ -0,0 +1,49 @@
+"""aisles-py: look up local store stock from the command line.
+
+    aisles-py search "oat milk" --city chicago --in-stock
+    aisles-py ask "where can I buy eggs near 60614"
+    aisles-py cities TX
+"""
+import argparse
+import json
+import sys
+
+from . import Aisles, AislesError
+
+
+def main(argv=None):
+    p = argparse.ArgumentParser(prog="aisles-py", description="Local store stock from Aisles (https://aislesinventory.com).")
+    sub = p.add_subparsers(dest="cmd", required=True)
+    s = sub.add_parser("search")
+    s.add_argument("words", nargs="+")
+    s.add_argument("--city")
+    s.add_argument("--zip")
+    s.add_argument("--in-stock", action="store_true")
+    s.add_argument("--limit", type=int, default=5)
+    a = sub.add_parser("ask")
+    a.add_argument("words", nargs="+")
+    c = sub.add_parser("cities")
+    c.add_argument("filter", nargs="*")
+    p.add_argument("--json", action="store_true")
+    args = p.parse_args(argv)
+    client = Aisles()
+    try:
+        if args.cmd == "search":
+            out = client.search(" ".join(args.words), city=args.city, zip=args.zip,
+                                availability="available" if args.in_stock else None, per_page=args.limit)
+            rows = [f"{r['summary']}\n  {r['links']['aisles_offer_url']}" for r in out["results"]] or ["No matching listings."]
+        elif args.cmd == "ask":
+            out = client.ask(" ".join(args.words))
+            rows = ([out["message"]] if out.get("message") else []) + [f"{r['description']}\n  {r['url']}" for r in out["results"]]
+        else:
+            out = client.locations(" ".join(args.filter) or None)
+            rows = [f"{l['name']} ({l['slug']}): {l['stores']} stores" for l in out] or ["No covered metro matches."]
+    except AislesError as e:
+        print(f"aisles-py: {e}", file=sys.stderr)
+        return 1
+    print(json.dumps(out, indent=2) if args.json else "\n\n".join(rows))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

aisles_client-1.0.0/aisles_client.egg-info/PKG-INFO

@@ -0,0 +1,37 @@
+Metadata-Version: 2.4
+Name: aisles-client
+Version: 1.0.0
+Summary: Python client for Aisles: is a product in stock at stores near a US city or ZIP, with the store, price and the time Aisles checked. Read-only, no key.
+Author: Aisles Inc.
+License: MIT
+Project-URL: Homepage, https://aislesinventory.com
+Project-URL: Documentation, https://aislesinventory.com/developers
+Project-URL: Source, https://github.com/aislesinventory/aisles
+Keywords: aisles,aislesinventory,local inventory,in stock,shopping,sdk
+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
+License-File: LICENSE
+Dynamic: license-file
+
+# aisles-client (Python)
+
+Python client for [Aisles](https://aislesinventory.com): whether a product is in stock at stores near a covered US city or ZIP, with the store, price and the time Aisles last checked. Read-only, free, no key. Standard library only.
+
+```
+pip install aisles-client
+```
+
+```python
+from aisles_client import Aisles
+
+r = Aisles().search("oat milk", city="chicago", availability="available")
+for l in r["results"]:
+    print(l["summary"], l["links"]["aisles_offer_url"])
+```
+
+Also `search_batch([...])`, `ask("oat milk in Chicago")` and `locations("TX")`, and a command line: `aisles-py search "oat milk" --city chicago`.
+
+Docs: https://aislesinventory.com/developers · Source: https://github.com/aislesinventory/aisles

aisles_client-1.0.0/aisles_client.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+aisles_client/__init__.py
+aisles_client/cli.py
+aisles_client.egg-info/PKG-INFO
+aisles_client.egg-info/SOURCES.txt
+aisles_client.egg-info/dependency_links.txt
+aisles_client.egg-info/entry_points.txt
+aisles_client.egg-info/top_level.txt

aisles_client-1.0.0/aisles_client.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aisles_client-1.0.0/aisles_client.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aisles-py = aisles_client.cli:main

aisles_client-1.0.0/aisles_client.egg-info/top_level.txt

@@ -0,0 +1 @@
+aisles_client

aisles_client-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aisles-client"
+version = "1.0.0"
+description = "Python client for Aisles: is a product in stock at stores near a US city or ZIP, with the store, price and the time Aisles checked. Read-only, no key."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [{ name = "Aisles Inc." }]
+requires-python = ">=3.8"
+keywords = ["aisles", "aislesinventory", "local inventory", "in stock", "shopping", "sdk"]
+classifiers = ["Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent"]
+
+[project.urls]
+Homepage = "https://aislesinventory.com"
+Documentation = "https://aislesinventory.com/developers"
+Source = "https://github.com/aislesinventory/aisles"
+
+[project.scripts]
+aisles-py = "aisles_client.cli:main"

aisles_client-1.0.0/setup.cfg

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