---
id: flake8-gl-codeclimate
version: "0.2.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# flake8-gl-codeclimate — Gitlab Code Quality artifact Flake8 formatter

License: permissive · Maintenance: active · Downloads: 203.9K/mo

## What it is and what it does

flake8-gl-codeclimate is a Flake8 output formatter that translates linting violations into GitLab Code Quality artifact format—a JSON structure compatible with the Code Climate specification. Instead of printing human-readable text, it produces structured JSON that GitLab CI/CD can parse and display as code quality reports in merge requests. The package is a thin adapter: it depends only on flake8 and acts as a custom formatter plugin, allowing you to run your existing linting checks and automatically feed the results into GitLab's quality tracking system.

Typically used in GitLab CI/CD pipelines, you install it alongside flake8, then invoke flake8 with `--format gl-codeclimate` and redirect output to a JSON file that GitLab stores as a code quality artifact. This enables developers to see linting violations, improvements, and regressions directly in merge request reviews without leaving GitLab's interface.

Use it for:

- Integrate Flake8 linting into GitLab CI/CD so code quality metrics appear in merge request reviews.
- Track code quality improvements and regressions across commits in a GitLab project.
- Produce Code Climate–compatible JSON reports from Flake8 for GitLab artifact storage.
- Automate Python code quality checks as part of a GitLab pipeline without custom JSON serialization.

## Worth the install?

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

A Flake8 formatter that outputs linting results in GitLab Code Quality artifact format (JSON compatible with the Code Climate spec) for integration into GitLab CI/CD pipelines.

Yes, if you use GitLab CI/CD and want Flake8 linting results to appear as code quality reports in merge requests. The package is lightweight, has no complex dependencies, carries a permissive license, and solves a specific GitLab integration need. Install it as part of your CI pipeline configuration; it is not useful outside that context.

## Install

pip install flake8-gl-codeclimate
uv add flake8-gl-codeclimate
poetry add flake8-gl-codeclimate

## Installing flake8-gl-codeclimate

Before you install: Low friction: pure Python wheel with only flake8 as a runtime dependency. Marked active with a recent release (2026-04-06), though repository details are not available to assess ongoing maintenance depth.

License in practice: MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open-source and proprietary projects.

Quickstart:

pip install flake8-gl-codeclimate
flake8 --format gl-codeclimate --output-file report.json your_code.py

Requires flake8 to be installed; intended for use in GitLab CI/CD pipelines or local environments where flake8 linting is already part of your workflow.

Verify before relying:

- Whether the formatter supports all flake8 plugins or only a subset of linting rules.
- Compatibility with recent flake8 versions and any breaking changes in the Code Climate spec.
- Active maintenance status beyond the latest release date (repository visibility not provided).

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 203.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

flake8 gitlab code quality, gitlab ci code quality reports, flake8 json formatter, code climate artifact format, gitlab merge request quality, flake8 ci integration, linting gitlab pipeline, gitlab-ci, code-quality, flake8-plugin

[View on SkillFed](https://skillfed.io/packages/flake8-gl-codeclimate) · [View on PyPI](https://pypi.org/project/flake8-gl-codeclimate/)