feat: make dependencies available under narwhals.stable.v1 for type checkers

[MarcoGorelli]

Currently

from narwhals.stable.v1.dependencies import is_pandas_like_dataframe

raises, but

from narwhals.stable.v1 import dependencies

passes

[dangotbanned]

I've tried a few variants of import statements but not had any luck.

I think adding an __all__ would do the trick though, maybe one of the idoms from https://microsoft.github.io/pyright/#/typed-libraries?id=library-interface

Although making both mypy and pyright happy is more of a task

https://github.com/vega/altair/blob/c41e29e0bfa9e34d942635e574b2accfd9f2de0d/tools/generate_schema_wrapper.py#L1103-L1139

[MarcoGorelli]

thanks for taking a look at that - i think we have it:

narwhals/narwhals/__init__.py

Line 109 in 78f1a8d

"dependencies",

we may just need to make a dependencies.py file in which we do the import, that'd probably be the simplest thing

[dangotbanned]

thanks for taking a look at that - i think we have it:

narwhals/narwhals/__init__.py

Line 109 in 78f1a8d

"dependencies",

we may just need to make a dependencies.py file in which we do the import, that'd probably be the simplest thing

Apologies if I've misunderstood your comment

I meant adding an __all__ here

narwhals/narwhals/stable/v1/__init__.py

Lines 69 to 80 in 6946e26

	if TYPE_CHECKING:
	from types import ModuleType
	from typing_extensions import Self
	from narwhals.dtypes import DType
	from narwhals.functions import ArrowStreamExportable
	from narwhals.typing import IntoExpr
	from narwhals.typing import IntoSeries
	T = TypeVar("T")

[MarcoGorelli]

sorry i may have misunderstood myself - don't we have it at the bottom of the file?

narwhals/narwhals/stable/v1/__init__.py

Lines 3179 to 3247 in 6946e26

	__all__ = [
	"Array",
	"Boolean",
	"Categorical",
	"DataFrame",
	"Date",
	"Datetime",
	"Duration",
	"Enum",
	"Expr",
	"Field",
	"Float32",
	"Float64",
	"Int16",
	"Int32",
	"Int64",
	"Int8",
	"LazyFrame",
	"List",
	"Object",
	"Schema",
	"Series",
	"String",
	"Struct",
	"UInt16",
	"UInt32",
	"UInt64",
	"UInt8",
	"Unknown",
	"all",
	"all_horizontal",
	"any_horizontal",
	"col",
	"concat",
	"concat_str",
	"dependencies",
	"exceptions",
	"from_arrow",
	"from_dict",
	"from_native",
	"generate_temporary_column_name",
	"get_level",
	"get_native_namespace",
	"is_ordered_categorical",
	"len",
	"lit",
	"max",
	"max_horizontal",
	"maybe_align_index",
	"maybe_convert_dtypes",
	"maybe_get_index",
	"maybe_reset_index",
	"maybe_set_index",
	"mean",
	"mean_horizontal",
	"median",
	"min",
	"min_horizontal",
	"narwhalify",
	"new_series",
	"nth",
	"selectors",
	"show_versions",
	"sum",
	"sum_horizontal",
	"to_native",
	"to_py_scalar",
	"when",
	]

[dangotbanned]

sorry i may have misunderstood myself - don't we have it at the bottom of the file?

narwhals/narwhals/stable/v1/__init__.py

Lines 3179 to 3247 in 6946e26

	__all__ = [
	"Array",
	"Boolean",
	"Categorical",
	"DataFrame",
	"Date",
	"Datetime",
	"Duration",
	"Enum",
	"Expr",
	"Field",
	"Float32",
	"Float64",
	"Int16",
	"Int32",
	"Int64",
	"Int8",
	"LazyFrame",
	"List",
	"Object",
	"Schema",
	"Series",
	"String",
	"Struct",
	"UInt16",
	"UInt32",
	"UInt64",
	"UInt8",
	"Unknown",
	"all",
	"all_horizontal",
	"any_horizontal",
	"col",
	"concat",
	"concat_str",
	"dependencies",
	"exceptions",
	"from_arrow",
	"from_dict",
	"from_native",
	"generate_temporary_column_name",
	"get_level",
	"get_native_namespace",
	"is_ordered_categorical",
	"len",
	"lit",
	"max",
	"max_horizontal",
	"maybe_align_index",
	"maybe_convert_dtypes",
	"maybe_get_index",
	"maybe_reset_index",
	"maybe_set_index",
	"mean",
	"mean_horizontal",
	"median",
	"min",
	"min_horizontal",
	"narwhalify",
	"new_series",
	"nth",
	"selectors",
	"show_versions",
	"sum",
	"sum_horizontal",
	"to_native",
	"to_py_scalar",
	"when",
	]

ah there it is 😅

[dangotbanned]

@MarcoGorelli I haven't checked the other submodules, but do these all have the same issue?

narwhals/narwhals/stable/v1/__init__.py

Lines 15 to 17 in 6946e26

	from narwhals import dependencies
	from narwhals import exceptions
	from narwhals import selectors

Great to see #1430

[MarcoGorelli]

for those we already have dedicated files