duckdb 0.8.2.dev3007__cp311-cp311-win_amd64.whl → 1.4.3.dev8__cp311-cp311-win_amd64.whl

duckdb/__init__.py

@@ -1,137 +1,96 @@
-_exported_symbols = []
+# ruff: noqa: F401
+"""The DuckDB Python Package.
 
-# Modules
-import duckdb.functional as functional
-import duckdb.typing as typing
-_exported_symbols.extend([
-    "typing",
-    "functional"
-])
+This module re-exports the DuckDB C++ extension (`_duckdb`) and provides DuckDB's public API.
 
-# Classes
-from .duckdb import (
-    DuckDBPyRelation,
+Note:
+- Some symbols exposed here are implementation details of DuckDB's C++ engine.
+- They are kept for backwards compatibility but are not considered stable API.
+- Future versions may move them into submodules with deprecation warnings.
+"""
+
+from _duckdb import (
+    BinderException,
+    CaseExpression,
+    CatalogException,
+    CoalesceOperator,
+    ColumnExpression,
+    ConnectionException,
+    ConstantExpression,
+    ConstraintException,
+    ConversionException,
+    CSVLineTerminator,
+    DatabaseError,
+    DataError,
+    DefaultExpression,
+    DependencyException,
     DuckDBPyConnection,
+    DuckDBPyRelation,
+    Error,
+    ExpectedResultType,
     ExplainType,
-    PythonExceptionHandling
-)
-_exported_symbols.extend([
-    "DuckDBPyRelation",
-    "DuckDBPyConnection",
-    "ExplainType",
-    "PythonExceptionHandling"
-])
-
-# Enums
-from .duckdb import (
-    ANALYZE,
-    DEFAULT,
-    RETURN_NULL,
-    STANDARD
-)
-_exported_symbols.extend([
-    "ANALYZE",
-    "DEFAULT",
-    "RETURN_NULL",
-    "STANDARD"
-])
-
-# Type-creation methods
-from .duckdb import (
-    struct_type,
-    list_type,
-    array_type,
-    decimal_type
-)
-_exported_symbols.extend([
-    "struct_type",
-    "list_type",
-    "array_type",
-    "decimal_type"
-])
-
-# read-only properties
-from .duckdb import (
-    __standard_vector_size__,
+    Expression,
+    FatalException,
+    FunctionExpression,
+    HTTPException,
+    IntegrityError,
+    InternalError,
+    InternalException,
+    InterruptException,
+    InvalidInputException,
+    InvalidTypeException,
+    IOException,
+    LambdaExpression,
+    NotImplementedException,
+    NotSupportedError,
+    OperationalError,
+    OutOfMemoryException,
+    OutOfRangeException,
+    ParserException,
+    PermissionException,
+    ProgrammingError,
+    PythonExceptionHandling,
+    RenderMode,
+    SequenceException,
+    SerializationException,
+    SQLExpression,
+    StarExpression,
+    Statement,
+    StatementType,
+    SyntaxException,
+    TransactionException,
+    TypeMismatchException,
+    Warning,
+    __formatted_python_version__,
+    __git_revision__,
     __interactive__,
     __jupyter__,
-    __version__,
-    apilevel,
-    comment,
-    default_connection,
-    identifier,
-    keyword,
-    numeric_const,
-    operator,
-    paramstyle,
-    string_const,
-    threadsafety,
-    token_type,
-    tokenize
-)
-_exported_symbols.extend([
-    "__standard_vector_size__",
-    "__interactive__",
-    "__jupyter__",
-    "__version__",
-    "apilevel",
-    "comment",
-    "default_connection",
-    "identifier",
-    "keyword",
-    "numeric_const",
-    "operator",
-    "paramstyle",
-    "string_const",
-    "threadsafety",
-    "token_type",
-    "tokenize"
-])
-
-from .duckdb import (
-    filter,
-    project,
+    __standard_vector_size__,
+    _clean_default_connection,
     aggregate,
-    distinct,
-    limit,
-    query_df,
-    order,
     alias,
-    connect,
-    write_csv
-)
-_exported_symbols.extend([
-    "filter",
-    "project",
-    "aggregate",
-    "distinct",
-    "limit",
-    "query_df",
-    "order",
-    "alias",
-    "connect",
-    "write_csv"
-])
-
-# TODO: might be worth seeing if these methods can be replaced with a pure-python solution
-# Connection methods
-from .duckdb import (
+    apilevel,
     append,
     array_type,
     arrow,
     begin,
+    checkpoint,
     close,
     commit,
+    connect,
     create_function,
     cursor,
     decimal_type,
+    default_connection,
     description,
     df,
+    distinct,
     dtype,
     duplicate,
     enum_type,
     execute,
     executemany,
+    extract_statements,
     fetch_arrow_table,
     fetch_df,
     fetch_df_chunk,
@@ -142,24 +101,27 @@ from .duckdb import (
     fetchnumpy,
     fetchone,
     filesystem_is_registered,
+    filter,
     from_arrow,
     from_csv_auto,
     from_df,
     from_parquet,
     from_query,
-    from_substrait,
-    from_substrait_json,
-    get_substrait,
-    get_substrait_json,
     get_table_names,
     install_extension,
     interrupt,
+    limit,
     list_filesystems,
     list_type,
     load_extension,
     map_type,
+    order,
+    paramstyle,
     pl,
+    project,
     query,
+    query_df,
+    query_progress,
     read_csv,
     read_json,
     read_parquet,
@@ -168,6 +130,8 @@ from .duckdb import (
     remove_function,
     rollback,
     row_type,
+    rowcount,
+    set_default_connection,
     sql,
     sqltype,
     string_type,
@@ -175,31 +139,184 @@ from .duckdb import (
     table,
     table_function,
     tf,
+    threadsafety,
+    token_type,
+    tokenize,
     torch,
     type,
     union_type,
     unregister,
     unregister_filesystem,
     values,
-    view
+    view,
+    write_csv,
+)
+
+from duckdb._dbapi_type_object import (
+    BINARY,
+    DATETIME,
+    NUMBER,
+    ROWID,
+    STRING,
+    DBAPITypeObject,
 )
-_exported_symbols.extend([
+from duckdb._version import (
+    __duckdb_version__,
+    __version__,
+    version,
+)
+from duckdb.value.constant import (
+    BinaryValue,
+    BitValue,
+    BlobValue,
+    BooleanValue,
+    DateValue,
+    DecimalValue,
+    DoubleValue,
+    FloatValue,
+    HugeIntegerValue,
+    IntegerValue,
+    IntervalValue,
+    ListValue,
+    LongValue,
+    MapValue,
+    NullValue,
+    ShortValue,
+    StringValue,
+    StructValue,
+    TimestampMilisecondValue,
+    TimestampNanosecondValue,
+    TimestampSecondValue,
+    TimestampTimeZoneValue,
+    TimestampValue,
+    TimeTimeZoneValue,
+    TimeValue,
+    UnionType,
+    UnsignedBinaryValue,
+    UnsignedHugeIntegerValue,
+    UnsignedIntegerValue,
+    UnsignedLongValue,
+    UnsignedShortValue,
+    UUIDValue,
+    Value,
+)
+
+__all__: list[str] = [
+    "BinaryValue",
+    "BinderException",
+    "BitValue",
+    "BlobValue",
+    "BooleanValue",
+    "CSVLineTerminator",
+    "CaseExpression",
+    "CatalogException",
+    "CoalesceOperator",
+    "ColumnExpression",
+    "ConnectionException",
+    "ConstantExpression",
+    "ConstraintException",
+    "ConversionException",
+    "DataError",
+    "DatabaseError",
+    "DateValue",
+    "DecimalValue",
+    "DefaultExpression",
+    "DependencyException",
+    "DoubleValue",
+    "DuckDBPyConnection",
+    "DuckDBPyRelation",
+    "Error",
+    "ExpectedResultType",
+    "ExplainType",
+    "Expression",
+    "FatalException",
+    "FloatValue",
+    "FunctionExpression",
+    "HTTPException",
+    "HugeIntegerValue",
+    "IOException",
+    "IntegerValue",
+    "IntegrityError",
+    "InternalError",
+    "InternalException",
+    "InterruptException",
+    "IntervalValue",
+    "InvalidInputException",
+    "InvalidTypeException",
+    "LambdaExpression",
+    "ListValue",
+    "LongValue",
+    "MapValue",
+    "NotImplementedException",
+    "NotSupportedError",
+    "NullValue",
+    "OperationalError",
+    "OutOfMemoryException",
+    "OutOfRangeException",
+    "ParserException",
+    "PermissionException",
+    "ProgrammingError",
+    "PythonExceptionHandling",
+    "RenderMode",
+    "SQLExpression",
+    "SequenceException",
+    "SerializationException",
+    "ShortValue",
+    "StarExpression",
+    "Statement",
+    "StatementType",
+    "StringValue",
+    "StructValue",
+    "SyntaxException",
+    "TimeTimeZoneValue",
+    "TimeValue",
+    "TimestampMilisecondValue",
+    "TimestampNanosecondValue",
+    "TimestampSecondValue",
+    "TimestampTimeZoneValue",
+    "TimestampValue",
+    "TransactionException",
+    "TypeMismatchException",
+    "UUIDValue",
+    "UnionType",
+    "UnsignedBinaryValue",
+    "UnsignedHugeIntegerValue",
+    "UnsignedIntegerValue",
+    "UnsignedLongValue",
+    "UnsignedShortValue",
+    "Value",
+    "Warning",
+    "__formatted_python_version__",
+    "__git_revision__",
+    "__interactive__",
+    "__jupyter__",
+    "__standard_vector_size__",
+    "__version__",
+    "_clean_default_connection",
+    "aggregate",
+    "alias",
+    "apilevel",
     "append",
     "array_type",
     "arrow",
     "begin",
+    "checkpoint",
     "close",
     "commit",
+    "connect",
     "create_function",
     "cursor",
     "decimal_type",
+    "default_connection",
     "description",
     "df",
+    "distinct",
     "dtype",
     "duplicate",
     "enum_type",
     "execute",
     "executemany",
+    "extract_statements",
     "fetch_arrow_table",
     "fetch_df",
     "fetch_df_chunk",
@@ -210,24 +327,28 @@ _exported_symbols.extend([
     "fetchnumpy",
     "fetchone",
     "filesystem_is_registered",
+    "filter",
     "from_arrow",
     "from_csv_auto",
     "from_df",
     "from_parquet",
     "from_query",
-    "from_substrait",
-    "from_substrait_json",
-    "get_substrait",
-    "get_substrait_json",
     "get_table_names",
     "install_extension",
     "interrupt",
+    "limit",
     "list_filesystems",
     "list_type",
     "load_extension",
     "map_type",
+    "order",
+    "paramstyle",
+    "paramstyle",
     "pl",
+    "project",
     "query",
+    "query_df",
+    "query_progress",
     "read_csv",
     "read_json",
     "read_parquet",
@@ -236,6 +357,8 @@ _exported_symbols.extend([
     "remove_function",
     "rollback",
     "row_type",
+    "rowcount",
+    "set_default_connection",
     "sql",
     "sqltype",
     "string_type",
@@ -243,85 +366,16 @@ _exported_symbols.extend([
     "table",
     "table_function",
     "tf",
+    "threadsafety",
+    "threadsafety",
+    "token_type",
+    "tokenize",
     "torch",
     "type",
     "union_type",
     "unregister",
     "unregister_filesystem",
     "values",
-    "view"
-])
-
-# Exceptions
-from .duckdb import (
-    Error,
-    DataError,
-    CastException,
-    ConversionException,
-    OutOfRangeException,
-    TypeMismatchException,
-    ValueOutOfRangeException,
-    FatalException,
-    IntegrityError,
-    ConstraintException,
-    InternalError,
-    InternalException,
-    InterruptException,
-    NotSupportedError,
-    NotImplementedException,
-    OperationalError,
-    ConnectionException,
-    IOException,
-    HTTPException,
-    OutOfMemoryException,
-    SerializationException,
-    TransactionException,
-    PermissionException,
-    ProgrammingError,
-    BinderException,
-    CatalogException,
-    InvalidInputException,
-    InvalidTypeException,
-    ParserException,
-    SyntaxException,
-    SequenceException,
-    StandardException,
-    Warning
-)
-_exported_symbols.extend([
-    "Error",
-    "DataError",
-    "CastException",
-    "ConversionException",
-    "OutOfRangeException",
-    "TypeMismatchException",
-    "ValueOutOfRangeException",
-    "FatalException",
-    "IntegrityError",
-    "ConstraintException",
-    "InternalError",
-    "InternalException",
-    "InterruptException",
-    "NotSupportedError",
-    "NotImplementedException",
-    "OperationalError",
-    "ConnectionException",
-    "IOException",
-    "HTTPException",
-    "OutOfMemoryException",
-    "SerializationException",
-    "TransactionException",
-    "PermissionException",
-    "ProgrammingError",
-    "BinderException",
-    "CatalogException",
-    "InvalidInputException",
-    "InvalidTypeException",
-    "ParserException",
-    "SyntaxException",
-    "SequenceException",
-    "StandardException",
-    "Warning"
-])
-
-__all__ = _exported_symbols
+    "view",
+    "write_csv",
+]