chore(docs-generator): Add gfm formatters. (#257)

PR: #257

.github/workflows/generate-sdk.yaml

@@ -58,6 +58,21 @@ jobs:
           cp "../generator/package/expediagroup/sdk/$namespace/model.py" "./temp/expediagroup/sdk/$namespace/model.py"
 
           python3 ./__main__.py -p ./temp -n "$namespace"
+      - name: Install Pandoc
+        run: |
+          pip3 install lastversion
+
+          architecture="$(dpkg --print-architecture)"
+          lastversion --assets --filter "$architecture.deb" download https://github.com/jgm/pandoc
+
+          sudo dpkg -i "$(ls | grep 'pandoc-.*\.deb')"
+      - name: Format docs
+        working-directory: expediagroup/sdk/docsgen/docs
+        run: |
+          source ../env/bin/activate
+          npx prettier --write --parser markdown *.md
+          for file in *.md; do pandoc "$file" -f markdown -t gfm -o "${file%.md}.md"; done
+          mdformat .
       - uses: actions/upload-artifact@v3
         with:
           name: sdk

expediagroup/sdk/docsgen/templates/class.jinja2

@@ -1,6 +1,6 @@
 {{ breadcrumbs }}
 # class `{{ module.name }}.{{ class.name }}`
-```
+```python
 {{ class.constructor.name }}({% for arg in class.constructor.arguments %}
     {{ arg.name }}: {{ arg.datatype }},{% endfor %}
 )
@@ -29,7 +29,7 @@
 ## Methods
 {% for method in class.methods %}
 ### {{ method.name }}
-```
+```python
 {{ method.name }}(
     {% for arg in method.arguments %}{{ arg.name }}: {{ arg.datatype }},
 {% endfor %})

requirements-docs.txt

@@ -5,3 +5,8 @@ typer
 docstring_parser
 jinja2
 mdformat-gfm~=0.3.5
+mdformat-frontmatter~=2.0.1
+mdformat-footnote~=0.1.1
+mdformat-black~=0.1.1
+mdformat-tables~=0.4.1
+mdformat_deflist~=0.1.2