Skip to main content

tap-airlines-arg

Python License: MIT

Singer tap (Meltano Singer SDK) that pulls Argentina Airports /all-flights data and emits JSON records ready for any Singer target.

Table of contents

What it does

  • Builds partitions for every airport + movement (A/D) for each day from today back to days_back.
  • Adds metadata (x_fetched_at, x_airport_iata, x_movtp, x_date) while keeping all source fields (additionalProperties: true).
  • Authenticates via header Key plus Origin, User-Agent, and optional Accept-Language.
  • Emits a single stream: aerolineas_all_flights.
API (/all-flights) → tap-airlines-arg → Singer target → Warehouse / files

Quickstart

One flow for both CLI and Meltano users:

# 1) Install (uv keeps deps pinned)
uv sync

# 2) Minimal config (defaults are public; override api_key if you have a private one)
cat > config.local.json <<'EOF'
{
  "api_url": "https://webaa-api-h4d5amdfcze7hthn.a02.azurefd.net/web-prod/v1/api-aa",
  "api_key": "HieGcY2nFreIsNLuo5EbXCwE7g0aRzTN",
  "airports": ["AEP", "EZE"],
  "days_back": 1,
  "origin": "https://www.aeropuertosargentina.com",
  "user_agent": "Mozilla/5.0",
  "language": "es-AR"
}
EOF

# 3) Run the tap end-to-end (emits JSONL)
uv run tap-airlines-arg --config config.local.json --test=records > output/aerolineas_all_flights.jsonl

# (Optional) Same config via Meltano with target-jsonl
uv run meltano --environment dev run tap-airlines-arg target-jsonl

Configuration

Parameter Type Default Description
api_url string https://webaa-api-h4d5amdfcze7hthn.a02.azurefd.net/web-prod/v1/api-aa Base URL/all-flights
api_key string HieGcY2nFreIsNLuo5EbXCwE7g0aRzTN Header Key value.
origin string https://www.aeropuertosargentina.com header sent to the API
airports array[string] ["AEP","EZE"] IATA codes to query. JSON array preferred
days_back integer 1 Days back from today (UTC, inclusive). 0 = only today.
user_agent string Mozilla/5.0 User-Agent header.
language string es-AR Accept-Language header.

Tips:

  • Config keys map to env vars when using --config=ENV (e.g., TAP_AIRLINES_API_KEY, TAP_AIRLINES_AIRPORTS).
  • Keep days_back small for frequent runs; increase only for backfills.

Use cases

  • Daily sync of arrivals/departures for one or more airports into a warehouse.
  • Historical backfill for a short window (e.g., last 7–14 days) to analyze delays or cancellations.
  • Lightweight monitoring pipeline that forwards fresh records to a downstream alerting system via a Singer target.

Data schema

  • Core fields include schedule/estimate times (stda, etda, atda), flight identifiers (id, nro, idaerolinea, aerolinea), movement (mov), status, gate/sector/belt, aircraft info, and weather snippets.
  • Metadata appended by the tap: x_fetched_at, x_airport_iata, x_movtp, x_date.
  • Full schema: tap_airlines/schemas/aerolineas_all_flights.json (kept flexible with additionalProperties: true).

Performance

  • The endpoint is single-page; expect tens to a few hundred records per airport/day. Typical default run (AEP+EZE, days_back=1) stays fast on a laptop.
  • Throughput is target-dependent; the tap overhead is minimal and comfortably handles hundreds of records per second.
  • Recommended days_back: 0–3 for routine jobs, up to 14 for backfills. Beyond that, consider chunking runs to avoid large date spans.

Troubleshooting

  • Invalid airports format: must be JSON array (e.g., ["AEP","EZE"]). Strings like "AEP,EZE" are normalized, but empty arrays fail validation. Fix the config and rerun.
  • API authentication failures: 401/403 responses mean the Key header is missing or invalid. Verify api_key, Origin, and User-Agent match the API expectations.
  • Rate limiting: 429 with retry headers. The tap retries automatically; keep days_back small and avoid rapid re-runs. Back off and retry later if limits persist.
  • Empty responses: typically happens when the airport/movement/date has no flights or dates are out of range. Check days_back, confirm the airport code, and inspect logs for the requested airport/movtp/date.

Contributing

Short changes are welcome. Please keep schemas in sync, add/update tests when touching logic, and follow the developer notes in AGENTS.md. Open issues or PRs if anything is unclear.

Metadata

Release files for tap-airlines-arg 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for tap-airlines-arg 1.0.1
File Size Uploaded Provenance Actions
tap_airlines_arg-1.0.1.tar.gz 153.3 kB Without provenance Details for tap_airlines_arg-1.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for tap-airlines-arg 1.0.1
File Interpreter ABI Platform Actions
tap_airlines_arg-1.0.1-py3-none-any.whl Python 3 none any Details for tap_airlines_arg-1.0.1-py3-none-any.whl

Total release size: 164.8 kB

Release files / tap_airlines_arg-1.0.1.tar.gz

Download URL tap_airlines_arg-1.0.1.tar.gz
Size 153.3 kB
Tags Source
SHA-256 checksum
How to use checksums
b4d81162000725614dd77c990844312d20be8bc08246f2b5fff0e10abc131996
BLAKE2b-256 checksum
How to use checksums
c2ac10b37906d1a7df1f1c71fed2b68683dd9b9973a582b3b89141d0b9a34737
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Release files / tap_airlines_arg-1.0.1-py3-none-any.whl

Download URL tap_airlines_arg-1.0.1-py3-none-any.whl
Size 11.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
02d11e405130bd744b970ecd2d0cbe612ebf8d4004acdd2ce46053f6a04d16f7
BLAKE2b-256 checksum
How to use checksums
5a7f74d2fc848ab766dad23aa09d2c2fa425b67d85e0c31500a328ee85c5b23a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.7

Security for tap-airlines-arg 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page