chore: bump version and docs

Author: totalhack

README.md

@@ -7,6 +7,7 @@ Zillion: Make sense of it all
 ![Python 3.6+](https://img.shields.io/badge/python-3.6%2B-blue)
 [![Downloads](https://static.pepy.tech/badge/zillion)](https://pepy.tech/project/zillion)
 
+
 **Introduction**
 ----------------
 
@@ -33,6 +34,7 @@ With `Zillion` you can:
 * Query your warehouse with natural language (NLP extension)
 * Leverage AI to bootstrap your warehouse configurations (NLP extension)
 
+
 **Table of Contents**
 ---------------------
 
@@ -68,6 +70,7 @@ With `Zillion` you can:
 * [Docs](#documentation)
 * [How to Contribute](#how-to-contribute)
 
+
 <a name="installation"></a>
 
 **Installation**
@@ -925,6 +928,7 @@ More thorough documentation can be found [here](https://totalhack.github.io/zill
 You can supplement your knowledge by perusing the [tests](https://github.com/totalhack/zillion/tree/master/tests) directory
 or the [API reference](https://totalhack.github.io/zillion/).
 
+
 ---
 
 <a name="how-to-contribute"></a>
@@ -938,3 +942,4 @@ guide for more information. If you are looking for inspiration, adding support a
 
 
 
+

docs/mkdocs/index.md

@@ -4,6 +4,7 @@
 ![Python 3.6+](https://img.shields.io/badge/python-3.6%2B-blue)
 [![Downloads](https://static.pepy.tech/badge/zillion)](https://pepy.tech/project/zillion)
 
+
 **Introduction**
 ----------------
 
@@ -30,6 +31,7 @@ With `Zillion` you can:
 * Query your warehouse with natural language (NLP extension)
 * Leverage AI to bootstrap your warehouse configurations (NLP extension)
 
+
 ---
 
 <a name="installation"></a>

docs/mkdocs/zillion.core.md

@@ -81,13 +81,13 @@
 
 
 
-## [dbg](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L495-L499)
+## [dbg](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L507-L511)
 
 ::: zillion.core.dbg
     :docstring:
 
 
-## [dbgsql](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L502-L506)
+## [dbgsql](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L514-L518)
 
 ::: zillion.core.dbgsql
     :docstring:
@@ -105,7 +105,7 @@
     :docstring:
 
 
-## [error](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L523-L527)
+## [error](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L535-L539)
 
 ::: zillion.core.error
     :docstring:
@@ -123,7 +123,7 @@
     :docstring:
 
 
-## [get_zillion_config_log_level](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L465-L466)
+## [get_zillion_config_log_level](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L477-L478)
 
 ::: zillion.core.get_zillion_config_log_level
     :docstring:
@@ -135,7 +135,7 @@
     :docstring:
 
 
-## [info](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L509-L513)
+## [info](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L521-L525)
 
 ::: zillion.core.info
     :docstring:
@@ -153,7 +153,7 @@
     :docstring:
 
 
-## [load_zillion_config](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L410-L459)
+## [load_zillion_config](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L410-L471)
 
 ::: zillion.core.load_zillion_config
     :docstring:
@@ -183,19 +183,19 @@
     :docstring:
 
 
-## [set_log_level](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L489-L492)
+## [set_log_level](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L501-L504)
 
 ::: zillion.core.set_log_level
     :docstring:
 
 
-## [set_log_level_from_config](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L472-L483)
+## [set_log_level_from_config](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L484-L495)
 
 ::: zillion.core.set_log_level_from_config
     :docstring:
 
 
-## [warn](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L516-L520)
+## [warn](https://github.com/totalhack/zillion/blob/master/zillion/core.py#L528-L532)
 
 ::: zillion.core.warn
     :docstring:

docs/mkdocs/zillion.datasource.md

@@ -2,7 +2,7 @@
 # Module zillion.datasource
 
 
-## [AdHocDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1612-L1783)
+## [AdHocDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1644-L1815)
 
 *Bases*: tlbx.logging_utils.PrintMixin
 
@@ -11,7 +11,7 @@
     :members: get_dataframe table_exists to_sql
 
 
-## [CSVDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1802-L1812)
+## [CSVDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1834-L1844)
 
 *Bases*: zillion.datasource.AdHocDataTable
 
@@ -20,7 +20,7 @@
     :members: get_dataframe table_exists to_sql
 
 
-## [DataSource](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L467-L1609)
+## [DataSource](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L494-L1641)
 
 *Bases*: zillion.field.FieldManagerMixin, tlbx.logging_utils.PrintMixin
 
@@ -29,7 +29,7 @@
     :members: add_dimension add_metric apply_config directly_has_dimension directly_has_field directly_has_metric find_descendent_tables find_neighbor_tables find_possible_table_sets from_data_file from_datatables from_db_file get_child_field_managers get_columns_with_field get_dialect_name get_dim_tables_with_dim get_dimension get_dimension_configs get_dimension_names get_dimensions get_direct_dimension_configs get_direct_dimensions get_direct_fields get_direct_metric_configs get_direct_metrics get_field get_field_instances get_field_managers get_field_names get_fields get_metric get_metric_configs get_metric_names get_metric_tables_with_metric get_metrics get_params get_possible_joins get_table get_tables_with_field has_dimension has_field has_metric has_table print_dimensions print_info print_metrics
 
 
-## [ExcelDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1815-L1827)
+## [ExcelDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1847-L1859)
 
 *Bases*: zillion.datasource.AdHocDataTable
 
@@ -38,7 +38,7 @@
     :members: get_dataframe table_exists to_sql
 
 
-## [GoogleSheetsDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1857-L1879)
+## [GoogleSheetsDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1889-L1911)
 
 *Bases*: zillion.datasource.AdHocDataTable
 
@@ -47,7 +47,7 @@
     :members: get_dataframe table_exists to_sql
 
 
-## [HTMLDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1841-L1854)
+## [HTMLDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1873-L1886)
 
 *Bases*: zillion.datasource.AdHocDataTable
 
@@ -56,7 +56,7 @@
     :members: get_dataframe table_exists to_sql
 
 
-## [JSONDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1830-L1838)
+## [JSONDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1862-L1870)
 
 *Bases*: zillion.datasource.AdHocDataTable
 
@@ -65,7 +65,7 @@
     :members: get_dataframe table_exists to_sql
 
 
-## [Join](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L314-L424)
+## [Join](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L341-L451)
 
 *Bases*: tlbx.logging_utils.PrintMixin
 
@@ -74,7 +74,7 @@
     :members: add_field add_fields add_join_part_tables combine get_covered_fields join_fields_for_table join_parts_for_table
 
 
-## [JoinPart](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L304-L311)
+## [JoinPart](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L331-L338)
 
 *Bases*: tlbx.logging_utils.PrintMixin
 
@@ -83,7 +83,7 @@
 
 
 
-## [NeighborTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L457-L464)
+## [NeighborTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L484-L491)
 
 *Bases*: tlbx.logging_utils.PrintMixin
 
@@ -92,7 +92,7 @@
 
 
 
-## [SQLiteDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1786-L1799)
+## [SQLiteDataTable](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1818-L1831)
 
 *Bases*: zillion.datasource.AdHocDataTable
 
@@ -101,7 +101,7 @@
     :members: get_dataframe table_exists to_sql
 
 
-## [TableSet](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L253-L301)
+## [TableSet](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L280-L328)
 
 *Bases*: tlbx.logging_utils.PrintMixin
 
@@ -110,79 +110,85 @@
     :members: get_covered_fields get_covered_metrics
 
 
-## [connect_url_to_metadata](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L70-L79)
+## [connect_url_to_metadata](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L88-L101)
 
 ::: zillion.datasource.connect_url_to_metadata
     :docstring:
 
 
-## [data_url_to_metadata](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L110-L139)
+## [data_url_to_metadata](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L132-L166)
 
 ::: zillion.datasource.data_url_to_metadata
     :docstring:
 
 
-## [datatable_from_config](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1882-L1928)
+## [datatable_from_config](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L1914-L1960)
 
 ::: zillion.datasource.datatable_from_config
     :docstring:
 
 
-## [entity_name_from_file](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L53-L54)
+## [entity_name_from_file](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L56-L57)
 
 ::: zillion.datasource.entity_name_from_file
     :docstring:
 
 
-## [get_adhoc_datasource_filename](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L192-L195)
+## [get_adhoc_datasource_filename](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L219-L222)
 
 ::: zillion.datasource.get_adhoc_datasource_filename
     :docstring:
 
 
-## [get_adhoc_datasource_url](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L198-L200)
+## [get_adhoc_datasource_url](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L225-L227)
 
 ::: zillion.datasource.get_adhoc_datasource_url
     :docstring:
 
 
-## [get_ds_config_context](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L57-L59)
+## [get_ds_config_context](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L60-L62)
 
 ::: zillion.datasource.get_ds_config_context
     :docstring:
 
 
-## [join_from_path](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L427-L454)
+## [get_engine_extra_kwargs](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L73-L85)
+
+::: zillion.datasource.get_engine_extra_kwargs
+    :docstring:
+
+
+## [join_from_path](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L454-L481)
 
 ::: zillion.datasource.join_from_path
     :docstring:
 
 
-## [metadata_from_connect](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L142-L162)
+## [metadata_from_connect](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L169-L189)
 
 ::: zillion.datasource.metadata_from_connect
     :docstring:
 
 
-## [parse_replace_after](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L82-L107)
+## [parse_replace_after](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L104-L129)
 
 ::: zillion.datasource.parse_replace_after
     :docstring:
 
 
-## [populate_url_context](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L62-L67)
+## [populate_url_context](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L65-L70)
 
 ::: zillion.datasource.populate_url_context
     :docstring:
 
 
-## [reflect_metadata](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L165-L189)
+## [reflect_metadata](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L192-L216)
 
 ::: zillion.datasource.reflect_metadata
     :docstring:
 
 
-## [url_connect](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L203-L250)
+## [url_connect](https://github.com/totalhack/zillion/blob/master/zillion/datasource.py#L230-L277)
 
 ::: zillion.datasource.url_connect
     :docstring:

docs/mkdocs/zillion.nlp.md

@@ -2,38 +2,6 @@
 # Module zillion.nlp
 
 
-## [EmbeddingsAPI](https://github.com/totalhack/zillion/blob/master/zillion/nlp.py#L323-L551)
-
-::: zillion.nlp.EmbeddingsAPI
-    :docstring:
-    :members: add_texts connect create_collection_if_necessary delete_collection delete_embeddings embed_documents embed_query ensure_client get_collection get_embeddings recreate_collection similarity_search_with_score upsert_embedding
-
-
-## [EmbeddingsCache](https://github.com/totalhack/zillion/blob/master/zillion/nlp.py#L57-L205)
-
-::: zillion.nlp.EmbeddingsCache
-    :docstring:
-    :members: decode encode get_text_hash init_cache
-
-
-## [OpenAIEmbeddingsCached](https://github.com/totalhack/zillion/blob/master/zillion/nlp.py#L207-L242)
-
-*Bases*: langchain.embeddings.openai.OpenAIEmbeddings
-
-::: zillion.nlp.OpenAIEmbeddingsCached
-    :docstring:
-    :members: embed_documents embed_query
-
-
-## [QdrantCustom](https://github.com/totalhack/zillion/blob/master/zillion/nlp.py#L244-L321)
-
-*Bases*: langchain.vectorstores.qdrant.Qdrant
-
-::: zillion.nlp.QdrantCustom
-    :docstring:
-    :members: add_texts get_id similarity_search_with_score
-
-
 ## [build_chain](https://github.com/totalhack/zillion/blob/master/zillion/nlp.py#L708-L733)
 
 ::: zillion.nlp.build_chain

zillion/version.py

@@ -1,3 +1,3 @@
 """Package version"""
 
-__version__ = "0.13.0"
+__version__ = "0.13.1"