Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

chore: adjust <Backend>.do_connect() be kw or positional only, add callouts to url connection method #10985

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

NickCrews
Copy link
Contributor

resolves #10901

This not only adds better docs, but it also is slightly breaking
by mkaing many args kwarg-only. So if someone was doing ibis.bigquery.connect("my-project-id", "my-dataset-id") then that would be broken. For most backends, there are so many connection params, I would expect most devs to pass them by kwarg already, but I bet this will affect some people.

This is also potentially slightly breaking for duckdb and sqlite by making the database path positional-only. I'm not as sure about if this is a good idea.

Let me know, I can adjust the scope of this as you want.

@github-actions github-actions bot added impala The Apache Impala backend postgres The PostgreSQL backend sqlite The SQLite backend clickhouse The ClickHouse backend mysql The MySQL backend pyspark The Apache PySpark backend bigquery The BigQuery backend duckdb The DuckDB backend snowflake The Snowflake backend mssql The Microsoft SQL Server backend trino The Trino backend flink Issues or PRs related to Flink exasol Issues related to the exasol backend risingwave The RisingWave backend labels Mar 12, 2025
@NickCrews NickCrews changed the title chore(api): make many params to <Backend>.do_connect() be kw only, add callouts to url connection method. chore(api): adjust <Backend>.do_connect() be kw or positional only, add callouts to url connection method. Mar 12, 2025
Copy link
Contributor

ACTION NEEDED

Ibis follows the Conventional Commits specification for release automation.

The PR title and description are used as the merge commit message.

Please update your PR title and description to match the specification.

@NickCrews NickCrews added breaking change Changes that introduce an API break at any level docs Documentation related issues or PRs docs-preview Add this label to trigger a docs preview labels Mar 12, 2025
@NickCrews NickCrews changed the title chore(api): adjust <Backend>.do_connect() be kw or positional only, add callouts to url connection method. chore: adjust <Backend>.do_connect() be kw or positional only, add callouts to url connection method. Mar 12, 2025
@ibis-docs-bot ibis-docs-bot bot removed the docs-preview Add this label to trigger a docs preview label Mar 12, 2025
@NickCrews NickCrews changed the title chore: adjust <Backend>.do_connect() be kw or positional only, add callouts to url connection method. chore: adjust <Backend>.do_connect() be kw or positional only, add callouts to url connection method Mar 12, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bigquery The BigQuery backend breaking change Changes that introduce an API break at any level clickhouse The ClickHouse backend docs Documentation related issues or PRs duckdb The DuckDB backend exasol Issues related to the exasol backend flink Issues or PRs related to Flink impala The Apache Impala backend mssql The Microsoft SQL Server backend mysql The MySQL backend postgres The PostgreSQL backend pyspark The Apache PySpark backend risingwave The RisingWave backend snowflake The Snowflake backend sqlite The SQLite backend trino The Trino backend
Projects
None yet
Development

Successfully merging this pull request may close these issues.

feat: support ibis.postgres.connect("postgresql://...") in addition to ibis.connect("postgresql://...")
1 participant