datalegion 0.1.0__tar.gz

datalegion-0.1.0/.claude/CLAUDE.md

@@ -0,0 +1,27 @@
+# CLAUDE.md
+
+Python SDK for the Data Legion API. Provides sync (`DataLegion`) and async (`AsyncDataLegion`) clients for person/company enrichment, search, discover, and utility endpoints. All responses are Pydantic v2 models with dot access and autocomplete.
+
+## Commands
+
+```bash
+uv sync --dev          # Install dependencies
+uv run lint            # Lint (ruff format + check, mdformat)
+uv run pytest tests/   # Run tests (needs DATALEGION_API_KEY env var)
+uv build               # Build package
+```
+
+## Architecture
+
+- `src/datalegion/__init__.py` - Package exports (clients, exceptions, response types)
+- `src/datalegion/_client.py` - Sync + async HTTP clients with resource namespaces and `@overload` for enrich return types
+- `src/datalegion/_exceptions.py` - Exception hierarchy (AuthenticationError, RateLimitError, etc.)
+- `src/datalegion/_types.py` - Pydantic v2 response models (PersonResponse, CompanyResponse, etc.)
+- `scripts/lint.py` - Lint script
+- `tests/test_client.py` - Integration tests (call real API)
+
+## Guidelines
+
+- Use `uv run` for all commands
+- Run lint and tests after changes
+- Keep it simple, no over-engineering

datalegion-0.1.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @datalegion-ai/sdk-maintainers

datalegion-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,47 @@
+name: Bug Report
+description: Report a bug in the Python SDK
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of the bug.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Minimal code example or steps to reproduce the issue.
+      render: python
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened. Include any error messages or tracebacks.
+    validations:
+      required: true
+  - type: input
+    id: sdk-version
+    attributes:
+      label: SDK Version
+      description: Output of `pip show datalegion | grep Version`
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      description: Output of `python --version`
+    validations:
+      required: true

datalegion-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1 @@
+blank_issues_enabled: false

datalegion-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,25 @@
+name: Feature Request
+description: Suggest a feature or improvement
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of the feature you'd like.
+    validations:
+      required: true
+  - type: textarea
+    id: use-case
+    attributes:
+      label: Use Case
+      description: Why do you need this? What problem does it solve?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any workarounds or alternatives you've considered.
+    validations:
+      required: false

datalegion-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,10 @@
+## Summary
+
+<!-- What does this PR do? -->
+
+## Test Plan
+
+<!-- How was this tested? -->
+
+- [ ] Tests pass (`uv run pytest tests/`)
+- [ ] Lint passes (`uv run lint`)

datalegion-0.1.0/.github/dependabot.yml

@@ -0,0 +1,34 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "sunday"
+      time: "09:00"
+      timezone: "America/Los_Angeles"
+    labels:
+      - "dependencies"
+      - "python"
+    commit-message:
+      prefix: "chore(deps)"
+    groups:
+      minor-patch:
+        patterns:
+          - "*"
+        update-types:
+          - "minor"
+          - "patch"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "sunday"
+      time: "09:00"
+      timezone: "America/Los_Angeles"
+    labels:
+      - "dependencies"
+      - "github-actions"
+    commit-message:
+      prefix: "chore(deps)"

datalegion-0.1.0/.github/logo-light.svg

@@ -0,0 +1,54 @@
+<svg width="260" height="80" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1">
+  <defs>
+    <linearGradient id="goldGrad">
+      <stop stop-color="#905e26" offset="0"/>
+      <stop stop-color="#f5ec9b" offset="0.5"/>
+      <stop stop-color="#905e26" offset="1"/>
+    </linearGradient>
+    <clipPath id="iconClip">
+      <rect x="4" y="8" width="64" height="64" rx="14" ry="14"/>
+    </clipPath>
+  </defs>
+
+  <!-- Icon scaled to fit -->
+  <g>
+    <g transform="translate(4, 8) scale(0.05333)">
+      <g transform="scale(1.4411527580125738) translate(-83.81662835015196, -83.66665734185113)">
+        <g fill="url(#goldGrad)">
+          <g>
+            <path d="M661.8,226L637,215.3c-12.6-5.4-27.4,0.4-32.8,13l-36.9,85.7L269.8,185.9c-4.2-34.1-33.4-60.6-68.6-60.6 c-38.1,0-69.2,31-69.2,69.1c0,38.1,31,69.2,69.2,69.2c12.3,0,23.9-3.2,33.9-8.9l322.4,138.9l27.1,11.7c10.8,4.7,23.3,1,30-8.2 c1.1-1.5,2-3.1,2.7-4.8l11.1-25.7l0.2-0.4l46.3-107.5C680.3,246.2,674.4,231.5,661.8,226z M201.2,231.9c-2.4,0-4.7-0.2-7-0.7 c-17.3-3.3-30.4-18.5-30.4-36.8c0-20.6,16.8-37.4,37.4-37.4c11.2,0,21.2,4.9,28,12.7c5.8,6.6,9.4,15.3,9.4,24.8 C238.6,215.1,221.8,231.9,201.2,231.9z"/>
+            <path d="M628.3,366.7c-0.1,0.3-0.2,0.5-0.3,0.8l-10.7,24.8c0,0,0,0.1-0.1,0.1L628.3,366.7z"/>
+            <path d="M545.3,279.8L387.9,212c-6.1-2.6-8.9-9.7-6.3-15.8l21-48.7c2.6-6.1,9.7-8.9,15.8-6.3l157.4,67.8 c6.1,2.6,8.9,9.7,6.3,15.8l-21,48.7C558.5,279.6,551.4,282.4,545.3,279.8z"/>
+            <path d="M614.5,397.2c-6.7,9.2-19.2,12.9-30.1,8.3l-24.8-10.7c-0.7-0.3-1.5-0.7-2.2-1.1l27.1,11.7 C595.4,410,607.8,406.4,614.5,397.2z"/>
+            <path d="M630.3,632.5l-24.9-10.6c0,0-0.1,0-0.1-0.1L630.3,632.5z"/>
+            <path d="M717.5,549.4l67.1-157.7c2.6-6.1,9.7-8.9,15.7-6.3l48.7,20.7c6.1,2.6,8.9,9.7,6.3,15.7l-67.1,157.7 c-2.6,6.1-9.7,8.9-15.7,6.3l-48.7-20.7C717.8,562.5,714.9,555.4,717.5,549.4z"/>
+            <path d="M597,616.1c0.1,0.1,0.1,0.1,0.2,0.2C597.2,616.2,597.1,616.2,597,616.1C597.1,616.1,597.1,616.1,597,616.1z"/>
+            <path d="M597.2,616.2c0.3,0.3,0.5,0.6,0.8,0.8C597.7,616.8,597.5,616.5,597.2,616.2z"/>
+            <path d="M596.1,615c0.3,0.4,0.6,0.7,0.9,1c-6.7-7-9-17.6-5-27l10.6-24.9c0.3-0.7,0.7-1.4,1.1-2.1l-11.5,27.1 c-1.5,3.6-2.2,7.4-2,11.1c0,0.3,0,0.5,0.1,0.7c0,0.3,0,0.5,0.1,0.8c0,0,0,0.1,0,0.1c0.1,0.4,0.1,0.9,0.2,1.3 c0.1,0.4,0.1,0.8,0.2,1.2c0,0.2,0.1,0.4,0.2,0.6c0.1,0.4,0.2,0.7,0.3,1c0.1,0.4,0.2,0.8,0.4,1.2c0,0.2,0.1,0.3,0.2,0.5 c0.1,0.4,0.3,0.8,0.5,1.1c0.2,0.4,0.3,0.7,0.5,1.1c0.1,0.2,0.2,0.5,0.4,0.7c0,0.1,0.1,0.2,0.1,0.3c0.2,0.3,0.3,0.6,0.5,0.8 c0.1,0.3,0.3,0.5,0.5,0.7c0.2,0.3,0.4,0.7,0.7,1c0.2,0.2,0.3,0.5,0.5,0.7C595.6,614.4,595.8,614.7,596.1,615z"/>
+            <path d="M599.3,618.2c-0.4-0.4-0.8-0.7-1.2-1.1C598.4,617.4,598.8,617.8,599.3,618.2z"/>
+            <path d="M375.8,610.9L365,636.6c0.1-0.2,0.2-0.5,0.3-0.7l10.5-24.9C375.8,610.9,375.8,610.9,375.8,610.9z"/>
+            <path d="M448.8,722.8l158,66.4c6.1,2.6,9,9.6,6.4,15.7l-20.5,48.8c-2.6,6.1-9.6,9-15.7,6.4l-158-66.4 c-6.1-2.6-9-9.6-6.4-15.7l20.5-48.8C435.6,723.1,442.7,720.2,448.8,722.8z"/>
+            <path d="M435.5,609l-27.1-11.4c-9.7-4-20.6-1.5-27.5,5.6c6.9-7.2,17.9-9.8,27.6-5.7l24.9,10.5 C434.2,608.3,434.9,608.6,435.5,609z"/>
+            <path d="M385.7,381.4l-26-10.8c0.3,0.1,0.6,0.2,0.9,0.4l25,10.4C385.7,381.3,385.7,381.3,385.7,381.4z"/>
+            <path d="M274.1,454.8l-65.7,158.3c-2.5,6.1-9.6,9-15.7,6.5l-48.9-20.3c-6.1-2.5-9-9.6-6.5-15.7L203,425.4 c2.5-6.1,9.6-9,15.7-6.5l48.9,20.3C273.8,441.7,276.7,448.7,274.1,454.8z"/>
+            <g>
+              <path d="M798.8,133c-38.1,0-69.2,31-69.2,69.1c0,13.9,4.1,26.8,11.2,37.6L603.7,562l-11.5,27.1 c-1.5,3.6-2.2,7.4-2,11.1c0,0.2,0,0.5,0.1,0.7c0,0.3,0,0.5,0.1,0.8c0,0,0,0.1,0,0.1c0.1,0.4,0.1,0.9,0.2,1.3 c0.1,0.4,0.1,0.8,0.2,1.2c0,0.2,0.1,0.4,0.2,0.6c0.1,0.4,0.2,0.7,0.3,1c0.1,0.4,0.2,0.8,0.4,1.2c0,0.2,0.1,0.3,0.2,0.5 c0.1,0.4,0.3,0.8,0.5,1.1c0.2,0.4,0.3,0.7,0.5,1.1c0.1,0.2,0.2,0.5,0.4,0.7c0,0.1,0.1,0.2,0.1,0.3c0.2,0.3,0.3,0.6,0.5,0.8 c0.1,0.3,0.3,0.5,0.5,0.7c0.2,0.3,0.4,0.7,0.7,1c0.2,0.2,0.3,0.5,0.5,0.7c0.3,0.3,0.5,0.6,0.8,1c0.2,0.2,0.3,0.4,0.5,0.6 c0.1,0.1,0.1,0.1,0.2,0.2c0.1,0.1,0.1,0.1,0.2,0.2c0.1,0.1,0.1,0.1,0.1,0.1c0.7,0.7,1.4,1.4,2.2,2c0,0,0,0,0,0 c0.4,0.3,0.8,0.6,1.2,0.9c1.5,1.1,3.1,2,4.8,2.7l25,10.7l1.2,0.5l107.7,45.8c12.6,5.4,27.4-0.6,32.7-13.2l10.6-24.9 c5.4-12.6-0.6-27.3-13.2-32.7l-85.9-36.5l128.2-301.3c32.1-6,56.4-34.2,56.4-68C868,164,837,133,798.8,133z M826.1,227.7 c-6.8,7.3-16.5,11.8-27.3,11.8c-20.6,0-37.4-16.8-37.4-37.4c0-0.7,0-1.5,0.1-2.2v0c1.1-19.6,17.4-35.2,37.4-35.2 c20.6,0,37.4,16.8,37.4,37.4C836.3,212,832.4,221,826.1,227.7z"/>
+            </g>
+            <g>
+              <path d="M392.1,385.2c-1.9-1.6-4-2.9-6.3-3.8l-26-10.8l-0.3-0.1l-108.1-44.8c-12.7-5.3-27.4,0.8-32.6,13.5 l-10.4,25c-5.3,12.7,0.8,27.4,13.5,32.6l86.2,35.8L181.7,737.2c-28.7,8.4-49.7,35-49.7,66.4c0,38.1,31,69.2,69.2,69.2 c38.1,0,69.2-31,69.2-69.2c0-16.2-5.6-31.1-15-42.9l132.5-319.5c0.4-0.7,0.7-1.4,1-2.1l10.4-25C403.5,403.7,400.3,392,392.1,385.2 z M201.2,841c-20.6,0-37.4-16.8-37.4-37.4c0-7.6,2.3-14.6,6.1-20.5c6.7-10.2,18.2-16.9,31.3-16.9c19.3,0,35.2,14.7,37.2,33.5v0 c0.1,1.3,0.2,2.6,0.2,3.9C238.6,824.2,221.8,841,201.2,841z"/>
+            </g>
+            <g>
+              <path d="M795,736.3c-12.5,0-24.3,3.4-34.5,9.2L435.5,609l-27.1-11.4c-9.7-4-20.6-1.5-27.5,5.6 c-2.1,2.2-3.9,4.7-5.1,7.7L365,636.6L319.5,745c-5.3,12.7,0.7,27.4,13.3,32.7l24.9,10.5c12.7,5.3,27.4-0.7,32.7-13.3l36.2-86.1 l299.9,126c4.5,33.8,33.5,59.9,68.5,59.9c38.1,0,69.2-31,69.2-69.2C864.2,767.4,833.2,736.3,795,736.3z M795,842.9 c-11.3,0-21.4-5-28.2-12.9h0c-5.7-6.6-9.2-15.2-9.2-24.5c0-20.6,16.8-37.4,37.4-37.4c1.9,0,3.7,0.1,5.6,0.4 c18,2.7,31.9,18.3,31.9,37C832.5,826.1,815.7,842.9,795,842.9z"/>
+            </g>
+          </g>
+        </g>
+      </g>
+    </g>
+  </g>
+
+  <!-- Data Legion text — white for dark backgrounds -->
+  <text x="80" y="38" font-family="Inter, -apple-system, system-ui, Segoe UI, Roboto, Helvetica, Arial, sans-serif" font-size="24" font-weight="600" fill="#1c1917">Data Legion</text>
+
+  <!-- Enterprise Data Solutions tagline -->
+  <text x="80" y="58" font-family="Inter, -apple-system, system-ui, Segoe UI, Roboto, Helvetica, Arial, sans-serif" font-size="13" font-weight="500" fill="#d4af37">Enterprise Data Solutions</text>
+</svg>

datalegion-0.1.0/.github/logo.svg

@@ -0,0 +1,54 @@
+<svg width="260" height="80" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" version="1.1">
+  <defs>
+    <linearGradient id="goldGrad">
+      <stop stop-color="#905e26" offset="0"/>
+      <stop stop-color="#f5ec9b" offset="0.5"/>
+      <stop stop-color="#905e26" offset="1"/>
+    </linearGradient>
+    <clipPath id="iconClip">
+      <rect x="4" y="8" width="64" height="64" rx="14" ry="14"/>
+    </clipPath>
+  </defs>
+
+  <!-- Icon scaled to fit -->
+  <g>
+    <g transform="translate(4, 8) scale(0.05333)">
+      <g transform="scale(1.4411527580125738) translate(-83.81662835015196, -83.66665734185113)">
+        <g fill="url(#goldGrad)">
+          <g>
+            <path d="M661.8,226L637,215.3c-12.6-5.4-27.4,0.4-32.8,13l-36.9,85.7L269.8,185.9c-4.2-34.1-33.4-60.6-68.6-60.6 c-38.1,0-69.2,31-69.2,69.1c0,38.1,31,69.2,69.2,69.2c12.3,0,23.9-3.2,33.9-8.9l322.4,138.9l27.1,11.7c10.8,4.7,23.3,1,30-8.2 c1.1-1.5,2-3.1,2.7-4.8l11.1-25.7l0.2-0.4l46.3-107.5C680.3,246.2,674.4,231.5,661.8,226z M201.2,231.9c-2.4,0-4.7-0.2-7-0.7 c-17.3-3.3-30.4-18.5-30.4-36.8c0-20.6,16.8-37.4,37.4-37.4c11.2,0,21.2,4.9,28,12.7c5.8,6.6,9.4,15.3,9.4,24.8 C238.6,215.1,221.8,231.9,201.2,231.9z"/>
+            <path d="M628.3,366.7c-0.1,0.3-0.2,0.5-0.3,0.8l-10.7,24.8c0,0,0,0.1-0.1,0.1L628.3,366.7z"/>
+            <path d="M545.3,279.8L387.9,212c-6.1-2.6-8.9-9.7-6.3-15.8l21-48.7c2.6-6.1,9.7-8.9,15.8-6.3l157.4,67.8 c6.1,2.6,8.9,9.7,6.3,15.8l-21,48.7C558.5,279.6,551.4,282.4,545.3,279.8z"/>
+            <path d="M614.5,397.2c-6.7,9.2-19.2,12.9-30.1,8.3l-24.8-10.7c-0.7-0.3-1.5-0.7-2.2-1.1l27.1,11.7 C595.4,410,607.8,406.4,614.5,397.2z"/>
+            <path d="M630.3,632.5l-24.9-10.6c0,0-0.1,0-0.1-0.1L630.3,632.5z"/>
+            <path d="M717.5,549.4l67.1-157.7c2.6-6.1,9.7-8.9,15.7-6.3l48.7,20.7c6.1,2.6,8.9,9.7,6.3,15.7l-67.1,157.7 c-2.6,6.1-9.7,8.9-15.7,6.3l-48.7-20.7C717.8,562.5,714.9,555.4,717.5,549.4z"/>
+            <path d="M597,616.1c0.1,0.1,0.1,0.1,0.2,0.2C597.2,616.2,597.1,616.2,597,616.1C597.1,616.1,597.1,616.1,597,616.1z"/>
+            <path d="M597.2,616.2c0.3,0.3,0.5,0.6,0.8,0.8C597.7,616.8,597.5,616.5,597.2,616.2z"/>
+            <path d="M596.1,615c0.3,0.4,0.6,0.7,0.9,1c-6.7-7-9-17.6-5-27l10.6-24.9c0.3-0.7,0.7-1.4,1.1-2.1l-11.5,27.1 c-1.5,3.6-2.2,7.4-2,11.1c0,0.3,0,0.5,0.1,0.7c0,0.3,0,0.5,0.1,0.8c0,0,0,0.1,0,0.1c0.1,0.4,0.1,0.9,0.2,1.3 c0.1,0.4,0.1,0.8,0.2,1.2c0,0.2,0.1,0.4,0.2,0.6c0.1,0.4,0.2,0.7,0.3,1c0.1,0.4,0.2,0.8,0.4,1.2c0,0.2,0.1,0.3,0.2,0.5 c0.1,0.4,0.3,0.8,0.5,1.1c0.2,0.4,0.3,0.7,0.5,1.1c0.1,0.2,0.2,0.5,0.4,0.7c0,0.1,0.1,0.2,0.1,0.3c0.2,0.3,0.3,0.6,0.5,0.8 c0.1,0.3,0.3,0.5,0.5,0.7c0.2,0.3,0.4,0.7,0.7,1c0.2,0.2,0.3,0.5,0.5,0.7C595.6,614.4,595.8,614.7,596.1,615z"/>
+            <path d="M599.3,618.2c-0.4-0.4-0.8-0.7-1.2-1.1C598.4,617.4,598.8,617.8,599.3,618.2z"/>
+            <path d="M375.8,610.9L365,636.6c0.1-0.2,0.2-0.5,0.3-0.7l10.5-24.9C375.8,610.9,375.8,610.9,375.8,610.9z"/>
+            <path d="M448.8,722.8l158,66.4c6.1,2.6,9,9.6,6.4,15.7l-20.5,48.8c-2.6,6.1-9.6,9-15.7,6.4l-158-66.4 c-6.1-2.6-9-9.6-6.4-15.7l20.5-48.8C435.6,723.1,442.7,720.2,448.8,722.8z"/>
+            <path d="M435.5,609l-27.1-11.4c-9.7-4-20.6-1.5-27.5,5.6c6.9-7.2,17.9-9.8,27.6-5.7l24.9,10.5 C434.2,608.3,434.9,608.6,435.5,609z"/>
+            <path d="M385.7,381.4l-26-10.8c0.3,0.1,0.6,0.2,0.9,0.4l25,10.4C385.7,381.3,385.7,381.3,385.7,381.4z"/>
+            <path d="M274.1,454.8l-65.7,158.3c-2.5,6.1-9.6,9-15.7,6.5l-48.9-20.3c-6.1-2.5-9-9.6-6.5-15.7L203,425.4 c2.5-6.1,9.6-9,15.7-6.5l48.9,20.3C273.8,441.7,276.7,448.7,274.1,454.8z"/>
+            <g>
+              <path d="M798.8,133c-38.1,0-69.2,31-69.2,69.1c0,13.9,4.1,26.8,11.2,37.6L603.7,562l-11.5,27.1 c-1.5,3.6-2.2,7.4-2,11.1c0,0.2,0,0.5,0.1,0.7c0,0.3,0,0.5,0.1,0.8c0,0,0,0.1,0,0.1c0.1,0.4,0.1,0.9,0.2,1.3 c0.1,0.4,0.1,0.8,0.2,1.2c0,0.2,0.1,0.4,0.2,0.6c0.1,0.4,0.2,0.7,0.3,1c0.1,0.4,0.2,0.8,0.4,1.2c0,0.2,0.1,0.3,0.2,0.5 c0.1,0.4,0.3,0.8,0.5,1.1c0.2,0.4,0.3,0.7,0.5,1.1c0.1,0.2,0.2,0.5,0.4,0.7c0,0.1,0.1,0.2,0.1,0.3c0.2,0.3,0.3,0.6,0.5,0.8 c0.1,0.3,0.3,0.5,0.5,0.7c0.2,0.3,0.4,0.7,0.7,1c0.2,0.2,0.3,0.5,0.5,0.7c0.3,0.3,0.5,0.6,0.8,1c0.2,0.2,0.3,0.4,0.5,0.6 c0.1,0.1,0.1,0.1,0.2,0.2c0.1,0.1,0.1,0.1,0.2,0.2c0.1,0.1,0.1,0.1,0.1,0.1c0.7,0.7,1.4,1.4,2.2,2c0,0,0,0,0,0 c0.4,0.3,0.8,0.6,1.2,0.9c1.5,1.1,3.1,2,4.8,2.7l25,10.7l1.2,0.5l107.7,45.8c12.6,5.4,27.4-0.6,32.7-13.2l10.6-24.9 c5.4-12.6-0.6-27.3-13.2-32.7l-85.9-36.5l128.2-301.3c32.1-6,56.4-34.2,56.4-68C868,164,837,133,798.8,133z M826.1,227.7 c-6.8,7.3-16.5,11.8-27.3,11.8c-20.6,0-37.4-16.8-37.4-37.4c0-0.7,0-1.5,0.1-2.2v0c1.1-19.6,17.4-35.2,37.4-35.2 c20.6,0,37.4,16.8,37.4,37.4C836.3,212,832.4,221,826.1,227.7z"/>
+            </g>
+            <g>
+              <path d="M392.1,385.2c-1.9-1.6-4-2.9-6.3-3.8l-26-10.8l-0.3-0.1l-108.1-44.8c-12.7-5.3-27.4,0.8-32.6,13.5 l-10.4,25c-5.3,12.7,0.8,27.4,13.5,32.6l86.2,35.8L181.7,737.2c-28.7,8.4-49.7,35-49.7,66.4c0,38.1,31,69.2,69.2,69.2 c38.1,0,69.2-31,69.2-69.2c0-16.2-5.6-31.1-15-42.9l132.5-319.5c0.4-0.7,0.7-1.4,1-2.1l10.4-25C403.5,403.7,400.3,392,392.1,385.2 z M201.2,841c-20.6,0-37.4-16.8-37.4-37.4c0-7.6,2.3-14.6,6.1-20.5c6.7-10.2,18.2-16.9,31.3-16.9c19.3,0,35.2,14.7,37.2,33.5v0 c0.1,1.3,0.2,2.6,0.2,3.9C238.6,824.2,221.8,841,201.2,841z"/>
+            </g>
+            <g>
+              <path d="M795,736.3c-12.5,0-24.3,3.4-34.5,9.2L435.5,609l-27.1-11.4c-9.7-4-20.6-1.5-27.5,5.6 c-2.1,2.2-3.9,4.7-5.1,7.7L365,636.6L319.5,745c-5.3,12.7,0.7,27.4,13.3,32.7l24.9,10.5c12.7,5.3,27.4-0.7,32.7-13.3l36.2-86.1 l299.9,126c4.5,33.8,33.5,59.9,68.5,59.9c38.1,0,69.2-31,69.2-69.2C864.2,767.4,833.2,736.3,795,736.3z M795,842.9 c-11.3,0-21.4-5-28.2-12.9h0c-5.7-6.6-9.2-15.2-9.2-24.5c0-20.6,16.8-37.4,37.4-37.4c1.9,0,3.7,0.1,5.6,0.4 c18,2.7,31.9,18.3,31.9,37C832.5,826.1,815.7,842.9,795,842.9z"/>
+            </g>
+          </g>
+        </g>
+      </g>
+    </g>
+  </g>
+
+  <!-- Data Legion text — white for dark backgrounds -->
+  <text x="80" y="38" font-family="Inter, -apple-system, system-ui, Segoe UI, Roboto, Helvetica, Arial, sans-serif" font-size="24" font-weight="600" fill="#f8f8f8">Data Legion</text>
+
+  <!-- Enterprise Data Solutions tagline -->
+  <text x="80" y="58" font-family="Inter, -apple-system, system-ui, Segoe UI, Roboto, Helvetica, Arial, sans-serif" font-size="13" font-weight="500" fill="#d4af37">Enterprise Data Solutions</text>
+</svg>

datalegion-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,148 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint & Build
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 5
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.x"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --frozen --dev
+
+      - name: Run lint
+        run: uv run lint
+
+      - name: Build
+        run: uv build
+
+      - name: Prune uv cache
+        if: always()
+        run: uv cache prune --ci
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.x"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --frozen --dev
+
+      - name: Run tests
+        run: uv run pytest tests/ -v --tb=short
+        env:
+          DATALEGION_API_KEY: ${{ secrets.DATALEGION_API_KEY }}
+
+      - name: Prune uv cache
+        if: always()
+        run: uv cache prune --ci
+
+  publish-pypi:
+    name: Publish to PyPI
+    needs: [lint, test]
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 5
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.x"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Set version from tag
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          sed -i "s/^version = .*/version = \"${VERSION}\"/" pyproject.toml
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        run: uv publish --trusted-publishing always
+
+  github-release:
+    name: Create GitHub Release
+    needs: [publish-pypi]
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 5
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          ref: main
+          token: ${{ secrets.GH_PAT }}
+
+      - name: Update version in pyproject.toml
+        run: |
+          VERSION="${GITHUB_REF_NAME#v}"
+          sed -i "s/^version = .*/version = \"${VERSION}\"/" pyproject.toml
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git add pyproject.toml
+          git diff --staged --quiet || git commit -m "chore: bump version to ${VERSION} [skip ci]"
+          git push
+
+      - name: Create Release
+        uses: actions/github-script@v8
+        with:
+          script: |
+            const tag = context.ref.replace('refs/tags/', '');
+            await github.rest.repos.createRelease({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              tag_name: tag,
+              name: tag,
+              generate_release_notes: true,
+            });

datalegion-0.1.0/.github/workflows/security.yml

@@ -0,0 +1,73 @@
+name: Security
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  changes:
+    name: Check Changes
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    if: github.event.pull_request.draft != true
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      should_run: ${{ steps.filter.outputs.src }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            src:
+              - '**.py'
+              - 'pyproject.toml'
+              - 'uv.lock'
+              - '.github/workflows/**'
+
+  security:
+    name: Security Scan
+    needs: changes
+    if: needs.changes.outputs.should_run == 'true'
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 5
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.x"
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+          cache: "pip"
+
+      - name: Install security tools
+        run: pip install bandit pip-audit
+
+      - name: Run Bandit (SAST)
+        run: |
+          bandit -r src/ \
+            --severity-level high \
+            --confidence-level high
+
+      - name: Run pip-audit (dependency vulnerabilities)
+        run: |
+          uv export --format requirements-txt --no-hashes > requirements.txt
+          pip-audit -r requirements.txt --disable-pip --no-deps

datalegion-0.1.0/.github/workflows/test.yml

@@ -0,0 +1,109 @@
+name: Tests
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  changes:
+    name: Check Changes
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    if: github.event.pull_request.draft != true
+    permissions:
+      contents: read
+      pull-requests: read
+    outputs:
+      should_run: ${{ steps.filter.outputs.src }}
+    steps:
+      - uses: actions/checkout@v6
+      - uses: dorny/paths-filter@v3
+        id: filter
+        with:
+          filters: |
+            src:
+              - '**.py'
+              - 'pyproject.toml'
+              - 'uv.lock'
+              - '.github/workflows/**'
+
+  lint:
+    name: Lint & Build
+    needs: changes
+    if: needs.changes.outputs.should_run == 'true'
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 5
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.x"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --frozen --dev
+
+      - name: Run lint
+        run: uv run lint
+
+      - name: Build
+        run: uv build
+
+      - name: Prune uv cache
+        if: always()
+        run: uv cache prune --ci
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    needs: changes
+    if: needs.changes.outputs.should_run == 'true'
+    runs-on: blacksmith-2vcpu-ubuntu-2404
+    timeout-minutes: 10
+    permissions:
+      contents: read
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: "0.10.x"
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --frozen --dev
+
+      - name: Run tests
+        run: uv run pytest tests/ -v --tb=short
+        env:
+          DATALEGION_API_KEY: ${{ secrets.DATALEGION_API_KEY }}
+
+      - name: Prune uv cache
+        if: always()
+        run: uv cache prune --ci

datalegion-0.1.0/.gitignore

@@ -0,0 +1,14 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.eggs/
+dist/
+build/
+*.egg-info/
+*.egg
+.venv/
+.env
+*.whl
+.mypy_cache/
+.ruff_cache/

datalegion-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,9 @@
+repos:
+  - repo: local
+    hooks:
+      - id: lint
+        name: lint
+        entry: uv run lint
+        language: system
+        pass_filenames: false
+        always_run: true

datalegion-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,29 @@
+# Code of Conduct
+
+## Our Pledge
+
+We are committed to making participation in this project a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+
+Examples of unacceptable behavior:
+
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at **engineering@datalegion.ai**. All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.