How mountainash-io/mountainash-data works
mountainash-data is a Python physical-access library for relational databases through Ibis and Iceberg catalogs through PyIceberg. The principal workflow configures a backend, opens a connection, then executes operations or inspects physical metadata; connections can also expose relational expressions. The README documents the facade and factory-driven settings flow. Source excerpts show key backend dispatch and Iceberg connection behavior, but several factories and backend modules were not sampled, so uncertain internal links are omitted.
Main entry points: iceberg/connection.py Iceberg connection · ibis/backend.py Ibis backend · ibis/connection.py Ibis connection · iceberg/backend.py Iceberg backend
Components 21
Public access
- DatabaseUtils
src/mountainash_data/core/utils.py - Connection factory
src/mountainash_data/core/factories/connection_factory.py
Configuration
- Settings factory
src/mountainash_data/core/factories/settings_factory.py - Backend settings
src/mountainash_data/core/settings - Settings registry
src/mountainash_data/core/settings/registry.py
Ibis backends
- Ibis backend
src/mountainash_data/backends/ibis/backend.py - Dialect registry
src/mountainash_data/backends/ibis/dialects/_registry.py - Ibis connection
src/mountainash_data/backends/ibis/connection.py - Ibis operations
src/mountainash_data/backends/ibis/operations.py - Ibis inspection
src/mountainash_data/backends/ibis/inspect.py
Iceberg backends
- Iceberg backend
src/mountainash_data/backends/iceberg/backend.py - REST catalog
src/mountainash_data/backends/iceberg/catalogs/rest.py - Iceberg connection
src/mountainash_data/backends/iceberg/connection.py - Iceberg operations
src/mountainash_data/backends/iceberg/operations.py - Iceberg inspection
src/mountainash_data/backends/iceberg/inspect.py
Shared contracts
- Connection base
src/mountainash_data/core/connection.py - Backend contracts
src/mountainash_data/core/protocol.py - Inspection metadata
src/mountainash_data/core/inspection.py
Other components
- Library user
- Data service or catalog
- Expressions consumer
Connections 23
- Library user → DatabaseUtils: creates connection
README.md - DatabaseUtils → Connection factory: delegates to
- Settings factory → Backend settings: builds profiles
src/mountainash_data/core/factories/settings_factory.py - Backend settings → Settings registry: registers profiles
src/mountainash_data/core/settings/bigquery.py - Library user → Settings factory: selects settings
README.md - Connection factory → Ibis backend: selects backend
- Ibis backend → Dialect registry: uses registry
src/mountainash_data/backends/ibis/backend.py - Ibis backend → Ibis inspection: uses helpers
src/mountainash_data/backends/ibis/backend.py - Ibis connection → Connection base: extends base
src/mountainash_data/backends/ibis/connection.py - Ibis connection → Ibis operations: delegates operations
- Ibis backend → Data service or catalog: connects to
- Ibis connection → Expressions consumer: returns relation
README.md - Iceberg backend → Iceberg connection: creates connection
src/mountainash_data/backends/iceberg/backend.py - Iceberg backend → REST catalog: uses catalog
src/mountainash_data/backends/iceberg/backend.py - Iceberg connection → Connection base: extends base
src/mountainash_data/backends/iceberg/connection.py - Iceberg connection → Iceberg operations: delegates operations
src/mountainash_data/backends/iceberg/connection.py - Iceberg connection → Iceberg inspection: uses helpers
src/mountainash_data/backends/iceberg/connection.py - Iceberg connection → Inspection metadata: populates metadata
src/mountainash_data/backends/iceberg/connection.py - Ibis inspection → Inspection metadata: produces metadata
src/mountainash_data/backends/ibis/inspect.py - Iceberg inspection → Inspection metadata: produces metadata
src/mountainash_data/backends/iceberg/inspect.py - Iceberg connection → Data service or catalog: accesses catalog
- Ibis backend → Backend contracts: implements protocol
- Iceberg backend → Backend contracts: implements protocol
src/mountainash_data/backends/iceberg/backend.py