feat: allow for "import narwhals.stable.v1.selectors as cs" (#1459)

narwhals/__init__.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 from narwhals import dependencies
+from narwhals import dtypes
 from narwhals import exceptions
 from narwhals import selectors
 from narwhals import stable
@@ -107,6 +108,7 @@
     "concat",
     "concat_str",
     "dependencies",
+    "dtypes",
     "exceptions",
     "from_arrow",
     "from_dict",

narwhals/selectors.py

@@ -268,3 +268,13 @@ def all() -> Expr:
         └─────┴─────┴───────┘
     """
     return Selector(lambda plx: plx.selectors.all())
+
+
+__all__ = [
+    "by_dtype",
+    "numeric",
+    "boolean",
+    "string",
+    "categorical",
+    "all",
+]

narwhals/stable/v1/__init__.py

@@ -28,6 +28,7 @@
 from narwhals.functions import show_versions
 from narwhals.schema import Schema as NwSchema
 from narwhals.series import Series as NwSeries
+from narwhals.stable.v1 import dtypes
 from narwhals.stable.v1.dtypes import Array
 from narwhals.stable.v1.dtypes import Boolean
 from narwhals.stable.v1.dtypes import Categorical
@@ -3232,6 +3233,7 @@ def from_dict(
     "concat",
     "concat_str",
     "dependencies",
+    "dtypes",
     "exceptions",
     "from_arrow",
     "from_dict",

narwhals/stable/v1/selectors.py

@@ -0,0 +1,17 @@
+from __future__ import annotations
+
+from narwhals.selectors import all
+from narwhals.selectors import boolean
+from narwhals.selectors import by_dtype
+from narwhals.selectors import categorical
+from narwhals.selectors import numeric
+from narwhals.selectors import string
+
+__all__ = [
+    "by_dtype",
+    "numeric",
+    "boolean",
+    "string",
+    "categorical",
+    "all",
+]

tests/selectors_test.py

@@ -5,12 +5,12 @@
 import pytest
 
 import narwhals.stable.v1 as nw
-from narwhals.selectors import all
-from narwhals.selectors import boolean
-from narwhals.selectors import by_dtype
-from narwhals.selectors import categorical
-from narwhals.selectors import numeric
-from narwhals.selectors import string
+from narwhals.stable.v1.selectors import all
+from narwhals.stable.v1.selectors import boolean
+from narwhals.stable.v1.selectors import by_dtype
+from narwhals.stable.v1.selectors import categorical
+from narwhals.stable.v1.selectors import numeric
+from narwhals.stable.v1.selectors import string
 from tests.utils import PYARROW_VERSION
 from tests.utils import Constructor
 from tests.utils import assert_equal_data