Update Connection.py

.github/DISCUSSION_TEMPLATE/build-issue.yml

@@ -0,0 +1,49 @@
+title: "[Build] "
+body:
+  - type: input
+    id: os
+    attributes:
+      label: What OS and which version do you use?
+      description: |
+        e.g.
+        - Windows 11
+        - macOS 13.4
+        - Ubuntu 22.04
+
+  - type: textarea
+    id: libmysqlclient
+    attributes:
+      label: How did you installed mysql client library?
+      description: |
+        e.g.
+        - `apt-get install libmysqlclient-dev`
+        - `brew install mysql-client`
+        - `brew install mysql`
+      render: bash
+
+  - type: textarea
+    id: pkgconfig-output
+    attributes:
+      label: Output from `pkg-config --cflags --libs mysqlclient`
+      description: If you are using mariadbclient, run `pkg-config --cflags --libs mariadb` instead.
+      render: bash
+
+  - type: input
+    id: mysqlclient-install
+    attributes:
+      label: How did you tried to install mysqlclient?
+      description: |
+        e.g.
+        - `pip install mysqlclient`
+        - `poetry add mysqlclient`
+
+  - type: textarea
+    id: mysqlclient-error
+    attributes:
+      label: Output of building mysqlclient
+      description: not only error message. full log from start installing mysqlclient.
+      render: bash
+
+
+
+

.github/DISCUSSION_TEMPLATE/issue-report.yml

@@ -0,0 +1,93 @@
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Failed to buid? [Use this form](https://github.com/PyMySQL/mysqlclient/discussions/new?category=build-issue).
+
+        We don't use this issue tracker to help users.
+        Please use this tracker only when you are sure about it is an issue of this software.
+
+        If you had trouble, please ask it on some user community.
+
+        - [Python Discord](https://www.pythondiscord.com/)
+          For general Python questions, including developing application using MySQL.
+
+        - [MySQL Community Slack](https://lefred.be/mysql-community-on-slack/)
+          For general MySQL questions.
+
+        - [mysqlclient Discuss](https://github.com/PyMySQL/mysqlclient/discussions)
+          For mysqlclient specific topics.
+
+  - type: textarea
+    id: describe
+    attributes:
+      label: Describe the bug
+      description: "A **clear and concise** description of what the bug is."
+
+  - type: textarea
+    id: environments
+    attributes:
+      label: Environment
+      description: |
+        - Server and version (e.g. MySQL 8.0.33, MariaDB 10.11.4)
+        - OS (e.g. Windows 11, Ubuntu 22.04, macOS 13.4.1)
+        - Python version
+
+  - type: input
+    id: libmysqlclient
+    attributes:
+      label: How did you install libmysqlclient libraries?
+      description: |
+        e.g. brew install mysql-cleint, brew install mariadb, apt-get install libmysqlclient-dev
+
+  - type: input
+    id: mysqlclient-version
+    attributes:
+      label: What version of mysqlclient do you use?
+
+  - type: markdown
+    attributes:
+      value: |
+        ## Complete step to reproduce.
+        #
+        Do not expect maintainer complement any piece of code, schema, and data need to reproduce.
+        You need to provide **COMPLETE** step to reproduce.
+
+        It is very recommended to use Docker to start MySQL server.
+        Maintainer can not use your Database to reproduce your issue.
+
+        **If you write only little code snippet, maintainer may close your issue
+        without any comment.**
+
+  - type: textarea
+    id: reproduce-docker
+    attributes:
+      label: Docker command to start MySQL server
+      render: bash
+      description: e.g. `docker run -e MYSQL_ALLOW_EMPTY_PASSWORD=yes -p 3306:3306 --rm --name mysql mysql:8.0`
+
+  - type: textarea
+    id: reproduce-code
+    attributes:
+      label: Minimum but complete code to reproduce
+      render: python
+      value: |
+        # Write Python code here.
+        import MySQLdb
+
+        conn = MySQLdb.connect(host='127.0.0.1', port=3306, user='root')
+        ...
+
+  - type: textarea
+    id: reproduce-schema
+    attributes:
+      label: Schema and initial data required to reproduce.
+      render: sql
+      value: |
+        -- Write SQL here.
+        -- e.g. CREATE TABLE ...
+
+  - type: textarea
+    id: reproduce-other
+    attributes:
+      label: Commands, and any other step required to reproduce your issue.

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,12 @@
+contact_links:
+  - name: Failed to build
+    about: Ask help for build error.
+    url: "https://github.com/PyMySQL/mysqlclient/discussions/new?category=build-issue"
+
+  - name: Report issue
+    about: Found bug?
+    url: "https://github.com/PyMySQL/mysqlclient/discussions/new?category=issue-report"
+
+  - name: Ask question
+    about: Ask other questions.
+    url: "https://github.com/PyMySQL/mysqlclient/discussions/new?category=q-a"

.github/workflows/lint.yaml

@@ -1,17 +1,15 @@
 name: Lint
 
-on: [push, pull_request]
+on:
+  push:
+    branches: ["main"]
+  pull_request:
 
 jobs:
   lint:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-      - uses: actions/setup-python@v2
-      - uses: psf/black@stable
-      - name: Setup flake8 annotations
-        uses: rbialon/flake8-annotations@v1
-      - name: flake8
-        run: |
-          pip install flake8
-          flake8 --ignore=E203,E501,W503 --max-line-length=88 .
+      - uses: actions/checkout@v4
+      - run: pipx install ruff
+      - run: ruff check src/
+      - run: ruff format src/

.github/workflows/tests.yaml

@@ -2,48 +2,109 @@ name: Test
 
 on:
   push:
+    branches: ["main"]
   pull_request:
 
 jobs:
-  build:
-    runs-on: ubuntu-20.04
+  test:
+    runs-on: ubuntu-latest
+    env:
+      PIP_NO_PYTHON_VERSION_WARNING: 1
+      PIP_DISABLE_PIP_VERSION_CHECK: 1
     strategy:
       matrix:
-        python-version: ["3.6", "3.7", "3.8", "3.9", "3.10"]
+        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12"]
+        include:
+          - python-version: "3.11"
+            mariadb: 1
     steps:
-      - name: Start MySQL
+      - if: ${{ matrix.mariadb }}
+        name: Start MariaDB
+        # https://github.com/actions/runner-images/blob/9d9b3a110dfc98100cdd09cb2c957b9a768e2979/images/linux/scripts/installers/mysql.sh#L10-L13
+        run: |
+          docker pull mariadb:10.11
+          docker run -d -e MARIADB_ROOT_PASSWORD=root -p 3306:3306 --rm --name mariadb mariadb:10.11
+          sudo apt-get -y install libmariadb-dev
+          mysql --version
+          mysql -uroot -proot -h127.0.0.1 -e "CREATE DATABASE mysqldb_test"
+
+      - if: ${{ !matrix.mariadb }}
+        name: Start MySQL
         run: |
           sudo systemctl start mysql.service
+          mysql --version
           mysql -uroot -proot -e "CREATE DATABASE mysqldb_test"
 
-      - uses: actions/cache@v2
-        with:
-          path: ~/.cache/pip
-          key: ${{ runner.os }}-pip-1
-          restore-keys: |
-            ${{ runner.os }}-pip-
-
-      - uses: actions/checkout@v2
-        with:
-          fetch-depth: 2
+      - uses: actions/checkout@v4
 
       - name: Set up Python ${{ matrix.python-version }}
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+          cache: "pip"
+          cache-dependency-path: "requirements.txt"
+          allow-prereleases: true
 
-      - name: Install dependencies
-        env:
-          PIP_NO_PYTHON_VERSION_WARNING: 1
-          PIP_DISABLE_PIP_VERSION_CHECK: 1
+      - name: Install mysqlclient
         run: |
-          pip install -U coverage pytest pytest-cov
-          python setup.py develop
+          pip install -v .
 
+      - name: Install test dependencies
+        run: |
+          pip install -r requirements.txt
+
       - name: Run tests
         env:
           TESTDB: actions.cnf
         run: |
           pytest --cov=MySQLdb tests
 
-      - uses: codecov/codecov-action@v1
+      - uses: codecov/codecov-action@v4
+
+  django-test:
+    name: "Run Django LTS test suite"
+    needs: test
+    runs-on: ubuntu-latest
+    env:
+      PIP_NO_PYTHON_VERSION_WARNING: 1
+      PIP_DISABLE_PIP_VERSION_CHECK: 1
+      DJANGO_VERSION: "3.2.19"
+    steps:
+      - name: Start MySQL
+        run: |
+          sudo systemctl start mysql.service
+          mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -uroot -proot mysql
+          mysql -uroot -proot -e "set global innodb_flush_log_at_trx_commit=0;"
+          mysql -uroot -proot -e "CREATE USER 'scott'@'%' IDENTIFIED BY 'tiger'; GRANT ALL ON *.* TO scott;"
+          mysql -uroot -proot -e "CREATE DATABASE django_default; CREATE DATABASE django_other;"
+
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          # Django 3.2.9+ supports Python 3.10
+          # https://docs.djangoproject.com/ja/3.2/releases/3.2/
+          python-version: "3.10"
+          cache: "pip"
+          cache-dependency-path: "ci/django-requirements.txt"
+
+      - name: Install mysqlclient
+        run: |
+          #pip install -r requirements.txt
+          #pip install mysqlclient  # Use stable version
+          pip install .
+
+      - name: Setup Django
+        run: |
+          sudo apt-get install libmemcached-dev
+          wget https://github.com/django/django/archive/${DJANGO_VERSION}.tar.gz
+          tar xf ${DJANGO_VERSION}.tar.gz
+          cp ci/test_mysql.py django-${DJANGO_VERSION}/tests/
+          cd django-${DJANGO_VERSION}
+          pip install . -r tests/requirements/py3.txt
+
+      - name: Run Django test
+        run: |
+          cd django-${DJANGO_VERSION}/tests/
+          PYTHONPATH=.. python3 ./runtests.py --settings=test_mysql