# lance-namespace

> Lance Namespace interface and plugin registry

- **URL**: https://www.freshcrate.ai/projects/lance-namespace
- **Author**: pypi
- **Category**: Databases
- **Latest version**: `v0.8.0` (2026-06-01)
- **License**: Apache-2.0
- **Source**: https://github.com/lance-format/lance-namespace
- **Homepage**: https://pypi.org/project/lance-namespace/
- **Language**: Java
- **GitHub**: 53 stars, 36 forks
- **Registry**: pypi (`lance-namespace`)
- **Tags**: `lance`, `lancedb`, `namespace`, `pypi`, `vector-database`

## Description

# lance-namespace

Lance Namespace interface and plugin registry.

## Overview

This package provides:
- `LanceNamespace` ABC interface for namespace implementations
- `connect()` factory function for creating namespace instances
- `register_namespace_impl()` for external implementation registration
- Re-exported model types from `lance_namespace_urllib3_client`

## Installation

```bash
pip install lance-namespace
```

## Usage

```python
import lance_namespace

# Connect using native implementations (requires lance package)
ns = lance_namespace.connect("dir", {"root": "/path/to/data"})
ns = lance_namespace.connect("rest", {"uri": "http://localhost:4099"})

# Register a custom implementation
lance_namespace.register_namespace_impl("glue", "lance_glue.GlueNamespace")
ns = lance_namespace.connect("glue", {"catalog": "my_catalog"})
```

## Creating Custom Implementations

```python
from lance_namespace import LanceNamespace

class MyNamespace(LanceNamespace):
    def namespace_id(self) -> str:
        return "MyNamespace { ... }"

    # Override other methods as needed
```

## License

Apache-2.0

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.8.0` | 2026-06-01 | High | <!-- Release notes generated using configuration in .github/release.yml at v0.8.0 -->  ## What's Changed ### Breaking Changes 🛠 * feat(rest)!: require virtual column outputs by @BubbleCal in https://github.com/lance-format/lance-namespace/pull/346  ## New Contributors * @BubbleCal made their first contribution in https://github.com/lance-format/lance-namespace/pull/346  **Full Changelog**: https://github.com/lance-format/lance-namespace/compare/v0.7.7...v0.8.0 |
| `v0.7.7` | 2026-05-20 | High | <!-- Release notes generated using configuration in .github/release.yml at v0.7.7 -->  ## What's Changed ### New Features 🎉 * feat: api changes for materialized views and udtfs by @rpgreen in https://github.com/lance-format/lance-namespace/pull/344 ### Other Changes * refactor(docs): split catalog and namespace into formal structure by @jackye1995 in https://github.com/lance-format/lance-namespace/pull/326  ## New Contributors * @rpgreen made their first contribution in https://github. |
| `v0.7.6` | 2026-05-05 | High | <!-- Release notes generated using configuration in .github/release.yml at v0.7.6 -->  ## What's Changed ### Bug Fixes 🐛 * fix(rest): make data_type optional in AlterColumnsEntry by @jackye1995 in https://github.com/lance-format/lance-namespace/pull/338   **Full Changelog**: https://github.com/lance-format/lance-namespace/compare/v0.7.5...v0.7.6 |
| `v0.7.5` | 2026-05-05 | High | <!-- Release notes generated using configuration in .github/release.yml at v0.7.5 -->  ## What's Changed ### New Features 🎉 * feat(rest): extend virtual column entries with UDF metadata and add identity to requests by @jackye1995 in https://github.com/lance-format/lance-namespace/pull/337   **Full Changelog**: https://github.com/lance-format/lance-namespace/compare/v0.7.4...v0.7.5 |
| `v0.7.2` | 2026-04-25 | High | <!-- Release notes generated using configuration in .github/release.yml at v0.7.2 -->  ## What's Changed ### New Features 🎉 * feat: add check_declared in describe table request by @jackye1995 in https://github.com/lance-format/lance-namespace/pull/334   **Full Changelog**: https://github.com/lance-format/lance-namespace/compare/v0.7.1...v0.7.2 |
| `v0.7.1` | 2026-04-24 | High | <!-- Release notes generated using configuration in .github/release.yml at v0.7.1 -->  ## What's Changed ### New Features 🎉 * feat: default include_declared to true in ListTables by @jackye1995 in https://github.com/lance-format/lance-namespace/pull/332   **Full Changelog**: https://github.com/lance-format/lance-namespace/compare/v0.7.0...v0.7.1 |
| `0.6.1` | 2026-04-21 | Low | Imported from PyPI (0.6.1) |
| `v0.6.1` | 2026-03-17 | Low | <!-- Release notes generated using configuration in .github/release.yml at v0.6.1 -->  ## What's Changed ### Bug Fixes 🐛 * fix(java): keep async query responses as bytes by @Xuanwo in https://github.com/lance-format/lance-namespace/pull/321   **Full Changelog**: https://github.com/lance-format/lance-namespace/compare/v0.6.0...v0.6.1 |
| `v0.6.0` | 2026-03-16 | Low | <!-- Release notes generated using configuration in .github/release.yml at v0.6.0 -->  ## What's Changed ### New Features 🎉 * feat: add BatchCommitTables API for atomic multi-table commit operations by @XuQianJin-Stars in https://github.com/lance-format/lance-namespace/pull/315  ## New Contributors * @XuQianJin-Stars made their first contribution in https://github.com/lance-format/lance-namespace/pull/315  **Full Changelog**: https://github.com/lance-format/lance-namespace/compare/v0.5 |
| `v0.5.4` | 2026-03-16 | Low | <!-- Release notes generated using configuration in .github/release.yml at v0.5.4 -->  ## What's Changed ### Bug Fixes 🐛 * fix: pin async javadocs to Java 11 by @Xuanwo in https://github.com/lance-format/lance-namespace/pull/318  ## New Contributors * @Xuanwo made their first contribution in https://github.com/lance-format/lance-namespace/pull/318  **Full Changelog**: https://github.com/lance-format/lance-namespace/compare/v0.5.3...v0.5.4 |

## Citation

- HTML: https://www.freshcrate.ai/projects/lance-namespace
- Markdown: https://www.freshcrate.ai/projects/lance-namespace.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/lance-namespace/deps

_Generated by freshcrate.ai. Indexes pypi releases for AI-agent ecosystem packages._
