Merge code from upstream repo

.coveragerc

@@ -0,0 +1,13 @@
+# https://pytest-cov.readthedocs.io/
+
+[run]
+source = semver
+branch = True
+
+[report]
+show_missing = true
+precision = 1
+exclude_lines =
+    pragma: no cover
+    if __name__ == .__main__.:
+    if not hasattr\(__builtins__, .cmp.\):

.editorconfig

@@ -0,0 +1,16 @@
+# http://editorconfig.org
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+max_line_length = 99
+
+[*.py]
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+[docs/Makefile]
+indent_style = tab

.github/ISSUE_TEMPLATE/bug_report.yaml

@@ -0,0 +1,88 @@
+name: 🐞Bug report
+description: Create a bug report to help us improve
+# title: ''
+labels: [bug]
+assignees: [tomschr]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks a lot for taking the time to fill out this bug report! 🐛
+        It will help us to improve the project for everyone. 🌟
+
+        Find help from the community on our [GitHub Discussions](https://github.com/python-semver/python-semver/discussions) page or
+        on our [Documentation](https://python-semver.readthedocs.io/en/latest/).
+
+  - type: dropdown
+    id: python_version
+    attributes:
+      label: Which version of Python is the problem with?
+      multiple: true
+      options:
+        - "3.7"
+        - "3.8"
+        - "3.9"
+        - "3.10"
+        - "3.11"
+        - "3.12"
+        - "3.13"
+        - "3.14"
+    validations:
+      required: true
+
+  - type: input
+    id: semver_version
+    attributes:
+      label: What semver version are you using?
+      description: You can find this with `pip show semver`
+      placeholder: 3.0.2
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: What OS are you using? (Add more in the Environment section)
+      multiple: true
+      options:
+        - Linux
+        - Windows
+        - macOS
+        - Other
+
+  - type: textarea
+    id: situation
+    attributes:
+      label: Situation
+      description: A clear and concise description of what the bug is.
+      placeholder: Describe the problem you see...
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduction_steps
+    attributes:
+      label: How to reproduce
+      description: |
+        Steps to reproduce the behavior:
+        1. Run '...'
+        2. Scroll down to '....'
+        3. See error
+      placeholder: Describe the steps to reproduce the issue...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_behavior
+    attributes:
+      label: Expected behavior
+      description: A clear and concise description of what you expected to happen.
+      placeholder: Describe the expected behavior...
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Optionally provide some more details about your environment.
+      placeholder: Describe your environment...

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Community Support
+    url: https://github.com/python-semver/python-semver/discussions
+    about: Ask and answer questions in our discussion forum.
+  - name: Documentation
+    url: https://python-semver.readthedocs.io/
+    about: Find more information in our documentation.

.github/ISSUE_TEMPLATE/feature_request.yaml

@@ -0,0 +1,36 @@
+name: Feature request
+description: Suggest an idea for this project
+# title: ''
+labels: [enhancement]
+assignees: [tomschr]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this feature request!
+
+  - type: textarea
+    id: situation
+    attributes:
+      label: Situation
+      description: A clear and concise description of what the feature is. Ex. I'm always frustrated when [...]
+      placeholder: Describe the situation...
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_solution
+    attributes:
+      label: Expected solution
+      description: A clear and concise description of what you want to happen.
+      placeholder: Describe the expected solution...
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives
+      description: A clear and concise description of any alternative solutions or features you've considered.
+      placeholder: Describe any alternatives...

.github/dependabot.yml

@@ -0,0 +1,18 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "pip" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"
+      day: "friday"
+    labels:
+       - "enhancement"
+    commit-message:
+       prefix: "pip"
+    # Allow up to 10 open pull requests for pip dependencies
+    open-pull-requests-limit: 5

.github/workflows/codeql-analysis.yml

@@ -0,0 +1,67 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ maint/v2, release/* ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ master ]
+  schedule:
+    - cron: '50 16 * * 5'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'python' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python' ]
+        # Learn more:
+        # https://docs.github.com/en/free-pro-team@latest/github/finding-security-vulnerabilities-and-errors-in-your-code/configuring-code-scanning#changing-the-languages-that-are-analyzed
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+        # queries: ./path/to/local/query, your-org/your-repo/queries@main
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 https://git.io/JvXDl
+
+    # ✏️ If the Autobuild fails above, remove it and uncomment the following three lines
+    #    and modify them (or add more) to build your code if your project
+    #    uses a compiled language
+
+    #- run: |
+    #   make bootstrap
+    #   make release
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3

.github/workflows/python-testing.yml

@@ -0,0 +1,134 @@
+---
+name: Python
+
+# HINT: Sync this paths with the egrep in step check_files
+on:
+  push:
+    branches: [ "master", "main" ]
+    paths:
+      - 'pyproject.toml'
+      - 'setup.cfg'
+      - '**.py'
+      - '.github/workflows/*.yml'
+
+  pull_request:
+    branches: [ "master", "main" ]
+    paths:
+      - 'pyproject.toml'
+      - 'setup.cfg'
+      - '**.py'
+      - '.github/workflows/*.yml'
+
+permissions:
+  contents: read
+
+concurrency:
+  # only cancel in-progress runs of the same workflow
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+
+jobs:
+  check-files:
+    runs-on: ubuntu-latest
+    outputs:
+      can_run: ${{ steps.check_files.outputs.can_run }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: GitHub variables
+        id: gh-vars
+        run: |
+          for var in GITHUB_WORKFLOW GITHUB_ACTION GITHUB_ACTIONS GITHUB_REPOSITORY GITHUB_EVEN_NAME GITHUB_EVENT_PATH GITHUB_WORKSPACE GITHUB_SHA GITHUB_REF GITHUB_HEAD_REF GITHUB_BASE_REF; do
+            echo "$var = ${!var}"
+          done
+
+      - name: Check for file changes
+        id: check_files
+        run: |
+          # ${{ github.event.after }} ${{ github.event.before }}
+          can_run=$(git diff --name-only HEAD~1 HEAD | \
+           egrep -q '.github/workflows/|pyproject.toml|setup.cfg|\.py$' && echo 1 || echo 0)
+          echo "can_run=$can_run"
+          echo "can_run=$can_run" >> $GITHUB_OUTPUT
+
+  skip_test:
+    runs-on: ubuntu-latest
+    needs: check-files
+    timeout-minutes: 2
+    if: ${{ needs.check-files.outputs.can_run == '0' }}
+
+    steps:
+      - name: Skip test
+        run: |
+          echo "Nothing to do as no TOML, Python, or YAML file has been changed.
+          "
+          echo "Skipping."
+
+  check:
+    runs-on: ubuntu-latest
+    needs: check-files
+    timeout-minutes: 15
+    # needs.check-files.outputs.can_run
+    if: ${{ needs.check-files.outputs.can_run == '1' }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python 3.7
+        # check tox.ini for the lowest version
+        run: uv python install 3.7
+
+      - name: Install the project
+        run: |
+          uv sync --all-extras --group gh-action
+
+      - name: Checks
+        continue-on-error: true
+        run: uv run tox run -e checks
+
+  tests:
+    needs: check
+    runs-on: ${{ matrix.os }}
+    # continue-on-error: true
+    strategy:
+      max-parallel: 5
+      fail-fast: true
+      matrix:
+        python-version: ["3.7",
+                         "3.8",
+                         "3.9",
+                         "3.10",
+                         "3.11",
+                         "3.12",
+                         "3.13",
+                         ]
+        os: ["ubuntu-latest", "macos-latest"]
+        exclude:
+           - os: "macos-latest"
+             python-version: "3.7"
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install the project
+        run: |
+          uv sync --all-extras --dev
+          uv pip install tox tox-gh-actions
+
+      - name: Checks
+        run: uv run tox run -e ${{ matrix.python-version }}