Pull request for the issue 357

.devcontainer/Dockerfile

@@ -0,0 +1,5 @@
+FROM mcr.microsoft.com/devcontainers/anaconda:0-3
+
+# [Optional] Uncomment this section to install additional OS packages.
+# RUN apt-get update && export DEBIAN_FRONTEND=noninteractive \
+#     && apt-get -y install --no-install-recommends <your-package-list-here>

.devcontainer/devcontainer.json

@@ -0,0 +1,23 @@
+// For format details, see https://aka.ms/devcontainer.json. 
+{
+	"name": "Jupyter",
+	"build": { 
+		"context": "..",
+		"dockerfile": "Dockerfile"
+	},
+	"features": {
+		"ghcr.io/devcontainers/features/git:1": {},
+		"ghcr.io/devcontainers/features/github-cli:1": {}
+	},
+	"customizations": {
+		"vscode": {
+			"extensions": [
+				"ms-python.python",
+				"ms-python.vscode-pylance",
+				"ms-toolsai.jupyter",
+				"GitHub.codespaces"
+			]
+		}
+	},
+	"postCreateCommand": "./.devcontainer/postCreate.sh"
+}

.devcontainer/postCreate.sh

@@ -0,0 +1,13 @@
+#!/bin/bash -x
+
+conda init bash
+
+# Perform install instructions from
+# https://ploomber-contributing.readthedocs.io/en/latest/contributing/setup.html
+conda create --name ploomber-base python=3.10 --yes
+conda activate ploomber-base
+pip install pkgmt
+pkgmt setup --doc
+
+# After the devcontainer comes up, you can just enable the jupysql conda env:
+# conda activate jupysql

.github/CODEOWNERS

@@ -0,0 +1,5 @@
+* @edublancas
+
+/.github/ @edublancas
+
+/doc/ @edublancas @neelasha23

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,63 @@
+name: Bug report
+description: Something not working? Create a bug report.
+body:
+  - type: textarea
+    attributes:
+      label: What happens?
+      description: A short, clear and concise description of what the bug is.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: To Reproduce
+      description: Steps to reproduce the behavior. Providing a minimal, reproducible example (you can attach a notebook) is the best way to get your issue resolved quickly.
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: "## Environment"
+
+  - type: input
+    attributes:
+      label: "OS:"
+      placeholder: Linux
+      description: Operating system (e.g. Linux, Windows, macOS)
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: "JupySQL Version:"
+      placeholder: e.g. 0.9.0
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: "To get the version. run: `import sql; print(sql.__version__)`"
+
+  - type: markdown
+    attributes:
+      value: "## Identity Disclosure"
+
+  - type: input
+    attributes:
+      label: "Full Name:"
+      placeholder: e.g. John Doe
+    validations:
+      required: true
+
+  - type: input
+    attributes:
+      label: "Affiliation:"
+      placeholder: e.g. Big Corp
+    validations:
+      required: true
+
+  - type: markdown
+    attributes:
+      value: |
+        If the above is not given and is not obvious from your GitHub profile page, we might close your issue without further review. Please refer to the [reasoning behind this rule](https://berthub.eu/articles/posts/anonymous-help/) if you have questions.
+

.github/pull_request_template.md

@@ -0,0 +1,13 @@
+## Describe your changes
+
+## Issue number
+
+Closes #X
+
+## Checklist before requesting a review
+
+- [ ] Performed a self-review of my code
+- [ ] Formatted my code with [`pkgmt format`](https://ploomber-contributing.readthedocs.io/en/latest/contributing/submitting-pr.html#linting-formatting)
+- [ ] Added [tests](https://ploomber-contributing.readthedocs.io/en/latest/contributing/submitting-pr.html#testing) (when necessary).
+- [ ] Added [docstring](https://ploomber-contributing.readthedocs.io/en/latest/contributing/submitting-pr.html#documenting-changes-and-new-features) documentation and update the [changelog](https://ploomber-contributing.readthedocs.io/en/latest/contributing/submitting-pr.html#changelog) (when needed)
+

.github/workflows/chatops.yml

@@ -0,0 +1,78 @@
+name: bot-format
+
+on:
+  issue_comment:
+    types: [created]
+
+jobs:
+ pkgmt-format:
+   if: contains(github.event.comment.html_url, '/pull/') && contains(github.event.comment.body, '/format') 
+   runs-on: ubuntu-latest
+
+   steps:
+    - uses: xt0rted/pull-request-comment-branch@v2
+      id: comment-branch
+
+    - name: Set latest commit status as pending
+      uses: myrotvorets/set-commit-status-action@master
+      with:
+        sha: ${{ steps.comment-branch.outputs.head_sha }}
+        token: ${{ secrets.GITHUB_TOKEN }}
+        status: pending
+
+    # there's an alternative way to check out:
+    # https://github.com/actions/checkout/issues/331#issuecomment-925405415
+    - name: Checkout PR branch
+      uses: actions/checkout@v3
+      with:
+        ref: ${{ steps.comment-branch.outputs.head_ref }}
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.10'
+
+    - name: format
+      run: |
+        python -m pip install --upgrade pip pkgmt
+
+        # https://github.com/actions/checkout/discussions/479#discussioncomment-625461
+        git config user.name 'github-actions[bot]'
+        git config user.email 'github-actions[bot]@users.noreply.github.com'
+
+        pkgmt format
+
+        if [[ -z $(git status -s) ]]
+        then
+          echo "No changes to commit..."
+        else
+          echo "Committing changes..."
+          git add --all
+          git commit -m 'formattting'
+          git push
+        fi
+
+    - name: Set latest commit status as ${{ job.status }}
+      uses: myrotvorets/set-commit-status-action@master
+      if: always()
+      with:
+        sha: ${{ steps.comment-branch.outputs.head_sha }}
+        token: ${{ secrets.GITHUB_TOKEN }}
+        status: ${{ job.status }}
+
+    - name: Add comment to PR
+      uses: actions/github-script@v6
+      if: always()
+      with:
+        script: |
+          const name = '${{ github.workflow   }}';
+          const url = '${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}';
+          const success = '${{ job.status }}' === 'success';
+          const body = `${name}: ${success ? 'succeeded ✅' : 'failed ❌'}\n${url}`;
+
+          await github.rest.issues.createComment({
+            issue_number: context.issue.number,
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            body: body
+          })

.github/workflows/ci-integration-db.yaml

@@ -0,0 +1,54 @@
+# CI - DB Integration - Local is designed to run integration testing against to databases hosted by docker containers
+# Target database: PostgreSQL, MySQL, MariaDB, SQLite, DuckDB, MSSQL, Oracle Database
+# Sqlalchemy version: 2+
+name: CI - DB Integration - Local
+on:
+  workflow_call:
+
+jobs:
+  database-integration-test:
+    strategy:
+      matrix:
+        python-version: ['3.11']
+        os: [ubuntu-latest]
+    runs-on: ${{ matrix.os }}
+
+    env:
+      PLOOMBER_VERSION_CHECK_DISABLED: true
+      PYTHON_VERSION: ${{ matrix.python-version }}
+
+    steps:
+
+      - name: Checkout
+        uses: actions/checkout@v2
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          # Install MSSQL ODBC 18
+          curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
+          sudo curl -o /etc/apt/sources.list.d/mssql-release.list https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list 
+          sudo apt-get update
+          sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18
+          sudo ACCEPT_EULA=Y apt-get install -y mssql-tools18
+          echo 'export PATH="$PATH:/opt/mssql-tools18/bin"' >> ~/.bashrc
+          source ~/.bashrc
+
+          python -m pip install --upgrade pip
+          python -m pip install --upgrade nox
+          nox --session test_integration --install-only
+
+      - name: Integration Test
+        run: |
+          nox --session test_integration --no-install --reuse-existing-virtualenvs
+
+      - name: Upload failed images artifacts
+        uses: actions/upload-artifact@v3
+        if: failure()
+        with:
+          name: failed-image-artifacts-integration ${{ matrix.os }} ${{ matrix.python-version }}
+          path: result_images/