builtsimple-research 1.0.0__tar.gz

builtsimple_research-1.0.0/PKG-INFO

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: builtsimple-research
+Version: 1.0.0
+Summary: Unified API for PubMed, ArXiv, and Wikipedia semantic search
+Project-URL: Homepage, https://built-simple.ai
+Project-URL: Repository, https://github.com/Built-Simple/python-builtsimple
+Author: Built-Simple.ai
+License-Expression: MIT
+Keywords: api,arxiv,pubmed,research,semantic-search,wikipedia
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Dist: httpx>=0.24.0
+Description-Content-Type: text/markdown
+
+# builtsimple-research
+
+Unified API for searching PubMed, ArXiv, and Wikipedia.
+
+## Installation
+
+```bash
+pip install builtsimple-research
+```
+
+## Usage
+
+### Async (recommended)
+```python
+import asyncio
+from builtsimple_research import search_pubmed, search_arxiv, search_wikipedia, search_all
+
+async def main():
+    # Search individual sources
+    pubmed = await search_pubmed("cancer treatment", limit=5)
+    arxiv = await search_arxiv("transformer attention", limit=5)
+    wiki = await search_wikipedia("machine learning", limit=5)
+    
+    # Search all at once
+    all_results = await search_all("neural networks", limit=5)
+    
+asyncio.run(main())
+```
+
+### Sync
+```python
+from builtsimple_research import search_pubmed_sync, search_arxiv_sync, search_wikipedia_sync
+
+results = search_pubmed_sync("cancer treatment", limit=5)
+```
+
+## API
+
+- `search_pubmed(query, limit=10)` - 4.5M+ biomedical articles
+- `search_arxiv(query, limit=10)` - Scientific preprints
+- `search_wikipedia(query, limit=10)` - 4.8M+ articles
+- `search_all(query, limit=10)` - All sources in parallel
+
+## License
+
+MIT - Built-Simple.ai

builtsimple_research-1.0.0/README.md

@@ -0,0 +1,46 @@
+# builtsimple-research
+
+Unified API for searching PubMed, ArXiv, and Wikipedia.
+
+## Installation
+
+```bash
+pip install builtsimple-research
+```
+
+## Usage
+
+### Async (recommended)
+```python
+import asyncio
+from builtsimple_research import search_pubmed, search_arxiv, search_wikipedia, search_all
+
+async def main():
+    # Search individual sources
+    pubmed = await search_pubmed("cancer treatment", limit=5)
+    arxiv = await search_arxiv("transformer attention", limit=5)
+    wiki = await search_wikipedia("machine learning", limit=5)
+    
+    # Search all at once
+    all_results = await search_all("neural networks", limit=5)
+    
+asyncio.run(main())
+```
+
+### Sync
+```python
+from builtsimple_research import search_pubmed_sync, search_arxiv_sync, search_wikipedia_sync
+
+results = search_pubmed_sync("cancer treatment", limit=5)
+```
+
+## API
+
+- `search_pubmed(query, limit=10)` - 4.5M+ biomedical articles
+- `search_arxiv(query, limit=10)` - Scientific preprints
+- `search_wikipedia(query, limit=10)` - 4.8M+ articles
+- `search_all(query, limit=10)` - All sources in parallel
+
+## License
+
+MIT - Built-Simple.ai

builtsimple_research-1.0.0/builtsimple_research/__init__.py

@@ -0,0 +1,76 @@
+"""Built Simple Research - Unified API for PubMed, ArXiv, and Wikipedia"""
+import httpx
+from typing import List, Optional, Dict, Any
+
+__version__ = "1.0.0"
+
+BASE_URLS = {
+    "pubmed": "https://pubmed.built-simple.ai",
+    "arxiv": "https://arxiv.built-simple.ai",
+    "wikipedia": "https://wikipedia.built-simple.ai"
+}
+
+async def search_pubmed(query: str, limit: int = 10) -> List[Dict[str, Any]]:
+    """Search PubMed biomedical literature."""
+    async with httpx.AsyncClient() as client:
+        response = await client.post(
+            f"{BASE_URLS['pubmed']}/search",
+            json={"query": query, "limit": limit}
+        )
+        data = response.json()
+        return [{"source": "PubMed", **r} for r in data.get("results", [])]
+
+async def search_arxiv(query: str, limit: int = 10) -> List[Dict[str, Any]]:
+    """Search ArXiv scientific preprints."""
+    async with httpx.AsyncClient() as client:
+        response = await client.get(
+            f"{BASE_URLS['arxiv']}/api/search",
+            params={"q": query, "limit": limit}
+        )
+        data = response.json()
+        return [{"source": "ArXiv", **r} for r in data.get("results", [])]
+
+async def search_wikipedia(query: str, limit: int = 10) -> List[Dict[str, Any]]:
+    """Search Wikipedia articles."""
+    async with httpx.AsyncClient() as client:
+        response = await client.post(
+            f"{BASE_URLS['wikipedia']}/api/search",
+            json={"query": query, "limit": limit}
+        )
+        data = response.json()
+        return [{"source": "Wikipedia", **r} for r in data.get("results", [])]
+
+async def search_all(query: str, limit: int = 10) -> List[Dict[str, Any]]:
+    """Search all sources in parallel."""
+    import asyncio
+    results = await asyncio.gather(
+        search_pubmed(query, limit),
+        search_arxiv(query, limit),
+        search_wikipedia(query, limit)
+    )
+    return results[0] + results[1] + results[2]
+
+# Sync versions for convenience
+def search_pubmed_sync(query: str, limit: int = 10) -> List[Dict[str, Any]]:
+    """Synchronous PubMed search."""
+    response = httpx.post(
+        f"{BASE_URLS['pubmed']}/search",
+        json={"query": query, "limit": limit}
+    )
+    return [{"source": "PubMed", **r} for r in response.json().get("results", [])]
+
+def search_arxiv_sync(query: str, limit: int = 10) -> List[Dict[str, Any]]:
+    """Synchronous ArXiv search."""
+    response = httpx.get(
+        f"{BASE_URLS['arxiv']}/api/search",
+        params={"q": query, "limit": limit}
+    )
+    return [{"source": "ArXiv", **r} for r in response.json().get("results", [])]
+
+def search_wikipedia_sync(query: str, limit: int = 10) -> List[Dict[str, Any]]:
+    """Synchronous Wikipedia search."""
+    response = httpx.post(
+        f"{BASE_URLS['wikipedia']}/api/search",
+        json={"query": query, "limit": limit}
+    )
+    return [{"source": "Wikipedia", **r} for r in response.json().get("results", [])]

builtsimple_research-1.0.0/pyproject.toml

@@ -0,0 +1,23 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "builtsimple-research"
+version = "1.0.0"
+description = "Unified API for PubMed, ArXiv, and Wikipedia semantic search"
+readme = "README.md"
+license = "MIT"
+authors = [{ name = "Built-Simple.ai" }]
+keywords = ["pubmed", "arxiv", "wikipedia", "research", "semantic-search", "api"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+]
+dependencies = ["httpx>=0.24.0"]
+
+[project.urls]
+Homepage = "https://built-simple.ai"
+Repository = "https://github.com/Built-Simple/python-builtsimple"