---
id: mypy-gitlab-code-quality
version: "1.3.0"
license: MIT License Copyright (c) 2021 Dmitry Samsonov Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record)
license_treatment: permissive
maintenance: aging
---

# mypy-gitlab-code-quality — Simple script to generate gitlab code quality report from output of mypy.

License: permissive · Maintenance: aging · Downloads: 409.4K/mo

## What it is and what it does

This package is a small converter that takes mypy's type-checking output and reformats it into GitLab's Code Quality report schema. It reads mypy's JSON (or plain text for backward compatibility) from stdin and writes a GitLab-compatible JSON report to stdout, designed to be used as a CI artifact in .gitlab-ci.yml pipelines.

The package has no runtime dependencies and is intended as a glue layer between mypy and GitLab CI. It supports Python 3.9 through 3.13 and is classified as Production/Stable, though its last release was over a year ago. It's most useful in GitLab CI workflows where you want type errors to appear in merge request code quality widgets.

Use it for:

- Integrate mypy type checking into GitLab CI pipelines so type errors appear in merge request code quality reports.
- Convert mypy JSON output to GitLab Code Quality format for automated code review feedback.
- Display type-checking violations alongside other code quality metrics in GitLab merge requests.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Converts mypy type-checking output into GitLab Code Quality report format for merge request integration.

Yes, if you use GitLab CI and mypy for type checking. It has no dependencies, low install friction, and a stable MIT license. The aging maintenance status (501 days since last release) is not a blocker for a simple, focused converter—but verify that it handles your mypy version's output format before relying on it in production CI.

## Install

pip install mypy-gitlab-code-quality
uv add mypy-gitlab-code-quality
poetry add mypy-gitlab-code-quality

## Installing mypy-gitlab-code-quality

Before you install: Low friction install with no runtime dependencies. Maintenance is aging—last release was 501 days ago—but the repository remains active and the package is marked Production/Stable.

License in practice: MIT License permits free use, modification, and distribution with minimal restrictions, making it safe for commercial and open-source projects.

Quickstart:

pip install mypy-gitlab-code-quality
mypy program.py --output=json | mypy-gitlab-code-quality > codequality.json

Requires mypy to be installed separately; designed to read mypy's JSON output via stdin.

Verify before relying:

- Whether the package handles all mypy output formats reliably or only a subset of mypy versions.
- Performance characteristics when processing large mypy outputs or many type errors.

## Package facts

- License: MIT License Copyright (c) 2021 Dmitry Samsonov Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 409.4K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mypy gitlab integration, code quality report generation, gitlab ci mypy, type checking ci pipeline, mypy json to gitlab format, gitlab-ci, type-checking

[View on SkillFed](https://skillfed.io/packages/mypy-gitlab-code-quality) · [View on PyPI](https://pypi.org/project/mypy-gitlab-code-quality/)