feat: Add CLI

[TheTrueAI]

Proposed Changes

Developers and AI tooling need a simple, scriptable query command for fast feedback during development. Existing community Python CLI seems unmaintained and not aligned with current behavior. So this PR introduces the following:

• Adds a new influx3 query CLI path for read/query workflows.
• Supports SQL and InfluxQL queries with JSON, JSONL, CSV, and pretty output formats.
• Adds module entrypoint support so the CLI can also be run through python -m influxdb_client_3.
• Fixes Windows-specific PEM newline handling for Flight query TLS root certificates.

Checklist

• CHANGELOG.md updated
• Rebased/mergeable
• A test has been added if appropriate
• Tests pass
• Commit messages are conventional
• Sign CLA (if not already signed)

[bednar]

@TheTrueAI thanks for the PR. There is already an existing CLI tool: https://docs.influxdata.com/influxdb3/core/reference/cli/influxdb3/. What’s the reason for creating a new one in the Python v3 client?

[TheTrueAI]

Good point — the official influxdb3 query CLI does cover the same query functionality. My motivation was zero-install in Python environments: pip install influxdb3-python gives you the CLI inside the venv with no separate binary needed. This is useful for Python-centric CI and AI agent workflows where adding system binaries is friction.

Happy to scope this down or close if you feel the overlap isn't justified.

[bednar]

Good point — the official influxdb3 query CLI does cover the same query functionality. My motivation was zero-install in Python environments: pip install influxdb3-python gives you the CLI inside the venv with no separate binary needed. This is useful for Python-centric CI and AI agent workflows where adding system binaries is friction.

Happy to scope this down or close if you feel the overlap isn't justified.

Thanks for explanation, every PR is welcome so we will be happy to review your code. Thanks again for your contribution.

[Copilot]

Pull request overview

Introduces a first-party, scriptable influx3 query CLI for executing SQL/InfluxQL queries against InfluxDB 3, and adds a small Windows-focused TLS root cert compatibility fix for Flight query PEM loading.

Changes:

• Add influx3 console script + python -m influxdb_client_3 module entrypoint for query workflows.
• Implement query execution + output formatting (JSON/JSONL/CSV/pretty), config/env precedence, and basic error handling.
• Normalize PEM certificate line endings when reading Flight query root certs.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
influxdb_client_3/cli.py	New CLI implementation for influx3 query including formatting, env precedence, and output handling.
influxdb_client_3/__main__.py	Enables python -m influxdb_client_3 CLI execution.
setup.py	Adds console_scripts entry point for influx3.
tests/test_cli.py	Adds unit tests for CLI parsing and core query execution paths.
influxdb_client_3/query/query_api.py	Normalizes PEM line endings when reading root certificates.
README.md	Documents CLI usage, formats, and configuration precedence.
CHANGELOG.md	Adds feature + bug-fix entries for the CLI and PEM normalization.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 8 out of 8 changed files in this pull request and generated 1 comment.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[codecov]

Codecov Report

❌ Patch coverage is 92.30769% with 9 lines in your changes missing coverage. Please review.
✅ Project coverage is 76.07%. Comparing base (592b6f7) to head (2301077).

Files with missing lines	Patch %	Lines
influxdb_client_3/cli.py	94.64%	6 Missing ⚠️
influxdb_client_3/__main__.py	0.00%	3 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #208      +/-   ##
==========================================
+ Coverage   75.17%   76.07%   +0.89%     
==========================================
  Files          35       37       +2     
  Lines        2417     2533     +116     
==========================================
+ Hits         1817     1927     +110     
- Misses        600      606       +6     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.