ingestr 0.14.5__tar.gz → 0.14.6__tar.gz

{ingestr-0.14.5 → ingestr-0.14.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ingestr
-Version: 0.14.5
+Version: 0.14.6
 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

{ingestr-0.14.5 → ingestr-0.14.6}/docs/.vitepress/config.mjs

@@ -19,18 +19,17 @@ export default defineConfig({
   head: [
     [
       "script",
-      {
-        async: "",
-        src: "https://www.googletagmanager.com/gtag/js?id=G-MZJ20PP4MJ",
-      },
+      {},
+      `(function(w,d,s,l,i){w[l]=w[l]||[];w[l].push({'gtm.start':
+new Date().getTime(),event:'gtm.js'});var f=d.getElementsByTagName(s)[0],
+j=d.createElement(s),dl=l!='dataLayer'?'&l='+l:'';j.async=true;j.src=
+'https://www.googletagmanager.com/gtm.js?id='+i+dl;f.parentNode.insertBefore(j,f);
+})(window,document,'script','dataLayer','GTM-K2L7S5FP');`,
     ],
     [
-      "script",
+      "noscript",
       {},
-      `window.dataLayer = window.dataLayer || [];
-      function gtag(){dataLayer.push(arguments);}
-      gtag('js', new Date());
-      gtag('config', 'G-MZJ20PP4MJ');`,
+      `<iframe src="https://www.googletagmanager.com/ns.html?id=GTM-K2L7S5FP" height="0" width="0" style="display:none;visibility:hidden"></iframe>`,
     ],
   ],
   themeConfig: {
@@ -157,6 +156,7 @@ export default defineConfig({
               { text: "Linear", link: "/supported-sources/linear.md" },
               { text: "LinkedIn Ads", link: "/supported-sources/linkedin_ads.md" },
               { text: "Mixpanel", link: "/supported-sources/mixpanel.md" },
+              { text: "Monday", link: "/supported-sources/monday.md" },
               { text: "Notion", link: "/supported-sources/notion.md" },
               { text: "Personio", link: "/supported-sources/personio.md" },
               { text: "PhantomBuster", link: "/supported-sources/phantombuster.md" },

ingestr-0.14.6/docs/supported-sources/http.md

@@ -0,0 +1,111 @@
+# HTTP
+
+ingestr supports reading CSV, JSON, and Parquet files from public HTTP/HTTPS URLs. This allows you to ingest data from publicly accessible file URLs directly into your databases.
+
+## URI format
+
+The URI format for HTTP sources is as follows:
+
+```plaintext
+http://example.com/path/to/file.csv
+https://example.com/path/to/file.json
+https://example.com/path/to/file.parquet
+```
+
+## Supported file formats
+
+The HTTP source supports the following file formats:
+
+- **CSV** (`.csv`) - Comma-separated values files
+- **JSON** (`.json`, `.jsonl`) - JSON objects and JSON Lines format
+- **Parquet** (`.parquet`) - Apache Parquet columnar format
+
+The file format is automatically inferred from the URL extension. You can also explicitly specify the format using the `file_format` parameter.
+
+## Usage
+
+### Basic example
+
+```bash
+ingestr ingest \
+    --source-uri "https://example.com/data.csv" \
+    --dest-uri "duckdb:///local.duckdb" \
+    --dest-table "my_table"
+```
+
+### Example with Phantombuster CSV
+
+```bash
+ingestr ingest \
+    --source-uri "https://phantombuster.s3.amazonaws.com/hNQdB02WKv0/l7xqy7HlU0wyWIvPjqKk5Q/dts_size.csv" \
+    --dest-uri "postgres://user:pass@localhost:5432/mydb" \
+    --dest-table "phantombuster_data"
+```
+
+### Example with JSON file
+
+```bash
+ingestr ingest \
+    --source-uri "https://api.example.com/export/data.json" \
+    --dest-uri "snowflake://user:pass@account/database/schema" \
+    --dest-table "json_data"
+```
+
+### Example with Parquet file
+
+```bash
+ingestr ingest \
+    --source-uri "https://storage.example.com/data.parquet" \
+    --dest-uri "bigquery://project/dataset" \
+    --dest-table "parquet_data"
+```
+
+## Parameters
+
+### `file_format`
+
+Optional. Explicitly specify the file format if it cannot be inferred from the URL extension.
+
+**Valid values:** `csv`, `json`, `parquet`
+
+**Example:**
+
+```bash
+ingestr ingest \
+    --source-uri "https://example.com/data?format=csv" \
+    --source-file-format "csv" \
+    --dest-uri "duckdb:///local.duckdb" \
+    --dest-table "my_table"
+```
+
+### `chunksize`
+
+Optional. Number of records to process at once. This helps manage memory usage for large files.
+
+**Default values:**
+- CSV: 10,000 rows
+- JSON: 1,000 objects
+- Parquet: 10,000 rows
+
+**Example:**
+
+```bash
+ingestr ingest \
+    --source-uri "https://example.com/large-file.csv" \
+    --source-chunksize 5000 \
+    --dest-uri "postgres://user:pass@localhost:5432/mydb" \
+    --dest-table "chunked_data"
+```
+
+## Notes
+
+- The HTTP source downloads the entire file before processing, so ensure you have sufficient memory for large files
+- Authentication is not currently supported; only publicly accessible URLs can be used
+- The file must be accessible without requiring cookies, headers, or other authentication mechanisms
+- For very large files, consider using chunked transfer or a dedicated file storage source (e.g., S3, GCS)
+
+## Limitations
+
+- Only supports public URLs (no authentication)
+- The entire file is downloaded into memory before processing
+- No support for incremental loading

ingestr-0.14.6/docs/supported-sources/monday.md

@@ -0,0 +1,59 @@
+# Monday.com
+[Monday.com](https://monday.com/) is a Work OS that powers teams to run projects and workflows with confidence. It's a simple, yet powerful platform that enables people to manage work, meet deadlines, and build a culture of transparency.
+
+## URI format
+
+The URI format for Monday.com is as follows:
+```
+monday://?api_token=<api_token>
+```
+
+URI parameters:
+- `api_token` is your Monday.com API token for authentication.
+
+## Setting up a Monday.com Integration
+
+You can obtain an API token from the [Monday.com Developer Console](https://developer.monday.com/). For more information, see [Monday.com authentication documentation](https://developer.monday.com/api-reference/docs/authentication).
+
+To get your API token:
+1. Go to your Monday.com account
+2. Click on your profile picture in the top right corner
+3. Select "Admin" → "API"
+4. Generate a new API token
+
+## Example
+Let's say you want to ingest all boards into a DuckDB database called `monday.db`. For this example the value of `api_token` will be `fake_token`.
+
+You can run the following to achieve this:
+```sh
+ingestr ingest \
+  --source-uri "monday://?api_token=fake_token" \
+  --source-table "boards" \
+  --dest-uri "duckdb://./monday.db" \
+  --dest-table "public.boards"
+```
+
+## Tables
+
+Monday.com source allows ingesting the following resources into separate tables:
+
+| Table | Primary/Merge Key | Inc Key | Inc Strategy | Details |
+|-------|-------------------|---------|--------------|---------|
+| `account` | - | - | replace | Account information including name, slug, tier, and plan details. Full reload on each run. |
+| `account_roles` | - | - | replace | Account roles with their types and permissions. Full reload on each run. |
+| `users` | - | - | replace | Users in your Monday.com account with their profiles and permissions. Full reload on each run. |
+| `boards` | id | updated_at | merge | Boards with their metadata, state, and configuration. Incrementally loads only updated boards. |
+| `workspaces` | - | - | replace | Workspaces containing boards and their settings. Full reload on each run. |
+| `webhooks` | - | - | replace | Webhooks configured for boards with their events and configurations. Full reload on each run. |
+| `updates` | id | updated_at | merge | Updates (comments) on items with their content and metadata. Incrementally loads only updated entries. |
+| `teams` | - | - | replace | Teams in your account with their members. Full reload on each run. |
+| `tags` | - | - | replace | Tags used across your account for organizing items. Full reload on each run. |
+| `custom_activities` | - | - | replace | Custom activity types defined in your account. Full reload on each run. |
+| `board_columns` | - | - | replace | Columns defined in all boards with their types and settings. Full reload on each run. |
+| `board_views` | - | - | replace | Views configured for boards with their filters and settings. Full reload on each run. |
+
+Use these as `--source-table` parameter in the `ingestr ingest` command.
+
+> [!NOTE]
+> Monday.com has rate limits for API requests. The source handles pagination automatically and respects the API's maximum page size of 100 items.
+

ingestr-0.14.6/ingestr/src/buildinfo.py

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

{ingestr-0.14.5 → ingestr-0.14.6}/ingestr/src/factory.py

@@ -52,6 +52,7 @@ from ingestr.src.sources import (
     GoogleAnalyticsSource,
     GoogleSheetsSource,
     GorgiasSource,
+    HttpSource,
     HubspotSource,
     InfluxDBSource,
     IntercomSource,
@@ -64,6 +65,7 @@ from ingestr.src.sources import (
     LinkedInAdsSource,
     LocalCsvSource,
     MixpanelSource,
+    MondaySource,
     MongoDbSource,
     NotionSource,
     PersonioSource,
@@ -156,6 +158,8 @@ class SourceDestinationFactory:
         "anthropic": AnthropicSource,
         "csv": LocalCsvSource,
         "docebo": DoceboSource,
+        "http": HttpSource,
+        "https": HttpSource,
         "mongodb": MongoDbSource,
         "mongodb+srv": MongoDbSource,
         "notion": NotionSource,
@@ -214,6 +218,7 @@ class SourceDestinationFactory:
         "influxdb": InfluxDBSource,
         "wise": WiseSource,
         "plusvibeai": PlusVibeAISource,
+        "monday": MondaySource,
     }
     destinations: Dict[str, Type[DestinationProtocol]] = {
         "bigquery": BigQueryDestination,

ingestr-0.14.6/ingestr/src/http/__init__.py

@@ -0,0 +1,35 @@
+"""HTTP source for reading CSV, JSON, and Parquet files from public URLs"""
+
+from typing import Any, Optional
+
+import dlt
+from dlt.sources import DltResource
+
+from .readers import HttpReader
+
+
+@dlt.source
+def http_source(
+    url: str,
+    file_format: Optional[str] = None,
+    **kwargs: Any,
+) -> DltResource:
+    """Source for reading files from HTTP URLs.
+
+    Supports CSV, JSON, and Parquet file formats.
+
+    Args:
+        url (str): The HTTP(S) URL to the file
+        file_format (str, optional): File format ('csv', 'json', 'parquet').
+            If not provided, will be inferred from URL extension.
+        **kwargs: Additional arguments passed to the reader functions
+
+    Returns:
+        DltResource: A dlt resource that yields the file data
+    """
+    reader = HttpReader(url, file_format)
+
+    return dlt.resource(
+        reader.read_file(**kwargs),
+        name="http_data",
+    )

ingestr-0.14.6/ingestr/src/http/readers.py

@@ -0,0 +1,114 @@
+"""Readers for HTTP file sources"""
+
+import io
+from typing import Any, Iterator, Optional
+from urllib.parse import urlparse
+
+import requests
+from dlt.sources import TDataItems
+
+
+class HttpReader:
+    """Reader for HTTP-based file sources"""
+
+    def __init__(self, url: str, file_format: Optional[str] = None):
+        self.url = url
+        self.file_format = file_format or self._infer_format(url)
+
+        if self.file_format not in ["csv", "json", "parquet"]:
+            raise ValueError(
+                f"Unsupported file format: {self.file_format}. "
+                "Supported formats: csv, json, parquet"
+            )
+
+    def _infer_format(self, url: str) -> str:
+        """Infer file format from URL extension"""
+        parsed = urlparse(url)
+        path = parsed.path.lower()
+
+        if path.endswith(".csv"):
+            return "csv"
+        elif path.endswith(".json") or path.endswith(".jsonl"):
+            return "json"
+        elif path.endswith(".parquet"):
+            return "parquet"
+        else:
+            raise ValueError(
+                f"Cannot infer file format from URL: {url}. "
+                "Please specify file_format parameter."
+            )
+
+    def _download_file(self) -> bytes:
+        """Download file from URL"""
+        response = requests.get(self.url, stream=True, timeout=30)
+        response.raise_for_status()
+        return response.content
+
+    def read_file(self, **kwargs: Any) -> Iterator[TDataItems]:
+        """Read file and yield data in chunks"""
+        content = self._download_file()
+
+        if self.file_format == "csv":
+            yield from self._read_csv(content, **kwargs)
+        elif self.file_format == "json":
+            yield from self._read_json(content, **kwargs)
+        elif self.file_format == "parquet":
+            yield from self._read_parquet(content, **kwargs)
+
+    def _read_csv(
+        self, content: bytes, chunksize: int = 10000, **pandas_kwargs: Any
+    ) -> Iterator[TDataItems]:
+        """Read CSV file with Pandas chunk by chunk"""
+        import pandas as pd  # type: ignore
+
+        kwargs = {**{"header": "infer", "chunksize": chunksize}, **pandas_kwargs}
+
+        file_obj = io.BytesIO(content)
+        for df in pd.read_csv(file_obj, **kwargs):
+            yield df.to_dict(orient="records")
+
+    def _read_json(
+        self, content: bytes, chunksize: int = 1000, **kwargs: Any
+    ) -> Iterator[TDataItems]:
+        """Read JSON or JSONL file"""
+        from dlt.common import json
+
+        file_obj = io.BytesIO(content)
+        text = file_obj.read().decode("utf-8")
+
+        # Try to detect if it's JSONL format (one JSON object per line)
+        lines = text.strip().split("\n")
+
+        if len(lines) > 1:
+            # Likely JSONL format
+            lines_chunk = []
+            for line in lines:
+                if line.strip():
+                    lines_chunk.append(json.loads(line))
+                    if len(lines_chunk) >= chunksize:
+                        yield lines_chunk
+                        lines_chunk = []
+            if lines_chunk:
+                yield lines_chunk
+        else:
+            # Single JSON object or array
+            data = json.loads(text)
+            if isinstance(data, list):
+                # Chunk the list
+                for i in range(0, len(data), chunksize):
+                    yield data[i : i + chunksize]
+            else:
+                # Single object
+                yield [data]
+
+    def _read_parquet(
+        self, content: bytes, chunksize: int = 10000, **kwargs: Any
+    ) -> Iterator[TDataItems]:
+        """Read Parquet file"""
+        from pyarrow import parquet as pq  # type: ignore
+
+        file_obj = io.BytesIO(content)
+        parquet_file = pq.ParquetFile(file_obj)
+
+        for batch in parquet_file.iter_batches(batch_size=chunksize):
+            yield batch.to_pylist()

ingestr-0.14.6/ingestr/src/monday/__init__.py

@@ -0,0 +1,246 @@
+"""
+Monday.com source for data extraction via GraphQL API.
+
+This source provides access to Monday.com app installation data.
+"""
+
+from typing import Any, Iterable, Iterator, Optional
+
+import dlt
+from dlt.sources import DltResource
+
+from .helpers import MondayClient, normalize_dict
+
+
+@dlt.source(max_table_nesting=0, name="monday_source")
+def monday_source(
+    api_token: str,
+    params: list[str],
+    start_date: Optional[str] = None,
+    end_date: Optional[str] = None,
+) -> Iterable[DltResource]:
+    """
+    Monday.com data source.
+
+    Args:
+        api_token: Monday.com API token for authentication
+        params: Table-specific parameters in format [table_type, ...params]
+        start_date: Optional start date for date-filtered queries (YYYY-MM-DD)
+        end_date: Optional end date for date-filtered queries (YYYY-MM-DD)
+
+    Yields:
+        DltResource: Data resource for the requested table
+    """
+    monday_client = MondayClient(api_token)
+
+    @dlt.resource(
+        name="account",
+        write_disposition="replace",
+    )
+    def fetch_account() -> Iterator[dict[str, Any]]:
+        """
+        Fetch account information from Monday.com.
+
+        Table format: account (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError("Account table must be in the format `account`")
+
+        yield normalize_dict(monday_client.get_account())
+
+    @dlt.resource(
+        name="account_roles",
+        write_disposition="replace",
+    )
+    def fetch_account_roles() -> Iterator[dict[str, Any]]:
+        """
+        Fetch account roles from Monday.com.
+
+        Table format: account_roles (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError(
+                "Account roles table must be in the format `account_roles`"
+            )
+
+        yield from monday_client.get_account_roles()
+
+    @dlt.resource(
+        name="users",
+        write_disposition="replace",
+    )
+    def fetch_users() -> Iterator[dict[str, Any]]:
+        """
+        Fetch users from Monday.com.
+
+        Table format: users (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError("Users table must be in the format `users`")
+
+        yield from monday_client.get_users()
+
+    @dlt.resource(
+        name="boards",
+        write_disposition="merge",
+        primary_key="id",
+    )
+    def fetch_boards(
+        updated_at: dlt.sources.incremental[str] = dlt.sources.incremental(
+            "updated_at", initial_value=start_date
+        ),
+    ) -> Iterator[dict[str, Any]]:
+        """
+        Fetch boards from Monday.com.
+
+        Table format: boards (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError("Boards table must be in the format `boards`")
+
+        yield from monday_client.get_boards()
+
+    @dlt.resource(
+        name="workspaces",
+        write_disposition="replace",
+    )
+    def fetch_workspaces() -> Iterator[dict[str, Any]]:
+        """
+        Fetch workspaces from Monday.com.
+
+        Table format: workspaces (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError("Workspaces table must be in the format `workspaces`")
+
+        yield from monday_client.get_workspaces()
+
+    @dlt.resource(
+        name="webhooks",
+        write_disposition="replace",
+    )
+    def fetch_webhooks() -> Iterator[dict[str, Any]]:
+        """
+        Fetch webhooks from Monday.com.
+
+        Table format: webhooks (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError("Webhooks table must be in the format `webhooks`")
+
+        yield from monday_client.get_webhooks()
+
+    @dlt.resource(
+        name="updates",
+        write_disposition="merge",
+        primary_key="id",
+    )
+    def fetch_updates(
+        updated_at: dlt.sources.incremental[str] = dlt.sources.incremental(
+            "updated_at", initial_value=start_date
+        ),
+    ) -> Iterator[dict[str, Any]]:
+        """
+        Fetch updates from Monday.com.
+
+        Table format: updates (no parameters needed)
+        Requires start_date and end_date parameters
+        """
+        if len(params) != 0:
+            raise ValueError("Updates table must be in the format `updates`")
+
+        yield from monday_client.get_updates(start_date=start_date, end_date=end_date)
+
+    @dlt.resource(
+        name="teams",
+        write_disposition="replace",
+    )
+    def fetch_teams() -> Iterator[dict[str, Any]]:
+        """
+        Fetch teams from Monday.com.
+
+        Table format: teams (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError("Teams table must be in the format `teams`")
+
+        yield from monday_client.get_teams()
+
+    @dlt.resource(
+        name="tags",
+        write_disposition="replace",
+    )
+    def fetch_tags() -> Iterator[dict[str, Any]]:
+        """
+        Fetch tags from Monday.com.
+
+        Table format: tags (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError("Tags table must be in the format `tags`")
+
+        yield from monday_client.get_tags()
+
+    @dlt.resource(
+        name="custom_activities",
+        write_disposition="replace",
+    )
+    def fetch_custom_activities() -> Iterator[dict[str, Any]]:
+        """
+        Fetch custom activities from Monday.com.
+
+        Table format: custom_activities (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError(
+                "Custom activities table must be in the format `custom_activities`"
+            )
+
+        yield from monday_client.get_custom_activities()
+
+    @dlt.resource(
+        name="board_columns",
+        write_disposition="replace",
+    )
+    def fetch_board_columns() -> Iterator[dict[str, Any]]:
+        """
+        Fetch board columns from Monday.com.
+
+        Table format: board_columns (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError(
+                "Board columns table must be in the format `board_columns`"
+            )
+
+        yield from monday_client.get_board_columns()
+
+    @dlt.resource(
+        name="board_views",
+        write_disposition="replace",
+    )
+    def fetch_board_views() -> Iterator[dict[str, Any]]:
+        """
+        Fetch board views from Monday.com.
+
+        Table format: board_views (no parameters needed)
+        """
+        if len(params) != 0:
+            raise ValueError("Board views table must be in the format `board_views`")
+
+        yield from monday_client.get_board_views()
+
+    return (
+        fetch_account,
+        fetch_account_roles,
+        fetch_users,
+        fetch_boards,
+        fetch_workspaces,
+        fetch_webhooks,
+        fetch_updates,
+        fetch_teams,
+        fetch_tags,
+        fetch_custom_activities,
+        fetch_board_columns,
+        fetch_board_views,
+    )