Metadata-Version: 2.4
Name: narwhals-map
Version: 0.1.1
Summary: A Narwhals plugin for Map datatype support
Author: danielgafni
Author-email: danielgafni <danielgafni16@gmail.com>
License-Expression: MIT
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering
Classifier: Typing :: Typed
Requires-Dist: ibis-framework>=12.0.0 ; extra == 'ibis'
Requires-Dist: polars>=1.39.3 ; extra == 'polars'
Requires-Dist: polars-map>=0.2.1 ; extra == 'polars'
Requires-Dist: pyarrow>=23.0.1 ; extra == 'pyarrow'
Requires-Python: >=3.10
Provides-Extra: ibis
Provides-Extra: polars
Provides-Extra: pyarrow
Description-Content-Type: text/markdown

# narwhals-map

[![PyPI](https://img.shields.io/pypi/v/narwhals-map)](https://pypi.org/project/narwhals-map/)

An experimental Narwhals plugin adding `Map` datatype.

> [!TIP]
> See [`narwhals-dev/narwhals#3525`](https://github.com/narwhals-dev/narwhals/issues/3525) issue for more info.

`Map` is natively supported across all backends except for Polars.

Supported Narwhals backends:
  - Arrow
  - Ibis
  - Polars (via [`polars-map`](https://pypi.org/project/polars-map/))

Currently monkey-patches Narwhals to expose a new `nw.col.map` namespace.

## Installation

```console
$ uv add narwhals-map
```

## Usage

```python
import narwhals as nw
import narwhals_map  # registers the Map dtype and .map namespace

df = nw.from_native(native_df)  # use polars_map.Map for Polars-backed frames
result = df.select(nw.col("map_col").map.get("key1"))
```
