ingestr 0.13.39__tar.gz → 0.13.41__tar.gz

{ingestr-0.13.39 → ingestr-0.13.41}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ingestr
-Version: 0.13.39
+Version: 0.13.41
 Summary: ingestr is a command-line application that ingests data from various sources and stores them in any database.
 Project-URL: Homepage, https://github.com/bruin-data/ingestr
 Project-URL: Issues, https://github.com/bruin-data/ingestr/issues
@@ -50,6 +50,8 @@ Requires-Dist: dlt==1.10.0
 Requires-Dist: dnspython==2.7.0
 Requires-Dist: duckdb-engine==0.17.0
 Requires-Dist: duckdb==1.2.1
+Requires-Dist: elastic-transport==8.17.1
+Requires-Dist: elasticsearch==8.10.1
 Requires-Dist: et-xmlfile==2.0.0
 Requires-Dist: facebook-business==20.0.0
 Requires-Dist: filelock==3.17.0
@@ -70,11 +72,14 @@ Requires-Dist: google-auth==2.38.0
 Requires-Dist: google-cloud-bigquery-storage==2.24.0
 Requires-Dist: google-cloud-bigquery==3.30.0
 Requires-Dist: google-cloud-core==2.4.2
+Requires-Dist: google-cloud-spanner==3.54.0
 Requires-Dist: google-cloud-storage==3.1.0
 Requires-Dist: google-crc32c==1.6.0
 Requires-Dist: google-resumable-media==2.7.2
 Requires-Dist: googleapis-common-protos==1.69.0
 Requires-Dist: greenlet==3.2.2
+Requires-Dist: grpc-google-iam-v1==0.14.2
+Requires-Dist: grpc-interceptor==0.15.4
 Requires-Dist: grpcio-status==1.62.3
 Requires-Dist: grpcio==1.70.0
 Requires-Dist: hdbcli==2.23.27
@@ -166,9 +171,11 @@ Requires-Dist: soupsieve==2.6
 Requires-Dist: sqlalchemy-bigquery==1.12.1
 Requires-Dist: sqlalchemy-hana==2.0.0
 Requires-Dist: sqlalchemy-redshift==0.8.14
+Requires-Dist: sqlalchemy-spanner==1.11.0
 Requires-Dist: sqlalchemy2-stubs==0.0.2a38
 Requires-Dist: sqlalchemy==1.4.52
 Requires-Dist: sqlglot==26.12.1
+Requires-Dist: sqlparse==0.5.3
 Requires-Dist: stripe==10.7.0
 Requires-Dist: tenacity==9.0.0
 Requires-Dist: thrift==0.16.0

{ingestr-0.13.39 → ingestr-0.13.41}/docs/.vitepress/config.mjs

@@ -74,6 +74,7 @@ export default defineConfig({
               { text: "Databricks", link: "/supported-sources/databricks.md" },
               { text: "DuckDB", link: "/supported-sources/duckdb.md" },
               { text: "DynamoDB", link: "/supported-sources/dynamodb.md" },
+              { text: "Elasticsearch", link: "/supported-sources/elasticsearch.md" },
               {
                 text: "Google BigQuery",
                 link: "/supported-sources/bigquery.md",
@@ -137,6 +138,7 @@ export default defineConfig({
               { text: "Salesforce", link: "/supported-sources/salesforce.md" },
               { text: "Shopify", link: "/supported-sources/shopify.md" },
               { text: "Slack", link: "/supported-sources/slack.md" },
+              { text: "Spanner", link: "/supported-sources/spanner.md" },
               { text: "Stripe", link: "/supported-sources/stripe.md" },
               { text: "TikTok Ads", link: "/supported-sources/tiktok-ads.md" },
               { text: "Zendesk", link: "/supported-sources/zendesk.md" },

ingestr-0.13.41/docs/supported-sources/elasticsearch.md

@@ -0,0 +1,35 @@
+# Elasticsearch
+[Elasticsearch](https://www.elastic.co/elasticsearch) is a distributed, RESTful search and analytics engine designed for fast and scalable data retrieval.
+
+ingestr supports Elasticsearch as a source.
+
+## URI format
+The URI format for Elasticsearch is as follows:
+
+```plaintext
+elasticsearch://username:password@host:port?secure=<secure>&verify_certs=<verify_certs>
+```
+
+URI parameters:
+- `username`: The username used to authenticate with Elasticsearch.
+- `password`: The password associated with the specified username.
+- `host`: The host address of the Elasticsearch server.
+- `port`: The port number used by the Elasticsearch server.
+-  `secure`: Enables HTTPS when set to true. By default, it is true.
+- `verify_certs`: Verifies TLS certificates when set to true. By default, it is true.
+
+Source Table
+
+`<index-name>`: Fetches all available documents from the specified index.
+
+```ingestr ingest \
+    --source-uri "elasticsearch://elastic:changeme@localhost:9200?secure=false&verify_certs=false" \
+    --source-table 'test-index' \
+    --dest-uri "duckdb:///users.duckdb" \
+    --dest-table 'dest.users_detail'
+```
+
+This command retrieves all documents from the test-index in Elasticsearch and copy them to the dest.users_detail table in DuckDB.
+
+<img alt="ingestion_elasticsearch_img" src="../media/ingestion_elasticsearch_img.png" />
+

ingestr-0.13.41/docs/supported-sources/spanner.md

@@ -0,0 +1,41 @@
+# Spanner
+[Spanner](https://cloud.google.com/spanner) is a fully managed, scalable, and strongly consistent database service.
+
+ingestr supports Spanner as a source.
+
+## URI format
+The URI format for Spanner is as follows:
+
+
+```plaintext
+spanner://?project_id=<project_id>&instance_id=<instance_id>&database=<database>&credentials_path=</path/to/service/account.json>
+```
+or
+```plaintext
+spanner://?project_id=<project_id>&instance_id=<instance_id>&database=<database>&credentials_base64=<base64_encoded_credentials>
+```
+
+URI parameters:
+- `project_id`: Your Google Cloud project ID (e.g., "my-project-123")
+- `instance_id`: The Spanner instance ID (e.g., "my-instance")
+- `database`: The database name (e.g., "my-database")
+- `credentials_path`: Path to your Google Cloud service account JSON file
+- `credentials_base64`: Base64-encoded service account credentials (alternative to credentials_path)
+
+Let's say we have the above credentials. Here's a sample command that will copy the data from Spanner (GoogleSQL) to DuckDB.
+
+```sh
+ingestr ingest \
+  --source-uri 'spanner://?project_id=id_123&instance_id=instance_123&database=db_123&credentials_path=./service_account.json' \
+  --source-table 'users' \
+  --dest-uri duckdb:///spanner.duckdb \
+  --dest-table 'dest.output'
+
+```
+
+<img alt="pipedrive_img" src="../media/spanner_ingestion.png"/>
+
+> [!NOTE]
+> Currently, only GoogleSQL databases are supported.
+
+

ingestr-0.13.41/ingestr/src/buildinfo.py

@@ -0,0 +1 @@
+version = "v0.13.41"

ingestr-0.13.41/ingestr/src/elasticsearch/__init__.py

@@ -0,0 +1,80 @@
+from datetime import date, datetime
+from typing import Any, Optional
+
+import dlt
+import pendulum
+from dlt.common.time import ensure_pendulum_datetime
+from pendulum import parse
+
+from elasticsearch import Elasticsearch
+
+
+@dlt.source
+def elasticsearch_source(
+    connection_url: str,
+    index: str,
+    verify_certs: bool,
+    incremental: Optional[dlt.sources.incremental] = None,
+):
+    client = Elasticsearch(connection_url, verify_certs=verify_certs)
+
+    @dlt.resource(
+        name=index, primary_key="id", write_disposition="merge", incremental=incremental
+    )
+    def get_documents(incremental=incremental):
+        body = {"query": {"match_all": {}}}
+
+        if incremental:
+            start_value = incremental.last_value
+            range_filter = {"gte": start_value}
+            if incremental.end_value is not None:
+                range_filter["lt"] = incremental.end_value
+            body = {"query": {"range": {incremental.cursor_path: range_filter}}}
+
+        page = client.search(index=index, scroll="5m", size=5, body=body)
+
+        sid = page["_scroll_id"]
+        hits = page["hits"]["hits"]
+
+        if not hits:
+            return
+
+        # fetching first page (via .search)
+        for doc in hits:
+            doc_data = {"id": doc["_id"], **doc["_source"]}
+            if incremental:
+                doc_data[incremental.cursor_path] = convert_elasticsearch_objs(
+                    doc_data[incremental.cursor_path]
+                )
+            yield doc_data
+
+        while True:
+            # fetching page 2 and other pages (via .scroll)
+            page = client.scroll(scroll_id=sid, scroll="5m")
+            sid = page["_scroll_id"]
+            hits = page["hits"]["hits"]
+            if not hits:
+                break
+            for doc in hits:
+                doc_data = {"id": doc["_id"], **doc["_source"]}
+                if incremental:
+                    doc_data[incremental.cursor_path] = convert_elasticsearch_objs(
+                        doc_data[incremental.cursor_path]
+                    )
+                yield doc_data
+
+        client.clear_scroll(scroll_id=sid)
+
+    return get_documents
+
+
+def convert_elasticsearch_objs(value: Any) -> Any:
+    if isinstance(value, str):
+        parsed_date = parse(value, strict=False)
+        if parsed_date is not None:
+            if isinstance(
+                parsed_date,
+                (pendulum.DateTime, pendulum.Date, datetime, date, str, float, int),
+            ):
+                return ensure_pendulum_datetime(parsed_date)
+    return value

{ingestr-0.13.39 → ingestr-0.13.41}/ingestr/src/factory.py

@@ -28,6 +28,7 @@ from ingestr.src.sources import (
     AsanaSource,
     ChessSource,
     DynamoDBSource,
+    ElasticsearchSource,
     FacebookAdsSource,
     FrankfurterSource,
     FreshdeskSource,
@@ -78,6 +79,7 @@ SQL_SOURCE_SCHEMES = [
     "clickhouse",
     "databricks",
     "db2",
+    "spanner",
 ]
 
 
@@ -153,6 +155,7 @@ class SourceDestinationFactory:
         "frankfurter": FrankfurterSource,
         "freshdesk": FreshdeskSource,
         "phantombuster": PhantombusterSource,
+        "elasticsearch": ElasticsearchSource,
     }
     destinations: Dict[str, Type[DestinationProtocol]] = {
         "bigquery": BigQueryDestination,

{ingestr-0.13.39 → ingestr-0.13.41}/ingestr/src/sources.py

@@ -52,7 +52,10 @@ class SqlSource:
     def dlt_source(self, uri: str, table: str, **kwargs):
         table_fields = TableDefinition(dataset="custom", table="custom")
         if not table.startswith("query:"):
-            table_fields = table_string_to_dataclass(table)
+            if uri.startswith("spanner://"):
+                table_fields = TableDefinition(dataset="", table=table)
+            else:
+                table_fields = table_string_to_dataclass(table)
 
         incremental = None
         if kwargs.get("incremental_key"):
@@ -113,6 +116,45 @@ class SqlSource:
         if uri.startswith("db2://"):
             uri = uri.replace("db2://", "db2+ibm_db://")
 
+        if uri.startswith("spanner://"):
+            parsed_uri = urlparse(uri)
+            query_params = parse_qs(parsed_uri.query)
+
+            project_id_param = query_params.get("project_id")
+            instance_id_param = query_params.get("instance_id")
+            database_param = query_params.get("database")
+
+            cred_path = query_params.get("credentials_path")
+            cred_base64 = query_params.get("credentials_base64")
+
+            if not project_id_param or not instance_id_param or not database_param:
+                raise ValueError(
+                    "project_id, instance_id and database are required in the URI to get data from Google Spanner"
+                )
+
+            project_id = project_id_param[0]
+            instance_id = instance_id_param[0]
+            database = database_param[0]
+
+            if not cred_path and not cred_base64:
+                raise ValueError(
+                    "credentials_path or credentials_base64 is required in the URI to get data from Google Sheets"
+                )
+            if cred_path:
+                os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = cred_path[0]
+            elif cred_base64:
+                credentials = json.loads(
+                    base64.b64decode(cred_base64[0]).decode("utf-8")
+                )
+                temp = tempfile.NamedTemporaryFile(
+                    mode="w", delete=False, suffix=".json"
+                )
+                json.dump(credentials, temp)
+                temp.close()
+                os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = temp.name
+
+            uri = f"spanner+spanner:///projects/{project_id}/instances/{instance_id}/databases/{database}"
+
         from dlt.common.libs.sql_alchemy import (
             Engine,
             MetaData,
@@ -2298,3 +2340,55 @@ class PhantombusterSource:
             start_date=start_date,
             end_date=end_date,
         ).with_resources(table_name)
+
+
+class ElasticsearchSource:
+    def handles_incrementality(self) -> bool:
+        return False
+
+    def dlt_source(self, uri: str, table: str, **kwargs):
+        from ingestr.src.elasticsearch import elasticsearch_source
+
+        incremental = None
+        if kwargs.get("incremental_key"):
+            start_value = kwargs.get("interval_start")
+            end_value = kwargs.get("interval_end")
+
+            incremental = dlt_incremental(
+                kwargs.get("incremental_key", ""),
+                initial_value=start_value,
+                end_value=end_value,
+                range_end="closed",
+                range_start="closed",
+            )
+
+        # elasticsearch://localhost:9200?secure=true&verify_certs=false
+        parsed = urlparse(uri)
+
+        index = table
+        if not index:
+            raise ValueError(
+                "Table name must be provided which is the index name in elasticsearch"
+            )
+
+        query_params = parsed.query
+        params = parse_qs(query_params)
+
+        secure = True
+        if "secure" in params:
+            secure = params["secure"][0].capitalize() == "True"
+
+        verify_certs = True
+        if "verify_certs" in params:
+            verify_certs = params["verify_certs"][0].capitalize() == "True"
+
+        scheme = "https" if secure else "http"
+        netloc = parsed.netloc
+        connection_url = f"{scheme}://{netloc}"
+
+        return elasticsearch_source(
+            connection_url=connection_url,
+            index=index,
+            verify_certs=verify_certs,
+            incremental=incremental,
+        ).with_resources(table)

{ingestr-0.13.39 → ingestr-0.13.41}/requirements.in

@@ -48,4 +48,7 @@ clickhouse-sqlalchemy==0.2.7
 zstd==1.5.6.5
 ibm-db==3.2.6; platform_machine != "aarch64"
 ibm-db-sa==0.4.1; platform_machine != "aarch64"
-aiohttp>=3.11.15
+aiohttp>=3.11.15
+elasticsearch==8.10.1
+sqlalchemy-spanner==1.11.0
+google-cloud-spanner==3.54.0

{ingestr-0.13.39 → ingestr-0.13.41}/requirements.txt

@@ -16,7 +16,9 @@ aioitertools==0.12.0
 aiosignal==1.3.2
     # via aiohttp
 alembic==1.15.1
-    # via databricks-sql-connector
+    # via
+    #   databricks-sql-connector
+    #   sqlalchemy-spanner
 annotated-types==0.7.0
     # via pydantic
 asana==3.2.3
@@ -51,6 +53,7 @@ cachetools==5.5.2
 certifi==2025.1.31
     # via
     #   clickhouse-connect
+    #   elastic-transport
     #   requests
     #   snowflake-connector-python
 cffi==1.17.1
@@ -104,6 +107,10 @@ duckdb==1.2.1
     #   duckdb-engine
 duckdb-engine==0.17.0
     # via -r requirements.in
+elastic-transport==8.17.1
+    # via elasticsearch
+elasticsearch==8.10.1
+    # via -r requirements.in
 et-xmlfile==2.0.0
     # via openpyxl
 facebook-business==20.0.0
@@ -142,6 +149,7 @@ google-api-core==2.24.1
     #   google-cloud-bigquery
     #   google-cloud-bigquery-storage
     #   google-cloud-core
+    #   google-cloud-spanner
     #   google-cloud-storage
     #   sqlalchemy-bigquery
 google-api-python-client==2.130.0
@@ -171,7 +179,12 @@ google-cloud-bigquery-storage==2.24.0
 google-cloud-core==2.4.2
     # via
     #   google-cloud-bigquery
+    #   google-cloud-spanner
     #   google-cloud-storage
+google-cloud-spanner==3.54.0
+    # via
+    #   -r requirements.in
+    #   sqlalchemy-spanner
 google-cloud-storage==3.1.0
     # via gcsfs
 google-crc32c==1.6.0
@@ -186,13 +199,21 @@ googleapis-common-protos==1.69.0
     # via
     #   google-ads
     #   google-api-core
+    #   grpc-google-iam-v1
     #   grpcio-status
 greenlet==3.2.2
     # via sqlalchemy
+grpc-google-iam-v1==0.14.2
+    # via google-cloud-spanner
+grpc-interceptor==0.15.4
+    # via google-cloud-spanner
 grpcio==1.70.0
     # via
     #   google-ads
     #   google-api-core
+    #   googleapis-common-protos
+    #   grpc-google-iam-v1
+    #   grpc-interceptor
     #   grpcio-status
 grpcio-status==1.62.3
     # via
@@ -316,13 +337,16 @@ proto-plus==1.26.0
     #   google-analytics-data
     #   google-api-core
     #   google-cloud-bigquery-storage
+    #   google-cloud-spanner
 protobuf==4.25.6
     # via
     #   google-ads
     #   google-analytics-data
     #   google-api-core
     #   google-cloud-bigquery-storage
+    #   google-cloud-spanner
     #   googleapis-common-protos
+    #   grpc-google-iam-v1
     #   grpcio-status
     #   proto-plus
 psutil==6.1.1
@@ -488,16 +512,21 @@ sqlalchemy==1.4.52
     #   sqlalchemy-bigquery
     #   sqlalchemy-hana
     #   sqlalchemy-redshift
+    #   sqlalchemy-spanner
 sqlalchemy-bigquery==1.12.1
     # via -r requirements.in
 sqlalchemy-hana==2.0.0
     # via -r requirements.in
 sqlalchemy-redshift==0.8.14
     # via -r requirements.in
+sqlalchemy-spanner==1.11.0
+    # via -r requirements.in
 sqlalchemy2-stubs==0.0.2a38
     # via -r requirements.in
 sqlglot==26.12.1
     # via dlt
+sqlparse==0.5.3
+    # via google-cloud-spanner
 stripe==10.7.0
     # via -r requirements.in
 tenacity==9.0.0
@@ -553,6 +582,7 @@ urllib3==2.3.0
     #   botocore
     #   clickhouse-connect
     #   databricks-sql-connector
+    #   elastic-transport
     #   pyairtable
     #   requests
     #   types-requests

{ingestr-0.13.39 → ingestr-0.13.41}/requirements_arm64.txt

@@ -16,7 +16,9 @@ aioitertools==0.12.0
 aiosignal==1.3.2
     # via aiohttp
 alembic==1.15.2
-    # via databricks-sql-connector
+    # via
+    #   databricks-sql-connector
+    #   sqlalchemy-spanner
 annotated-types==0.7.0
     # via pydantic
 asana==3.2.3
@@ -51,6 +53,7 @@ cachetools==5.5.2
 certifi==2025.1.31
     # via
     #   clickhouse-connect
+    #   elastic-transport
     #   requests
     #   snowflake-connector-python
 cffi==1.17.1
@@ -104,6 +107,10 @@ duckdb==1.2.1
     #   duckdb-engine
 duckdb-engine==0.17.0
     # via -r requirements.in
+elastic-transport==8.17.1
+    # via elasticsearch
+elasticsearch==8.10.1
+    # via -r requirements.in
 et-xmlfile==2.0.0
     # via openpyxl
 facebook-business==20.0.0
@@ -142,6 +149,7 @@ google-api-core==2.24.2
     #   google-cloud-bigquery
     #   google-cloud-bigquery-storage
     #   google-cloud-core
+    #   google-cloud-spanner
     #   google-cloud-storage
     #   sqlalchemy-bigquery
 google-api-python-client==2.130.0
@@ -171,7 +179,12 @@ google-cloud-bigquery-storage==2.24.0
 google-cloud-core==2.4.3
     # via
     #   google-cloud-bigquery
+    #   google-cloud-spanner
     #   google-cloud-storage
+google-cloud-spanner==3.54.0
+    # via
+    #   -r requirements.in
+    #   sqlalchemy-spanner
 google-cloud-storage==3.1.0
     # via gcsfs
 google-crc32c==1.7.1
@@ -186,13 +199,21 @@ googleapis-common-protos==1.69.2
     # via
     #   google-ads
     #   google-api-core
+    #   grpc-google-iam-v1
     #   grpcio-status
 greenlet==3.1.1
     # via sqlalchemy
+grpc-google-iam-v1==0.14.2
+    # via google-cloud-spanner
+grpc-interceptor==0.15.4
+    # via google-cloud-spanner
 grpcio==1.71.0
     # via
     #   google-ads
     #   google-api-core
+    #   googleapis-common-protos
+    #   grpc-google-iam-v1
+    #   grpc-interceptor
     #   grpcio-status
 grpcio-status==1.62.3
     # via
@@ -310,13 +331,16 @@ proto-plus==1.26.1
     #   google-analytics-data
     #   google-api-core
     #   google-cloud-bigquery-storage
+    #   google-cloud-spanner
 protobuf==4.25.6
     # via
     #   google-ads
     #   google-analytics-data
     #   google-api-core
     #   google-cloud-bigquery-storage
+    #   google-cloud-spanner
     #   googleapis-common-protos
+    #   grpc-google-iam-v1
     #   grpcio-status
     #   proto-plus
 psutil==6.1.1
@@ -481,16 +505,21 @@ sqlalchemy==1.4.52
     #   sqlalchemy-bigquery
     #   sqlalchemy-hana
     #   sqlalchemy-redshift
+    #   sqlalchemy-spanner
 sqlalchemy-bigquery==1.12.1
     # via -r requirements.in
 sqlalchemy-hana==2.0.0
     # via -r requirements.in
 sqlalchemy-redshift==0.8.14
     # via -r requirements.in
+sqlalchemy-spanner==1.11.0
+    # via -r requirements.in
 sqlalchemy2-stubs==0.0.2a38
     # via -r requirements.in
 sqlglot==26.12.1
     # via dlt
+sqlparse==0.5.3
+    # via google-cloud-spanner
 stripe==10.7.0
     # via -r requirements.in
 tenacity==9.0.0
@@ -549,6 +578,7 @@ urllib3==2.3.0
     #   botocore
     #   clickhouse-connect
     #   databricks-sql-connector
+    #   elastic-transport
     #   pyairtable
     #   requests
     #   types-requests

ingestr-0.13.39/ingestr/src/buildinfo.py

@@ -1 +0,0 @@
-version = "v0.13.39"