intosql 0.1.0__tar.gz

intosql-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+dist/
+.coverage
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+__pycache__/

intosql-0.1.0/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 0.1.0
+
+- `convert` and `convert_url`, every conversion endpoint (`create`, `create_from_url`, `upload`, `start`, `retrieve`, `list`, `cancel`, `create_case`, `delete`, `wait`), `usage`, `spec`, `verify_webhook` and `parse_webhook`.
+- `IntoSQLError`, `ConversionFailedError`, `ConversionCanceledError` and `WebhookSignatureError`.
+- Retries for `rate_limited`, `too_many_active`, `request_in_progress`, 408, 425, 5xx and lost connections, with one `Idempotency-Key` per request; never `already_started`.

intosql-0.1.0/LICENSE

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

intosql-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.5
+Name: intosql
+Version: 0.1.0
+Summary: Convert spreadsheets, CSV and JSON into SQL with the IntoSQL API.
+Project-URL: Homepage, https://intosql.com/docs/sdks/python
+Project-URL: Documentation, https://intosql.com/docs/sdks/python
+Project-URL: Repository, https://github.com/alfonsobries/intosql
+Project-URL: Changelog, https://github.com/alfonsobries/intosql/blob/main/sdks/python/CHANGELOG.md
+Author-email: IntoSQL <hello@intosql.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: converter,csv,excel,mysql,postgresql,sql,sqlite,xlsx
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Database
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Requires-Dist: httpx<1,>=0.27
+Description-Content-Type: text/markdown
+
+# IntoSQL for Python
+
+Convert spreadsheets (XLSX, XLS, ODS), CSV and JSON into SQL for PostgreSQL, MySQL, MariaDB, SQLite, SQL Server or Oracle with the [IntoSQL API](https://intosql.com/developers). Column types are inferred and dirty values fixed, so the script loads on the first try.
+
+```sh
+pip install intosql
+```
+
+Python 3.9 or newer. The API is part of IntoSQL Pro; make a key in Settings, API keys.
+
+## Convert a file
+
+```python
+import os
+from intosql import IntoSQL, spec
+
+intosql = IntoSQL(os.environ["INTOSQL_API_KEY"])
+
+conversion = intosql.convert(
+    "ventas.xlsx",
+    name="ventas.xlsx",
+    spec=spec("postgresql", table="ventas"),
+)
+
+print(conversion["report"]["rows"]["converted"], conversion["output"]["url"])
+```
+
+The file streams to storage as it is; the output URL downloads the script for ten minutes. Read the conversion again (`intosql.conversions.retrieve(id)`) for a fresh one.
+
+## Convert a file by URL
+
+```python
+conversion = intosql.convert_url(
+    "https://example.com/exports/ventas.csv",
+    spec=spec("mysql"),
+)
+```
+
+## Check a webhook
+
+Save a webhook address in Settings, API keys, and IntoSQL calls it when a conversion is done, failed or canceled.
+
+```python
+from intosql import parse_webhook
+
+# Raises WebhookSignatureError when the signature doesn't match.
+event = parse_webhook(
+    request.get_data(),
+    request.headers.get("IntoSQL-Signature", ""),
+    os.environ["INTOSQL_WEBHOOK_SECRET"],
+)
+```
+
+## Errors and retries
+
+Failed requests raise `IntoSQLError` with the HTTP `status`, a `code` that doesn't change (`needs_pro`, `over_quota`, `too_big`, `invalid_spec`, `invalid_url` and more) and the `request_id`. A conversion that ends as failed raises `ConversionFailedError` with its `code` and the engine's `problems`. Rate limits, a full account, server errors and lost connections are retried twice with the same idempotency key (`max_retries` changes it); `already_started` never is.
+
+Every endpoint: [intosql.com/developers](https://intosql.com/developers). This SDK: [intosql.com/docs/sdks/python](https://intosql.com/docs/sdks/python).

intosql-0.1.0/README.md

@@ -0,0 +1,58 @@
+# IntoSQL for Python
+
+Convert spreadsheets (XLSX, XLS, ODS), CSV and JSON into SQL for PostgreSQL, MySQL, MariaDB, SQLite, SQL Server or Oracle with the [IntoSQL API](https://intosql.com/developers). Column types are inferred and dirty values fixed, so the script loads on the first try.
+
+```sh
+pip install intosql
+```
+
+Python 3.9 or newer. The API is part of IntoSQL Pro; make a key in Settings, API keys.
+
+## Convert a file
+
+```python
+import os
+from intosql import IntoSQL, spec
+
+intosql = IntoSQL(os.environ["INTOSQL_API_KEY"])
+
+conversion = intosql.convert(
+    "ventas.xlsx",
+    name="ventas.xlsx",
+    spec=spec("postgresql", table="ventas"),
+)
+
+print(conversion["report"]["rows"]["converted"], conversion["output"]["url"])
+```
+
+The file streams to storage as it is; the output URL downloads the script for ten minutes. Read the conversion again (`intosql.conversions.retrieve(id)`) for a fresh one.
+
+## Convert a file by URL
+
+```python
+conversion = intosql.convert_url(
+    "https://example.com/exports/ventas.csv",
+    spec=spec("mysql"),
+)
+```
+
+## Check a webhook
+
+Save a webhook address in Settings, API keys, and IntoSQL calls it when a conversion is done, failed or canceled.
+
+```python
+from intosql import parse_webhook
+
+# Raises WebhookSignatureError when the signature doesn't match.
+event = parse_webhook(
+    request.get_data(),
+    request.headers.get("IntoSQL-Signature", ""),
+    os.environ["INTOSQL_WEBHOOK_SECRET"],
+)
+```
+
+## Errors and retries
+
+Failed requests raise `IntoSQLError` with the HTTP `status`, a `code` that doesn't change (`needs_pro`, `over_quota`, `too_big`, `invalid_spec`, `invalid_url` and more) and the `request_id`. A conversion that ends as failed raises `ConversionFailedError` with its `code` and the engine's `problems`. Rate limits, a full account, server errors and lost connections are retried twice with the same idempotency key (`max_retries` changes it); `already_started` never is.
+
+Every endpoint: [intosql.com/developers](https://intosql.com/developers). This SDK: [intosql.com/docs/sdks/python](https://intosql.com/docs/sdks/python).

intosql-0.1.0/pyproject.toml

@@ -0,0 +1,97 @@
+[build-system]
+requires = ["hatchling>=1.25"]
+build-backend = "hatchling.build"
+
+[project]
+name = "intosql"
+dynamic = ["version"]
+description = "Convert spreadsheets, CSV and JSON into SQL with the IntoSQL API."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [{ name = "IntoSQL", email = "hello@intosql.com" }]
+keywords = [
+    "converter",
+    "csv",
+    "excel",
+    "mysql",
+    "postgresql",
+    "sql",
+    "sqlite",
+    "xlsx",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Database",
+    "Typing :: Typed",
+]
+dependencies = ["httpx>=0.27,<1"]
+
+[project.urls]
+Homepage = "https://intosql.com/docs/sdks/python"
+Documentation = "https://intosql.com/docs/sdks/python"
+Repository = "https://github.com/alfonsobries/intosql"
+Changelog = "https://github.com/alfonsobries/intosql/blob/main/sdks/python/CHANGELOG.md"
+
+[dependency-groups]
+dev = ["mypy>=1.13", "pytest>=8.3", "pytest-cov>=5", "ruff>=0.8"]
+
+[tool.hatch.version]
+path = "src/intosql/_version.py"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/intosql"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/intosql", "tests", "README.md", "CHANGELOG.md", "LICENSE"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["tests"]
+addopts = "--strict-markers"
+
+[tool.coverage.run]
+source = ["intosql"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 100
+
+[tool.mypy]
+strict = true
+python_version = "3.9"
+files = ["src", "tests"]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "W",
+    "F",
+    "I",
+    "B",
+    "UP",
+    "N",
+    "SIM",
+    "RUF",
+    "PT",
+    "C4",
+    "RET",
+    "PL",
+    "S",
+    "ANN",
+    "A",
+]
+ignore = ["PLR0913", "PLR2004", "PLR0911"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = ["S101", "S105", "S106", "ANN", "PLR2004"]

intosql-0.1.0/src/intosql/__init__.py

@@ -0,0 +1,103 @@
+"""Convert spreadsheets, CSV and JSON into SQL with the IntoSQL API."""
+
+from ._client import DEFAULT_BASE_URL, Conversions, IntoSQL, Upload
+from ._contract import (
+    CONTRACT_VERSION,
+    ColumnKind,
+    ColumnNames,
+    ColumnReport,
+    ColumnSpec,
+    DateOrder,
+    DetectedInput,
+    Dialect,
+    ErrorCode,
+    Fix,
+    FixCode,
+    InferenceSpec,
+    InputFormat,
+    InputSpec,
+    JobReport,
+    JobSpec,
+    OutputFormat,
+    OutputSpec,
+    OutputStyle,
+    Problem,
+    RowCounts,
+    Severity,
+    Timings,
+)
+from ._errors import (
+    ConversionCanceledError,
+    ConversionFailedError,
+    IntoSQLError,
+    WebhookSignatureError,
+)
+from ._spec import spec
+from ._types import (
+    Case,
+    Conversion,
+    ConversionErrorCode,
+    ConversionFailure,
+    ConversionOutput,
+    ConversionStatus,
+    ConversionUpload,
+    Page,
+    PageLinks,
+    PageMeta,
+    PingData,
+    Usage,
+    WebhookEvent,
+)
+from ._version import __version__
+from ._webhooks import parse_webhook, verify_webhook
+
+__all__ = [
+    "CONTRACT_VERSION",
+    "DEFAULT_BASE_URL",
+    "Case",
+    "ColumnKind",
+    "ColumnNames",
+    "ColumnReport",
+    "ColumnSpec",
+    "Conversion",
+    "ConversionCanceledError",
+    "ConversionErrorCode",
+    "ConversionFailedError",
+    "ConversionFailure",
+    "ConversionOutput",
+    "ConversionStatus",
+    "ConversionUpload",
+    "Conversions",
+    "DateOrder",
+    "DetectedInput",
+    "Dialect",
+    "ErrorCode",
+    "Fix",
+    "FixCode",
+    "InferenceSpec",
+    "InputFormat",
+    "InputSpec",
+    "IntoSQL",
+    "IntoSQLError",
+    "JobReport",
+    "JobSpec",
+    "OutputFormat",
+    "OutputSpec",
+    "OutputStyle",
+    "Page",
+    "PageLinks",
+    "PageMeta",
+    "PingData",
+    "Problem",
+    "RowCounts",
+    "Severity",
+    "Timings",
+    "Upload",
+    "Usage",
+    "WebhookEvent",
+    "WebhookSignatureError",
+    "__version__",
+    "parse_webhook",
+    "spec",
+    "verify_webhook",
+]