Make markdown links relative and adjust package dependencies slightly

Pipfile

@@ -5,10 +5,10 @@ verify_ssl = true
 
 [packages]
 # Also need to be added to setup.py
-pydantic = "~= 1.9.1"
-requests = "~= 2.28.0"
-typer = "~= 0.4.2"
-google-cloud-storage = "~= 2.4.0"
+pydantic = "~= 1.9"
+requests = "~= 2.28"
+typer = "~= 0.4"
+google-cloud-storage = "~= 2.4"
 rich = "~= 13.3"
 
 [dev-packages]

README.md

@@ -30,11 +30,19 @@ More information can be found on the package's [README](src/dbttoolkit/dbt_cloud
 
 ## Installation
 
-This project requires Python 3.8+. You can install the latest version of this package from PyPI by running the 
+This project requires Python 3.8+. You can install the latest version of this package from PyPI by running the
 command below.
 
 ```shell
 $ pip install dbt-toolkit
+
+```
+
+Including dbt-cloud and google cloud bucket support
+
+```shell
+$ pip install dbt-toolkit[cloud-support]
+
 ```
 
 ## Development

setup.py

@@ -35,10 +35,14 @@
     python_requires=">=3.8, <4",
     setup_requires=["wheel", "setuptools_scm"],
     install_requires=[
-        "requests ~= 2.28.0",
-        "typer ~= 0.4.2",
-        "google-cloud-storage ~= 2.4.0",
-        "pydantic ~= 1.9.1",
-        "rich ~= 13.3.5",
+        "typer ~= 0.4",
+        "pydantic ~= 1.9",
+        "rich ~= 13.3",
     ],
+    extras_require={
+        "cloud-support": [
+            "google-cloud-storage ~= 2.4",
+            "requests ~= 2.28",
+        ]
+    },
 )

src/dbttoolkit/documentation/presentation/formatters.py

@@ -9,7 +9,7 @@ def format_node_link_in_markdown(node_id: str) -> str:
     """
     node_type = node_id.split(".")[0]
 
-    return f"[{node_id}](/#!/{node_type}/{node_id})"
+    return f"[{node_id}](#!/{node_type}/{node_id})"
 
 
 def format_upstream_descriptions_to_human_readable(descriptions_from_upstream: ColumnDescriptionWithSource) -> str:

tests/documentation/actions/test_propagate.py

@@ -25,7 +25,7 @@ def test_propagation_1_level(transformed_artifact: Mapping):
     assert (
         description == "Name column of the user table in the source. "
         "[propagated from [source.dbt_sample_project.raw.user]"
-        "(/#!/source/source.dbt_sample_project.raw.user)]"
+        "(#!/source/source.dbt_sample_project.raw.user)]"
     )
 
 
@@ -39,7 +39,7 @@ def test_propagation_2_level(transformed_artifact: Mapping):
     assert (
         description == "Name column of the user table in the source. "
         "[propagated from [source.dbt_sample_project.raw.user]"
-        "(/#!/source/source.dbt_sample_project.raw.user)]"
+        "(#!/source/source.dbt_sample_project.raw.user)]"
     )
 
 
@@ -63,7 +63,7 @@ def test_alias(transformed_artifact: Mapping):
     assert (
         propagated_description
         == original_description
-        + " [propagated from [source.dbt_sample_project.raw.user](/#!/source/source.dbt_sample_project.raw.user)]"
+        + " [propagated from [source.dbt_sample_project.raw.user](#!/source/source.dbt_sample_project.raw.user)]"
     )
 
 
@@ -77,11 +77,11 @@ def test_2_parents(transformed_artifact: Mapping):
     expected = (
         "Name column of the city table in the source. "
         "[propagated from [source.dbt_sample_project.raw.city]"
-        "(/#!/source/source.dbt_sample_project.raw.city)]"
+        "(#!/source/source.dbt_sample_project.raw.city)]"
         "\n\n"
         "Name column of the user table in the source. "
         "[propagated from [source.dbt_sample_project.raw.user]"
-        "(/#!/source/source.dbt_sample_project.raw.user)]"
+        "(#!/source/source.dbt_sample_project.raw.user)]"
     )
 
     assert description == expected

tests/documentation/presentation/test_formatters.py

@@ -14,11 +14,11 @@
     [
         (
             "model.project.model_path.model_name",
-            "[model.project.model_path.model_name](/#!/model/model.project.model_path.model_name)",
+            "[model.project.model_path.model_name](#!/model/model.project.model_path.model_name)",
         ),
         (
             "source.project.source_path.source_name",
-            "[source.project.source_path.source_name](/#!/source/source.project.source_path.source_name)",
+            "[source.project.source_path.source_name](#!/source/source.project.source_path.source_name)",
         ),
     ],
     ids=["model", "source"],