refactor(python)!: Remove re-export of type aliases

[stinodego]

Changes

• Remove re-export of PolarsDataType at the top-level
• Remove the following re-exports in the datatypes module:
  • OneOrMoreDataTypes
  • PolarsDataType
  • PolarsTemporalType
  • PythonDataType
  • SchemaDefinition
  • SchemaDict

We do not want to re-export type aliases for a few reasons:

• Re-exporting these means we need to load them on every import, when they are only useful during type checking.
• So far, these aren't really meant to be public. They are meant for our own use. We haven't really vetted these to be suitable for public use.

I want to set up a proper polars.typing module like NumPy has, with a few 'blessed' type aliases. Until then, users are encouraged to define their own type aliases, or use the polars.type_aliases module though this module is not intended to be public and may be changed at any point.

This is technically not breaking because we do not document the type aliases in the API reference, but all the same, there will probably be some people who were using these re-exports. So now with the 1.0.0 release it's a good opportunity to make this change.

Example

Before:

def foo(dtype: pl.PolarsDataType) -> None: ...

After:

PolarsDataType = pl.DataType | type[pl.DataType]

def foo(dtype: PolarsDataType) -> None: ...

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 81.01%. Comparing base (a62ab75) to head (c18b54f).

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #17032      +/-   ##
==========================================
+ Coverage   80.98%   81.01%   +0.02%     
==========================================
  Files        1448     1448              
  Lines      190551   190547       -4     
  Branches     2723     2723              
==========================================
+ Hits       154322   154366      +44     
+ Misses      35726    35678      -48     
  Partials      503      503              

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