adanos 1.0.0__tar.gz

adanos-1.0.0/.github/workflows/ci.yml

@@ -0,0 +1,41 @@
+name: CI
+
+on:
+  push:
+    branches: ["main", "master"]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: python -m pip install ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest tests -q
+
+      - name: Build wheel and sdist
+        run: python -m build
+
+      - name: Smoke install built SDK
+        run: |
+          python -m venv /tmp/adanos-python-sdk-smoke
+          /tmp/adanos-python-sdk-smoke/bin/pip install dist/adanos-*.whl
+          /tmp/adanos-python-sdk-smoke/bin/python - <<'PY'
+          from adanos import AdanosClient, __version__
+
+          assert __version__
+          client = AdanosClient(api_key="sk_live_example", base_url="https://api.adanos.org")
+          assert client.reddit is not None
+          assert client.news is not None
+          client.close()
+          PY

adanos-1.0.0/.github/workflows/publish-pypi.yml

@@ -0,0 +1,83 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types:
+      - published
+
+concurrency:
+  group: publish-pypi-${{ github.event.release.tag_name }}
+  cancel-in-progress: false
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v5
+        with:
+          ref: ${{ github.event.release.tag_name }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Resolve package version
+        id: version
+        run: |
+          VERSION=$(python - <<'PY'
+          import re
+          from pathlib import Path
+          text = Path("src/adanos/__init__.py").read_text(encoding="utf-8")
+          print(re.search(r'__version__\s*=\s*"([^"]+)"', text).group(1))
+          PY
+          )
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+
+          TAG="${{ github.event.release.tag_name }}"
+          if ! printf '%s' "$TAG" | grep -Eq '^v[0-9]+\.[0-9]+\.[0-9]+'; then
+            echo "Release tag must use SemVer and start with v. Got: $TAG"
+            exit 1
+          fi
+
+          TAG_VERSION="${TAG#v}"
+          if [ "$TAG_VERSION" != "$VERSION" ]; then
+            echo "Release tag version ($TAG_VERSION) does not match package version ($VERSION)."
+            exit 1
+          fi
+
+      - name: Install dependencies
+        run: python -m pip install ".[dev]"
+
+      - name: Run tests
+        run: python -m pytest tests -q
+
+      - name: Build wheel and sdist
+        run: python -m build
+
+      - name: Validate package metadata
+        run: python -m twine check dist/*
+
+      - name: Smoke install built SDK
+        run: |
+          python -m venv /tmp/adanos-python-sdk-release-smoke
+          /tmp/adanos-python-sdk-release-smoke/bin/pip install dist/adanos-*.whl
+          /tmp/adanos-python-sdk-release-smoke/bin/python - <<'PY'
+          from adanos import AdanosClient, __version__
+
+          assert __version__
+          client = AdanosClient(api_key="sk_live_example", base_url="https://api.adanos.org")
+          assert client.reddit is not None
+          assert client.polymarket is not None
+          client.close()
+          PY
+
+      - name: Publish package to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/

adanos-1.0.0/.gitignore

@@ -0,0 +1,34 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+.Python
+venv/
+.venv/
+*.egg-info/
+dist/
+build/
+
+# Environment
+.env
+.env.local
+.env.production
+
+# Local maintainer docs
+RELEASING.md
+
+# IDE / OS
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db
+
+# Tests and coverage
+.pytest_cache/
+.coverage
+coverage_report/
+htmlcov/
+
+# Generated client caches
+src/stocksentiment/_generated/.ruff_cache/

adanos-1.0.0/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to the Adanos Python SDK will be documented in this file.
+
+Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+Versioning: [Semantic Versioning](https://semver.org/spec/v2.0.0.html)
+
+## [1.0.0] - 2026-03-15
+
+### Added
+- First public release of `adanos` as a standalone Python SDK package.
+- Standalone GitHub Actions CI for tests, build, and isolated wheel smoke installation.
+- Standalone Trusted Publishing workflow for PyPI from this repository.
+
+### Changed
+- Renamed the PyPI package from `social-stock-sentiment` to `adanos`.
+- Renamed the Python import path from `stocksentiment` to `adanos`.
+- Renamed the primary client class from `StockSentimentClient` to `AdanosClient`.
+- Package metadata now points to the public repository, API docs, and the new PyPI project.
+- CI and release smoke tests now validate the renamed distribution and import path.
+
+### Migration
+- Replace `pip install social-stock-sentiment` with `pip install adanos`.
+- Replace `from stocksentiment import StockSentimentClient` with `from adanos import AdanosClient`.
+- `StockSentimentClient` remains available as a compatibility alias.

adanos-1.0.0/LICENSE

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

adanos-1.0.0/PKG-INFO

@@ -0,0 +1,376 @@
+Metadata-Version: 2.4
+Name: adanos
+Version: 1.0.0
+Summary: Python SDK for the Adanos Finance Sentiment API
+Project-URL: Homepage, https://adanos.org
+Project-URL: API_Docs, https://api.adanos.org/docs
+Project-URL: Documentation, https://github.com/adanos-software/adanos-python-sdk#readme
+Project-URL: Repository, https://github.com/adanos-software/adanos-python-sdk
+Project-URL: Issues, https://github.com/adanos-software/adanos-python-sdk/issues
+Project-URL: Changelog, https://github.com/adanos-software/adanos-python-sdk/blob/main/CHANGELOG.md
+Project-URL: PyPI, https://pypi.org/project/adanos/
+Author: Alexander Schneider
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,finance,news,polymarket,reddit,sentiment,stocks,x
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: attrs>=22.2
+Requires-Dist: httpx<1,>=0.23
+Requires-Dist: python-dateutil>=2.8
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: respx>=0.22; extra == 'dev'
+Requires-Dist: twine>=6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# adanos
+
+`adanos` is the public Python SDK for the [Adanos Finance Sentiment API](https://api.adanos.org/docs).
+
+It gives you typed access to:
+- Reddit stock sentiment
+- News sentiment and source-filtered rankings
+- X/Twitter stock sentiment
+- Polymarket stock activity and market attention
+- Reddit crypto sentiment
+
+Links:
+- Source: https://github.com/adanos-software/adanos-python-sdk
+- PyPI: https://pypi.org/project/adanos/
+- API docs: https://api.adanos.org/docs
+- Homepage: https://adanos.org
+
+Package and import:
+- PyPI package: `adanos`
+- Python import: `adanos`
+
+## Install
+
+```bash
+python3 -m pip install adanos
+```
+
+## Quick Start
+
+```python
+from adanos import AdanosClient
+
+client = AdanosClient(api_key="sk_live_...")
+
+trending = client.reddit.trending(days=7, limit=10)
+tsla = client.reddit.stock("TSLA", days=14)
+explanation = client.reddit.explain("TSLA")
+
+print(trending[0].ticker)
+print(tsla.buzz_score)
+print(explanation.explanation)
+```
+
+## What You Can Do
+
+- Rank trending stocks across Reddit, News, X, and Polymarket
+- Pull detailed ticker reports for a fixed lookback window
+- Search and compare tickers across datasets
+- Generate AI-written explanations for Reddit and News stock trends
+- Track Reddit crypto tokens via the same client
+- Use sync or async methods without changing the namespace structure
+
+## Namespaces
+
+- `client.reddit.*` for Reddit Stocks
+- `client.news.*` for News Stocks
+- `client.x.*` for X/Twitter Stocks
+- `client.polymarket.*` for Polymarket Stocks
+- `client.crypto.*` for Reddit Crypto
+- `client.reddit_crypto.*` is an alias for `client.crypto.*`
+
+## Examples
+
+### Reddit Stocks
+
+```python
+from adanos import AdanosClient
+
+client = AdanosClient(api_key="sk_live_...")
+
+trending = client.reddit.trending(days=7, limit=10)
+sectors = client.reddit.trending_sectors(days=7, limit=10)
+countries = client.reddit.trending_countries(days=7, limit=10)
+tsla = client.reddit.stock("TSLA", days=14)
+explanation = client.reddit.explain("TSLA")
+results = client.reddit.search("Tesla")
+comparison = client.reddit.compare(["TSLA", "AAPL", "MSFT"], days=7)
+```
+
+### News
+
+```python
+from adanos import AdanosClient
+
+client = AdanosClient(api_key="sk_live_...")
+
+news_trending = client.news.trending(days=7, source="reuters")
+sectors = client.news.trending_sectors(days=7, source="reuters")
+countries = client.news.trending_countries(days=7, source="reuters")
+nvda = client.news.stock("NVDA", days=7)
+explanation = client.news.explain("NVDA")
+results = client.news.search("Nvidia")
+comparison = client.news.compare(["NVDA", "AAPL"], days=7)
+stats = client.news.stats()
+health = client.news.health()
+```
+
+### X/Twitter
+
+```python
+from adanos import AdanosClient
+
+client = AdanosClient(api_key="sk_live_...")
+
+x_trending = client.x.trending(days=1, limit=20)
+sectors = client.x.trending_sectors(days=1, limit=10)
+countries = client.x.trending_countries(days=1, limit=10)
+nvda = client.x.stock("NVDA")
+results = client.x.search("Nvidia")
+comparison = client.x.compare(["NVDA", "AMD"], days=7)
+stats = client.x.stats()
+health = client.x.health()
+```
+
+### Polymarket
+
+```python
+from adanos import AdanosClient
+
+client = AdanosClient(api_key="sk_live_...")
+
+pm_trending = client.polymarket.trending(days=7, limit=20, type="stock")
+sectors = client.polymarket.trending_sectors(days=7, limit=10)
+countries = client.polymarket.trending_countries(days=7, limit=10)
+aapl = client.polymarket.stock("AAPL")
+results = client.polymarket.search("Apple")
+comparison = client.polymarket.compare(["AAPL", "TSLA"], days=7)
+stats = client.polymarket.stats()
+health = client.polymarket.health()
+```
+
+Polymarket semantics:
+- `buzz_score` is activity-first and optimized for current market attention
+- `total_liquidity` is a windowed signal over the selected `days`
+- `top_mentions` on `stock()` are relevance-sorted by trading activity first
+
+### Reddit Crypto
+
+```python
+from adanos import AdanosClient
+
+client = AdanosClient(api_key="sk_live_...")
+
+trending = client.crypto.trending(days=7, limit=20)
+btc = client.crypto.token("BTC", days=14)
+results = client.crypto.search("bitcoin")
+comparison = client.crypto.compare(["BTC", "ETH"], days=7)
+stats = client.crypto.stats()
+health = client.crypto.health()
+```
+
+## Available Methods
+
+### `client.reddit.*`
+
+| Method | Description |
+|--------|-------------|
+| `trending(days, limit, offset, type)` | Trending stocks by buzz score |
+| `trending_sectors(days, limit, offset)` | Trending sectors |
+| `trending_countries(days, limit, offset)` | Trending countries |
+| `stock(ticker, days)` | Detailed sentiment for a ticker |
+| `explain(ticker)` | AI-generated trend explanation |
+| `search(query)` | Search stocks by name or ticker |
+| `compare(tickers, days)` | Compare up to 10 stocks |
+| `stats()` | Dataset statistics |
+| `health()` | Public service health |
+
+### `client.news.*`
+
+| Method | Description |
+|--------|-------------|
+| `trending(days, limit, offset, type, source)` | Trending stocks from news |
+| `trending_sectors(days, limit, offset, source)` | Trending sectors from news |
+| `trending_countries(days, limit, offset, source)` | Trending countries from news |
+| `stock(ticker, days)` | Detailed news sentiment for a ticker |
+| `explain(ticker)` | AI-generated explanation from news context |
+| `search(query)` | Search stocks in the news dataset |
+| `compare(tickers, days)` | Compare up to 10 stocks in news |
+| `stats()` | News dataset statistics |
+| `health()` | Public news service health |
+
+### `client.x.*`
+
+| Method | Description |
+|--------|-------------|
+| `trending(days, limit, offset, type)` | Trending stocks on X/Twitter |
+| `trending_sectors(days, limit, offset)` | Trending sectors |
+| `trending_countries(days, limit, offset)` | Trending countries |
+| `stock(ticker, days)` | Detailed X/Twitter sentiment |
+| `search(query)` | Search stocks |
+| `compare(tickers, days)` | Compare stocks |
+| `stats()` | Dataset statistics |
+| `health()` | Public service health |
+
+### `client.polymarket.*`
+
+| Method | Description |
+|--------|-------------|
+| `trending(days, limit, offset, type)` | Trending stocks on Polymarket with activity-first buzz and windowed liquidity |
+| `trending_sectors(days, limit, offset)` | Trending sectors |
+| `trending_countries(days, limit, offset)` | Trending countries |
+| `stock(ticker, days)` | Detailed Polymarket activity, sentiment, and relevance-sorted market questions |
+| `search(query)` | Search stocks |
+| `compare(tickers, days)` | Compare stocks with windowed Polymarket activity signals |
+| `stats()` | Dataset statistics |
+| `health()` | Public service health |
+
+### `client.crypto.*`
+
+| Method | Description |
+|--------|-------------|
+| `trending(days, limit, offset)` | Trending Reddit crypto tokens |
+| `token(symbol, days)` | Detailed token sentiment and buzz |
+| `search(query)` | Search tokens by symbol or name |
+| `compare(symbols, days)` | Compare multiple tokens |
+| `stats()` | Dataset statistics |
+| `health()` | Public service health |
+
+## Async Usage
+
+Every namespace method also has an `_async` variant.
+
+```python
+import asyncio
+
+from adanos import AdanosClient
+
+
+async def main() -> None:
+    async with AdanosClient(api_key="sk_live_...") as client:
+        trending = await client.reddit.trending_async(days=7)
+        tsla = await client.reddit.stock_async("TSLA")
+        explanation = await client.news.explain_async("NVDA")
+        print(trending[0].ticker)
+        print(tsla.trend)
+        print(explanation.explanation)
+
+
+asyncio.run(main())
+```
+
+## Authentication and Configuration
+
+Get an API key at https://api.adanos.org/docs
+
+```python
+from adanos import AdanosClient
+
+client = AdanosClient(
+    api_key="sk_live_...",
+    base_url="https://api.adanos.org",
+    timeout=60.0,
+)
+```
+
+Notes:
+- `api_key` is required for protected endpoints
+- `base_url` lets you target another deployment or staging environment
+- `timeout` is passed through to the underlying `httpx` client
+- the SDK does not auto-load local CLI profiles or env-specific config files
+
+Context management:
+
+```python
+from adanos import AdanosClient
+
+with AdanosClient(api_key="sk_live_...") as client:
+    print(client.reddit.health())
+```
+
+## Errors and Responses
+
+- The SDK returns typed models from the generated OpenAPI client
+- Documented API errors are returned as typed error models
+- Undocumented statuses raise `UnexpectedStatus`
+- For long-lived processes, use `with`, `async with`, `close()`, or `aclose()` to release HTTP resources
+
+## Rate Limits
+
+Typical platform limits:
+
+| Tier | Monthly Requests | Burst Limit |
+|------|------------------|-------------|
+| Free | 250 | 100/min |
+| Paid | Unlimited | 1000/min |
+
+See the live API docs for the current contract and plan details.
+
+## Migration from `social-stock-sentiment`
+
+Version `1.0.0` starts the new `adanos` package line and renames both the PyPI package and the Python import path.
+
+Old:
+
+```bash
+python3 -m pip install social-stock-sentiment
+```
+
+```python
+from stocksentiment import StockSentimentClient
+```
+
+New:
+
+```bash
+python3 -m pip install adanos
+```
+
+```python
+from adanos import AdanosClient
+```
+
+The client API and namespace layout stay the same. Most upgrades only need a dependency rename and an import rewrite.
+
+`AdanosClient` is now the primary public client name. `StockSentimentClient` remains available as a compatibility alias.
+
+If you adopted the pre-release `adanos-python-sdk` naming locally, switch that install/import pair too:
+
+```bash
+python3 -m pip uninstall adanos-python-sdk
+python3 -m pip install adanos
+```
+
+```python
+from adanos import AdanosClient
+```
+
+## Development
+
+```bash
+python3 -m pip install -e ".[dev]"
+python3 -m pytest tests -q
+python3 -m build
+```
+
+## License
+
+MIT