ibis-project / ibis

the portable Python dataframe library
https://ibis-project.org
Apache License 2.0
4.25k stars 528 forks source link

[EPIC] Ibis expression API stability #8996

Open lostmygithubaccount opened 2 weeks ago

lostmygithubaccount commented 2 weeks ago

Acceptance criteria: the Ibis user-facing expression API is stabilized for 10.0+. While we will always reserve the right to make breaking changes, we are now in the place where stability is important for production dependencies. Organizations choosing Ibis should feel confident their code will work with minimal effort when upgrading to new versions.

TODOs:

P0

read_in_memory or create_table

dtype or type or cast

P1

refactor or deprecate or breaking changes

read_in_memory or create_table or Table/Views

dtype or type or cast

other

P2

refactor or deprecate or breaking changes

read_in_memory or create_table or Table/Views

dtype or type

other

P3

dtype or type

other

Need to open issue: Also, there's not an issue for this, but we should standardize our usage of keyword-only arguments and expand their usage dramatically.

gforsyth commented 1 week ago

I ended up cataloging a bunch of issues that are more related to this than to #8994, I'll list them here:

Also, there's not an issue for this, but we should standardize our usage of keyword-only arguments and expand their usage dramatically.

ncclementi commented 1 week ago

After looking I think all of these are also part of Ibis expression API stability, dumping them here, I'll organize them by priority soon.

DType, mapping and cast related

Pretty-printing:

Other