coverage 3.6__tar.gz → 7.12.0__tar.gz

coverage-7.12.0/.editorconfig

@@ -0,0 +1,53 @@
+# Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0
+# For details: https://github.com/coveragepy/coveragepy/blob/main/NOTICE.txt
+
+# This file is for unifying the coding style for different editors and IDEs.
+# More information at http://EditorConfig.org
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 4
+indent_style = space
+insert_final_newline = true
+max_line_length = 80
+trim_trailing_whitespace = true
+
+[*.py]
+max_line_length = 100
+
+[*.pyi]
+max_line_length = 100
+
+[*.c]
+max_line_length = 100
+
+[*.h]
+max_line_length = 100
+
+[*.{yml,yaml}]
+indent_size = 2
+
+[*.rst]
+max_line_length = 79
+
+[*.tok]
+trim_trailing_whitespace = false
+
+[*_dos.tok]
+end_of_line = crlf
+
+[Makefile]
+indent_style = tab
+indent_size = 8
+
+[*,cover]
+trim_trailing_whitespace = false
+
+[*.diff]
+trim_trailing_whitespace = false
+
+[.git/*]
+trim_trailing_whitespace = false

coverage-7.12.0/.git-blame-ignore-revs

@@ -0,0 +1,39 @@
+# Commits to ignore when doing git-blame.
+
+# 2023-01-05 style: use good style for annotated defaults parameters
+78444f4c06df6a634fa67dd99ee7c07b6b633d9e
+
+# 2023-01-06 style(perf): blacken lab/benchmark.py
+bf6c12f5da54db7c5c0cc47cbf22c70f686e8236
+
+# 2023-03-22 style: use double-quotes
+16abd82b6e87753184e8308c4b2606ff3979f8d3
+b7be64538aa480fce641349d3053e9a84862d571
+
+# 2023-04-01 style: use double-quotes in JavaScript
+b03ab92bae24c54f1d5a98baa3af6b9a18de4d36
+
+# 2023-11-04 style: ruff format igor.py, setup.py, __main__.py
+acb80450d7c033a6ea6e06eb2e74d3590c268435
+
+# 2023-11-20 style: fr"" is better than rf"", for real
+d8daa08b347fe6b7099c437b09d926eb999d0803
+
+# 2023-12-02 style: check_coverage close parens should be on their own line
+5d0b5d4464b84adb6389c8894c207a323edb2b2b
+
+# 2024-02-27 style: fix COM812 Trailing comma missing
+e4e238a9ed8f2ad2b9060247591b4c057c2953bf
+
+# 2024-02-27 style: modernize type hints, a few more f-strings
+401a63bf08bdfd780b662f64d2dfe3603f2584dd
+
+# 2025-08-09 style: ruff check --fix --fixable=I001,Q000 coverage/*.py
+a32cd74bc0aaf0714acaf37beb21c84cbe2ee3ff
+
+# 2025-08-21 chore: `ruff format .`
+82467f72306efdb207af09ace27b6b3ed4c7ad6f
+
+# 2025-11-09 move to the coveragepy org GitHub account
+b33a5e889711d27610433ca0040cab67a9fb01f4
+776f313f5415bc95ea736f6486634c3f9d0b96f4

coverage-7.12.0/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,8 @@
+# Treat each other well
+
+Everyone participating in the coverage.py project, and in particular in the
+issue tracker, pull requests, and social media activity, is expected to treat
+other people with respect and to follow the guidelines articulated in the
+[Python Community Code of Conduct][psf_coc].
+
+[psf_coc]: https://www.python.org/psf/codeofconduct/

coverage-7.12.0/.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: nedbat
+tidelift: pypi/coverage

coverage-7.12.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Report a problem with coverage.py
+title: ''
+labels: bug
+assignees: ''
+
+---
+
+**Describe the bug**
+A clear and concise description of the bug.
+
+**To Reproduce**
+How can we reproduce the problem?  Please *be specific*. Don't link to a failing CI job. Think about the time it will take us to recreate your situation: the easier you make it, the more likely your issue will be addressed.
+
+Answer the questions below:
+1. What version of Python are you using?
+1. What version of coverage.py shows the problem? The output of `coverage debug sys` is helpful.
+1. What versions of what packages do you have installed? The output of `pip freeze` is helpful.
+1. What code shows the problem?  Give us a *specific commit* of a *specific repo* that we can check out. If you've already worked around the problem, please provide a commit before that fix.
+1. What commands should we run to reproduce the problem? *Be specific*. Include everything, even `git clone`, `pip install`, and so on. Explain like we're five!
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Additional context**
+Add any other context about the problem here.

coverage-7.12.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,13 @@
+# Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0
+# For details: https://github.com/coveragepy/coveragepy/blob/main/NOTICE.txt
+
+# https://help.github.com/en/github/building-a-strong-community/configuring-issue-templates-for-your-repository
+
+blank_issues_enabled: false
+contact_links:
+  - name: Frequently Asked Questions
+    url: https://coverage.readthedocs.io/en/latest/faq.html
+    about: Some common problems are described here.
+  - name: Tidelift security contact
+    url: https://tidelift.com/security
+    about: Please report security vulnerabilities here.

coverage-7.12.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,20 @@
+---
+name: Feature request
+about: Suggest an idea for coverage.py
+title: ''
+labels: enhancement
+assignees: ''
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context about the feature request here.

coverage-7.12.0/.github/ISSUE_TEMPLATE/support.md

@@ -0,0 +1,26 @@
+---
+name: Support request
+about: Ask for help using coverage.py
+title: ''
+labels: support
+assignees: ''
+
+---
+
+**Have you asked elsewhere?**
+
+There are other good places to ask for help using coverage.py. These places let
+other people suggest solutions, are more likely places for people to find your
+question:
+
+- [Stack Overflow](https://stackoverflow.com/questions/tagged/coverage.py)
+- [discuss.python.org](https://discuss.python.org/search?q=coverage.py)
+
+**Describe your situation**
+
+Wherever you ask your question, be sure to explain:
+
+- What you did
+- What happened
+- How that was different than what you wanted to happen
+- What kind of help you need

coverage-7.12.0/.github/SECURITY.md

@@ -0,0 +1,4 @@
+# Security Disclosures
+
+To report a security vulnerability, please use the [Tidelift security contact](https://tidelift.com/security).
+Tidelift will coordinate the fix and disclosure with maintainers.

coverage-7.12.0/.github/dependabot.yml

@@ -0,0 +1,18 @@
+# From:
+# https://docs.github.com/en/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/keeping-your-actions-up-to-date-with-dependabot
+# Set update schedule for GitHub Actions
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions once a week
+      interval: "weekly"
+      day: "sunday"
+    groups:
+      action-dependencies:
+        patterns:
+          - "*"
+    commit-message:
+      prefix: "chore"

coverage-7.12.0/.github/workflows/codeql-analysis.yml

@@ -0,0 +1,83 @@
+# 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:
+      - main
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches:
+      - main
+  schedule:
+    - cron: '30 20 * * 6'
+
+permissions:
+  contents: read
+
+concurrency:
+  group: "${{ github.workflow }}-${{ github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read           # CodeQL wrote this action.
+      contents: read
+      security-events: write  # CodeQL wrote this action.
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language:
+          - python
+          - javascript
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Learn more about CodeQL language support at https://git.io/codeql-language-support
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      # Initializes the CodeQL tools for scanning.
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@014f16e7ab1402f30e7c3329d33797e7948572db # v4.31.3
+        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@014f16e7ab1402f30e7c3329d33797e7948572db # v4.31.3
+
+      # ℹ️ 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@014f16e7ab1402f30e7c3329d33797e7948572db # v4.31.3

coverage-7.12.0/.github/workflows/coverage.yml

@@ -0,0 +1,330 @@
+# Licensed under the Apache License: http://www.apache.org/licenses/LICENSE-2.0
+# For details: https://github.com/coveragepy/coveragepy/blob/main/NOTICE.txt
+
+name: "Coverage"
+
+on:
+  # As currently structured, this adds too many jobs (checks?), so don't run it
+  # on pull requests yet.
+  push:
+    branches:
+      - main
+      - "**/*metacov*"
+  workflow_dispatch:
+
+defaults:
+  run:
+    shell: bash
+
+env:
+  PIP_DISABLE_PIP_VERSION_CHECK: 1
+  COVERAGE_IGOR_VERBOSE: 2
+  FORCE_COLOR: 1    # Get colored pytest output
+
+permissions:
+  contents: read
+
+concurrency:
+  group: "${{ github.workflow }}-${{ github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  changed:
+    name: "Check changed files"
+    runs-on: ubuntu-latest
+    permissions:
+      pull-requests: read   # Needed for this check to run on pull requests
+    outputs:
+      run_coverage: ${{ steps.filter.outputs.run_coverage }}
+      workflow: ${{ steps.filter.outputs.workflow }}
+    steps:
+      - name: "Check out the repo"
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: "Examine changed files"
+        uses: dorny/paths-filter@de90cc6fb38fc0963ad72b210f1f284cd68cea36 # v3.0.2
+        id: filter
+        with:
+          filters: |
+            run_coverage:
+              - "*.py"
+              - "coverage/**.py"
+              - "tests/**.py"
+              - "**.h"
+              - "**.c"
+              - ".github/workflows/coverage.yml"
+              - "tox.ini"
+              - "metacov.ini"
+              - "requirements/*.pip"
+              - "tests/gold/**"
+
+  coverage:
+    name: "${{ matrix.python-version }} on ${{ matrix.os }}"
+    runs-on: "${{ matrix.os }}-${{ matrix.os-version || 'latest' }}"
+    timeout-minutes: 10
+
+    # Only run coverage if Python files or this workflow changed.
+    needs: changed
+    if: ${{ needs.changed.outputs.run_coverage == 'true' }}
+
+    env:
+      MATRIX_ID: "${{ matrix.python-version }}.${{ matrix.os }}"
+      TOX_GH_MAJOR_MINOR: "${{ matrix.python-version }}"
+
+    strategy:
+      matrix:
+        os:
+          - ubuntu
+          - macos
+          - windows
+        python-version:
+          # When changing this list, be sure to check the [gh] list in
+          # tox.ini so that tox will run properly. PYVERSIONS
+          # Available versions:
+          # https://github.com/actions/python-versions/blob/main/versions-manifest.json
+          - "3.10"
+          - "3.11"
+          - "3.12"
+          - "3.13"
+          - "3.13t"
+          - "3.14"
+          - "3.14t"
+          - "3.15"
+          - "3.15t"
+          - "pypy-3.10"
+          - "pypy-3.11"
+        exclude:
+          # Mac PyPy always takes the longest, and doesn't add anything.
+          - os: macos
+            python-version: "pypy-3.10"
+          - os: macos
+            python-version: "pypy-3.11"
+          # Windows pypy 3.10 gets stuck with PyPy 7.3.15.  I hope to
+          # unstick them, but I don't want that to block all other progress, so
+          # skip them for now.
+          - os: windows
+            python-version: "pypy-3.10"
+        # If we need to tweak the os version we can do it with an include like
+        # this:
+        #  include:
+        #    - python-version: "3.12"
+        #      os: "macos"
+        #      os-version: "15"
+
+      # If one job fails, stop the whole thing.
+      fail-fast: true
+
+    steps:
+      - name: "Check out the repo"
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: "Set up Python"
+        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        with:
+          python-version: "${{ matrix.python-version }}"
+          allow-prereleases: true
+          # At a certain point, installing dependencies failed on pypy 3.9 and
+          # 3.10 on Windows.  Commenting out the cache here fixed it.  Someday
+          # try using the cache again.
+          #cache: pip
+          #cache-dependency-path: 'requirements/*.pip'
+
+      - name: "Show environment"
+        run: |
+          set -xe
+          echo matrix id: $MATRIX_ID
+          python -VV
+          python -m site
+          env | sort
+
+      - name: "Install dependencies"
+        run: |
+          set -xe
+          python -m pip install -r requirements/tox.pip
+
+      - name: "Run tox coverage for ${{ matrix.python-version }}"
+        env:
+          COVERAGE_COVERAGE: "yes"
+          COVERAGE_CONTEXT: "${{ env.MATRIX_ID }}"
+        run: |
+          set -xe
+          python -m tox
+
+      - name: "Combine data"
+        env:
+          COVERAGE_RCFILE: "metacov.ini"
+        run: |
+          python -m coverage combine
+          mv .metacov .metacov.$MATRIX_ID
+
+      - name: "Upload coverage data"
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
+        with:
+          name: metacov-${{ env.MATRIX_ID }}
+          path: .metacov.*
+          include-hidden-files: true
+
+  combine:
+    name: "Combine coverage data"
+    needs: coverage
+    runs-on: ubuntu-latest
+    outputs:
+      total: ${{ steps.total.outputs.total }}
+    env:
+      COVERAGE_RCFILE: "metacov.ini"
+
+    steps:
+      - name: "Check out the repo"
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: "Set up Python"
+        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c # v6.0.0
+        with:
+          python-version: "3.10" # Minimum of PYVERSIONS
+          # At a certain point, installing dependencies failed on pypy 3.9 and
+          # 3.10 on Windows.  Commenting out the cache here fixed it.  Someday
+          # try using the cache again.
+          #cache: pip
+          #cache-dependency-path: 'requirements/*.pip'
+
+      - name: "Show environment"
+        run: |
+          set -xe
+          python -VV
+          python -m site
+          env | sort
+
+      - name: "Install dependencies"
+        run: |
+          set -xe
+          python -m pip install -e .
+          python igor.py zip_mods
+
+      - name: "Download coverage data"
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
+        with:
+          pattern: metacov-*
+          merge-multiple: true
+
+      - name: "Combine and report"
+        id: combine
+        env:
+          COVERAGE_CONTEXT: "yes"
+        run: |
+          set -xe
+          python igor.py combine_html
+
+      - name: "Upload HTML report"
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
+        with:
+          name: html_report
+          path: htmlcov
+          include-hidden-files: true
+
+      - name: "Show text report"
+        run: |
+          set -xe
+          echo "## Coverage: $(python -m coverage report --format=total)%" >> $GITHUB_STEP_SUMMARY
+          echo '```' >> $GITHUB_STEP_SUMMARY
+          python -m coverage report --skip-covered >> $GITHUB_STEP_SUMMARY
+          echo '```' >> $GITHUB_STEP_SUMMARY
+
+      - name: "Get total"
+        id: total
+        run: |
+          echo "total=$(python -m coverage report --format=total)" >> $GITHUB_OUTPUT
+
+  publish:
+    name: "Publish coverage report"
+    needs: combine
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: "Show environment"
+        run: |
+          set -xe
+          env | sort
+
+      - name: "Compute info for later steps"
+        id: info
+        env:
+          REF: ${{ github.ref }}
+          SHA: ${{ github.sha }}
+        run: |
+          export SHA10=$(echo $SHA | cut -c 1-10)
+          export SLUG=$(date +'%Y%m%d')_$SHA10
+          echo "sha10=$SHA10" >> $GITHUB_ENV
+          echo "slug=$SLUG" >> $GITHUB_ENV
+          echo "report_dir=reports/$SLUG/htmlcov" >> $GITHUB_ENV
+          echo "url=https://htmlpreview.github.io/?https://github.com/coveragepy/metacov-reports/blob/main/reports/$SLUG/htmlcov/index.html" >> $GITHUB_ENV
+          echo "branch=${REF#refs/heads/}" >> $GITHUB_ENV
+
+      - name: "Checkout reports repo"
+        if: ${{ github.ref == 'refs/heads/main' }}
+        env:
+          TOKEN: ${{ secrets.COVERAGE_REPORTS_TOKEN }}
+        run: |
+          set -xe
+          git clone --depth=1 --no-checkout https://${TOKEN}@github.com/coveragepy/metacov-reports reports_repo
+          cd reports_repo
+          git sparse-checkout init --cone
+          git sparse-checkout set --skip-checks '/*' '!/reports'
+          git config user.name nedbat
+          git config user.email ned@nedbatchelder.com
+          git checkout main
+
+      - name: "Download coverage HTML report"
+        if: ${{ github.ref == 'refs/heads/main' }}
+        uses: actions/download-artifact@018cc2cf5baa6db3ef3c5f8a56943fffe632ef53 # v6.0.0
+        with:
+          name: html_report
+          path: reports_repo/${{ env.report_dir }}
+
+      - name: "Push to report repo"
+        if: |
+          github.repository_owner == 'coveragepy'
+          && github.ref == 'refs/heads/main'
+        env:
+          COMMIT_MESSAGE: ${{ github.event.head_commit.message }}
+          TOTAL: ${{ needs.combine.outputs.total }}
+        run: |
+          set -xe
+          # Make the redirect to the latest report.
+          echo "<html><head>" > reports_repo/latest.html
+          echo "<meta http-equiv='refresh' content='0;url=${url}' />" >> reports_repo/latest.html
+          echo "<body>Coverage report redirect..." >> reports_repo/latest.html
+          # Make the commit message.
+          echo "${TOTAL}% - ${COMMIT_MESSAGE}" > commit.txt
+          echo "" >> commit.txt
+          echo "${url}" >> commit.txt
+          echo "${sha10}: ${branch}" >> commit.txt
+          # Commit.
+          cd ./reports_repo
+          git sparse-checkout set --skip-checks '/*' ${report_dir}
+          rm ${report_dir}/.gitignore
+          git add ${report_dir} latest.html
+          git commit --file=../commit.txt
+          git push
+          echo "[${url}](${url})" >> $GITHUB_STEP_SUMMARY
+
+      - name: "Create badge"
+        if: |
+          github.repository_owner == 'coveragepy'
+          && github.ref == 'refs/heads/main'
+        # https://gist.githubusercontent.com/nedbat/8c6980f77988a327348f9b02bbaf67f5
+        uses: schneegans/dynamic-badges-action@e9a478b16159b4d31420099ba146cdc50f134483 # v1.7.0
+        with:
+          auth: ${{ secrets.METACOV_GIST_SECRET }}
+          gistID: 8c6980f77988a327348f9b02bbaf67f5
+          filename: metacov.json
+          label: Coverage
+          message: ${{ needs.combine.outputs.total }}%
+          minColorRange: 60
+          maxColorRange: 95
+          valColorRange: ${{ needs.combine.outputs.total }}

coverage-7.12.0/.github/workflows/dependency-review.yml

@@ -0,0 +1,39 @@
+# Dependency Review Action
+#
+# This Action will scan dependency manifest files that change as part of a Pull Reqest, surfacing known-vulnerable versions of the packages declared or updated in the PR. Once installed, if the workflow run is marked as required, PRs introducing known-vulnerable packages will be blocked from merging.
+#
+# Source repository: https://github.com/actions/dependency-review-action
+# Public documentation: https://docs.github.com/en/code-security/supply-chain-security/understanding-your-software-supply-chain/about-dependency-review#dependency-review-enforcement
+
+name: 'Dependency Review'
+on:
+  push:
+    branches:
+      - main
+      - nedbat/*
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: "${{ github.workflow }}-${{ github.ref }}"
+  cancel-in-progress: true
+
+jobs:
+  dependency-review:
+    name: "Review dependencies"
+    if: github.repository_owner == 'coveragepy'
+    runs-on: ubuntu-latest
+    steps:
+      - name: 'Checkout Repository'
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
+        with:
+          persist-credentials: false
+
+      - name: 'Dependency Review'
+        uses: actions/dependency-review-action@3c4e3dcb1aa7874d2c16be7d79418e9b7efd6261 # v4.8.2
+        with:
+          base-ref: ${{ github.event.pull_request.base.sha || 'main' }}
+          head-ref: ${{ github.event.pull_request.head.sha || github.ref }}