kira-setup 0.2.0__tar.gz

kira_setup-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2018 wemake.services
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kira_setup-0.2.0/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: kira-setup
+Version: 0.2.0
+Summary: Kira's CLI to setup new projects
+License-Expression: MIT
+License-File: LICENSE
+Keywords: wemake.services,gitlab-bot,gitlab,kira,kira-bot
+Author: sobolevn
+Author-email: mail@sobolevn.me
+Requires-Python: >=3.11,<3.15
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Programming Language :: Python :: Implementation :: PyPy
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Typing :: Typed
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Requires-Dist: python-gitlab (>=8.4,<9.0)
+Requires-Dist: termcolor (>=3.3,<4.0)
+Project-URL: Homepage, https://github.com/wemake-services/kira-setup
+Project-URL: Repository, https://github.com/wemake-services/kira-setup
+Description-Content-Type: text/markdown
+
+# Kira Setup Bot
+
+[![wemake.services](https://img.shields.io/badge/%20-wemake.services-green.svg?label=%20&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9TAAAABGdBTUEAALGPC%2FxhBQAAAAFzUkdCAK7OHOkAAAAbUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP%2F%2F%2F5TvxDIAAAAIdFJOUwAjRA8xXANAL%2Bv0SAAAADNJREFUGNNjYCAIOJjRBdBFWMkVQeGzcHAwksJnAPPZGOGAASzPzAEHEGVsLExQwE7YswCb7AFZSF3bbAAAAABJRU5ErkJggg%3D%3D)](https://wemake.services)
+[![kira-family](https://img.shields.io/badge/kira-family-pink.svg)](https://github.com/wemake-services/kira)
+[![Build Status](https://github.com/wemake-services/kira-setup/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/wemake-services/kira-setup/actions/workflows/test.yml)
+[![wemake-python-styleguide](https://img.shields.io/badge/style-wemake-000000.svg)](https://github.com/wemake-services/wemake-python-styleguide)
+[![Dependencies Status](https://img.shields.io/badge/dependencies-up%20to%20date-brightgreen.svg)](https://github.com/wemake-services/kira-setup/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aapp%2Fdependabot)
+
+CLI utility to automate routine work with new projects.
+
+Part of the [`@kira`](https://github.com/wemake-services/kira) bots family.
+
+`kira-setup` does not create a repository. It configures an existing GitLab
+project so new repositories start with the same engineering standards.
+
+## Features
+
+- [x] Configures GitLab project defaults for a stricter merge flow
+- [x] Requires passing pipelines before merge
+- [x] Requires all discussions to be resolved before merge
+- [x] Sets fast-forward only merge strategy
+- [x] Configures merge request approval rules
+- [x] Protects the `master` branch and release tags matching `v*`
+- [x] Enforces push rules for branch names and commit messages
+- [x] Prevents secret pushes and enables member checks
+- [x] Creates a standard label set for triage and workflow
+- [x] Configures container registry cleanup policy
+
+## Installation
+
+Requirements:
+
+- Python 3.11+
+- An existing GitLab project
+- A GitLab access token with permission to manage project settings
+
+```bash
+pip install kira-setup
+```
+
+## Quick Start
+
+Run the CLI against an existing project:
+
+```bash
+kira-setup group-or-user/project-name --token YOUR_ACCESS_TOKEN
+```
+
+For self-hosted GitLab:
+
+```bash
+kira-setup group-or-user/project-name \
+  --token YOUR_ACCESS_TOKEN \
+  --domain gitlab.example.com
+```
+
+To skip specific setup steps, repeat `--skip` with the stable step name:
+
+```bash
+kira-setup group-or-user/project-name \
+  --token YOUR_ACCESS_TOKEN \
+  --skip labels \
+  --skip protect-tags
+```
+
+Available `--skip` values:
+
+- `star`
+- `configure`
+- `push-rules`
+- `approval-rules`
+- `labels`
+- `protect-branches`
+- `protect-tags`
+- `cleanup-policy`
+
+## Why Use It
+
+We use this CLI to make repository setup repeatable across projects.
+Instead of applying the same GitLab rules manually every time, `kira-setup`
+brings a new repository to the expected baseline in a single command.
+
+## Related Projects
+
+- [`kira`](https://github.com/wemake-services/kira): the full bots family
+- [`kira-stale`](https://github.com/wemake-services/kira-stale): stale issue and
+  pull request automation
+- [`kira-release`](https://github.com/wemake-services/kira-release): automated
+  semantic releases
+

kira_setup-0.2.0/README.md

@@ -0,0 +1,89 @@
+# Kira Setup Bot
+
+[![wemake.services](https://img.shields.io/badge/%20-wemake.services-green.svg?label=%20&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAMAAAAoLQ9TAAAABGdBTUEAALGPC%2FxhBQAAAAFzUkdCAK7OHOkAAAAbUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAP%2F%2F%2F5TvxDIAAAAIdFJOUwAjRA8xXANAL%2Bv0SAAAADNJREFUGNNjYCAIOJjRBdBFWMkVQeGzcHAwksJnAPPZGOGAASzPzAEHEGVsLExQwE7YswCb7AFZSF3bbAAAAABJRU5ErkJggg%3D%3D)](https://wemake.services)
+[![kira-family](https://img.shields.io/badge/kira-family-pink.svg)](https://github.com/wemake-services/kira)
+[![Build Status](https://github.com/wemake-services/kira-setup/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/wemake-services/kira-setup/actions/workflows/test.yml)
+[![wemake-python-styleguide](https://img.shields.io/badge/style-wemake-000000.svg)](https://github.com/wemake-services/wemake-python-styleguide)
+[![Dependencies Status](https://img.shields.io/badge/dependencies-up%20to%20date-brightgreen.svg)](https://github.com/wemake-services/kira-setup/pulls?utf8=%E2%9C%93&q=is%3Apr%20author%3Aapp%2Fdependabot)
+
+CLI utility to automate routine work with new projects.
+
+Part of the [`@kira`](https://github.com/wemake-services/kira) bots family.
+
+`kira-setup` does not create a repository. It configures an existing GitLab
+project so new repositories start with the same engineering standards.
+
+## Features
+
+- [x] Configures GitLab project defaults for a stricter merge flow
+- [x] Requires passing pipelines before merge
+- [x] Requires all discussions to be resolved before merge
+- [x] Sets fast-forward only merge strategy
+- [x] Configures merge request approval rules
+- [x] Protects the `master` branch and release tags matching `v*`
+- [x] Enforces push rules for branch names and commit messages
+- [x] Prevents secret pushes and enables member checks
+- [x] Creates a standard label set for triage and workflow
+- [x] Configures container registry cleanup policy
+
+## Installation
+
+Requirements:
+
+- Python 3.11+
+- An existing GitLab project
+- A GitLab access token with permission to manage project settings
+
+```bash
+pip install kira-setup
+```
+
+## Quick Start
+
+Run the CLI against an existing project:
+
+```bash
+kira-setup group-or-user/project-name --token YOUR_ACCESS_TOKEN
+```
+
+For self-hosted GitLab:
+
+```bash
+kira-setup group-or-user/project-name \
+  --token YOUR_ACCESS_TOKEN \
+  --domain gitlab.example.com
+```
+
+To skip specific setup steps, repeat `--skip` with the stable step name:
+
+```bash
+kira-setup group-or-user/project-name \
+  --token YOUR_ACCESS_TOKEN \
+  --skip labels \
+  --skip protect-tags
+```
+
+Available `--skip` values:
+
+- `star`
+- `configure`
+- `push-rules`
+- `approval-rules`
+- `labels`
+- `protect-branches`
+- `protect-tags`
+- `cleanup-policy`
+
+## Why Use It
+
+We use this CLI to make repository setup repeatable across projects.
+Instead of applying the same GitLab rules manually every time, `kira-setup`
+brings a new repository to the expected baseline in a single command.
+
+## Related Projects
+
+- [`kira`](https://github.com/wemake-services/kira): the full bots family
+- [`kira-stale`](https://github.com/wemake-services/kira-stale): stale issue and
+  pull request automation
+- [`kira-release`](https://github.com/wemake-services/kira-release): automated
+  semantic releases

kira_setup-0.2.0/kira_setup/api.py

@@ -0,0 +1,57 @@
+import argparse
+from types import MappingProxyType
+from typing import Final
+
+import gitlab
+from gitlab.v4.objects import Project
+
+from kira_setup.logging import report_progress
+from kira_setup.pipelines import (
+    container_registry,
+    labels,
+    merge_requests,
+    project,
+    protected,
+)
+
+PIPELINE_STEPS: Final = MappingProxyType({
+    # Project:
+    'star': project.star,
+    'configure': project.configure,
+    'push-rules': project.push_rules,
+    # Merge Requests:
+    'approval-rules': merge_requests.approval_rules,
+    # Labels:
+    'labels': labels.create_labels,
+    # Protection Rules:
+    'protect-branches': protected.branches,
+    'protect-tags': protected.tags,
+    # Container Registry:
+    'cleanup-policy': container_registry.cleanup_policy,
+})
+
+
+def _get_project(context: argparse.Namespace) -> Project:
+    gl = gitlab.Gitlab(
+        f'https://{context.domain}',
+        context.token,
+        timeout=10,
+    )
+
+    return gl.projects.get(context.path)
+
+
+def _start_pipeline(
+    current_project: Project,
+    context: argparse.Namespace,
+) -> None:
+    for step, action in PIPELINE_STEPS.items():
+        if step in context.skip:
+            continue
+
+        report_progress(action)(current_project)
+
+
+def start_pipeline(context: argparse.Namespace) -> None:
+    """Main function to start the whole project-setup pipeline."""
+    _start_pipeline(_get_project(context), context)

kira_setup-0.2.0/kira_setup/cli.py

@@ -0,0 +1,31 @@
+import argparse
+
+from kira_setup.api import PIPELINE_STEPS, start_pipeline
+
+
+def _create_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser()
+    parser.add_argument('path', help='Project group / name')
+    parser.add_argument('-t', '--token', type=str, help='Auth token')
+    parser.add_argument(
+        '-d',
+        '--domain',
+        default='gitlab.com',
+        type=str,
+        help='GitLab domain address, change if you use custom installation',
+    )
+    parser.add_argument(
+        '--skip',
+        action='append',
+        choices=PIPELINE_STEPS.keys(),
+        default=[],
+        help='Skip a pipeline step, repeat this option to skip multiple steps',
+    )
+    return parser
+
+
+def main() -> None:
+    """Runs all pipeline actions."""
+    parser = _create_parser()
+    args = parser.parse_args()
+    start_pipeline(args)

kira_setup-0.2.0/kira_setup/decorators.py

@@ -0,0 +1,27 @@
+from collections.abc import Callable
+from contextlib import suppress
+from functools import wraps
+from typing import ParamSpec, TypeVar
+
+from gitlab.exceptions import GitlabCreateError
+
+ParamT = ParamSpec('ParamT')
+ReturnT = TypeVar('ReturnT')
+
+
+def idempotent(
+    function: Callable[ParamT, ReturnT],
+) -> Callable[ParamT, ReturnT | None]:
+    """Shallows 304 errors, making actions repeatable."""
+
+    @wraps(function)
+    def decorator(
+        *args: ParamT.args,
+        **kwargs: ParamT.kwargs,
+    ) -> ReturnT | None:
+        with suppress(GitlabCreateError):
+            return function(*args, **kwargs)
+
+        return None
+
+    return decorator

kira_setup-0.2.0/kira_setup/logging.py

@@ -0,0 +1,32 @@
+from collections.abc import Callable
+from functools import wraps
+from typing import ParamSpec, TypeVar
+
+from termcolor import colored
+
+ParamT = ParamSpec('ParamT')
+ReturnT = TypeVar('ReturnT')
+
+
+def report_progress(
+    function: Callable[ParamT, ReturnT],
+) -> Callable[ParamT, ReturnT]:
+    """Decorates a function to print its execution status."""
+
+    @wraps(function)
+    def decorator(
+        *args: ParamT.args,
+        **kwargs: ParamT.kwargs,
+    ) -> ReturnT:
+        try:
+            function_result = function(*args, **kwargs)
+        except Exception as exc:
+            message = f'{function.__name__} failed due to exception: {exc}'
+            print(colored(message, 'red'))  # noqa: WPS421
+            raise
+        else:
+            message = f'{function.__name__} succeed'
+            print(colored(message, 'green'))  # noqa: WPS421
+            return function_result
+
+    return decorator

kira_setup-0.2.0/kira_setup/pipelines/container_registry.py

@@ -0,0 +1,18 @@
+from gitlab.v4.objects import Project
+
+
+def cleanup_policy(project: Project) -> None:
+    """
+    Configure container registry cleanup policy.
+
+    API: https://docs.gitlab.com/user/packages/container_registry/reduce_container_registry_storage/#cleanup-policy
+    """
+    project.container_expiration_policy_attributes = {
+        'enabled': True,
+        'cadence': '1d',  # Run cleanup every day
+        'keep_n': 5,  # 5 newest semver tags
+        'name_regex': r'^\d+\.\d+\.\d+$',  # Plain semver only
+        'name_regex_keep': '^(latest|dev)$',  # Always keep
+    }
+
+    project.save()

kira_setup-0.2.0/kira_setup/pipelines/labels.py

@@ -0,0 +1,52 @@
+from types import MappingProxyType
+from typing import Final
+
+from gitlab.v4.objects import Project
+
+from kira_setup.decorators import idempotent
+
+_LABELS: Final = MappingProxyType({
+    # Common:
+    'bug': '#FF0000',
+    'feature': '#428BCA',
+    'documentation': '#69D100',
+    'research': '#5843AD',
+    # Deadline:
+    'deadline::soft': '#AD4363',
+    'deadline::hard': '#D10069',
+    'deadline::miss': '#CC0033',
+    # Validation:
+    'validation::labels': '#A295D6',
+    'validation::stale': '#A295D6',
+    'validation::invalid': '#7F8C8D',
+    'validation::estimate': '#D9534F',
+    # Notification:
+    'notification::first': '#D1D100',
+    'notification::last': '#F0AD4E',
+})
+
+
+def _is_prioritized(label: str) -> int:
+    """
+    Tells if label is prioritized or not.
+
+    >>> assert _is_prioritized('feature')
+    >>> assert not _is_prioritized('deadline:miss')
+
+    """
+    return 0 if '::' in label else 1
+
+
+def create_labels(project: Project) -> None:
+    """
+    Creates all labels that are required for our projects.
+
+    API: https://docs.gitlab.com/api/labels/
+    """
+    safe_create = idempotent(project.labels.create)
+    for label, color in _LABELS.items():
+        safe_create({
+            'name': label,
+            'color': color,
+            'priority': _is_prioritized(label),
+        })

kira_setup-0.2.0/kira_setup/pipelines/merge_requests.py

@@ -0,0 +1,16 @@
+from gitlab.v4.objects import Project
+
+
+def approval_rules(project: Project) -> None:
+    """
+    Configures how approvals work for merge requests.
+
+    API: https://docs.gitlab.com/api/merge_request_approvals/
+    """
+    approvals = project.approvals.get()
+
+    approvals.approvals_before_merge = 1
+    approvals.reset_approvals_on_push = True
+    approvals.disable_overriding_approvers_per_merge_request = True
+
+    approvals.save()

kira_setup-0.2.0/kira_setup/pipelines/project.py

@@ -0,0 +1,75 @@
+from gitlab.exceptions import GitlabGetError, GitlabParsingError
+from gitlab.v4.objects import Project
+
+from kira_setup.decorators import idempotent
+
+#: Used to enforce one-task = one-branch,
+#: also has a fallback for dependabot updates:
+branch_regex = r'^(issue-\d+)|(dependabot.*)|(renovate.*)|(master)$'
+
+#: Enforces conventional commits,
+#: see https://github.com/wemake-services/kira-release
+commit_regex = r"""
+^(revert: )?
+(feat|fix|docs|build|refactor|chore)
+(\(.+\))?:
+.{1,50}(refs #\d+)?
+"""
+
+
+@idempotent
+def star(project: Project) -> None:
+    """
+    Stars the given project.
+
+    API: https://docs.gitlab.com/api/project_starring/
+    """
+    project.star()
+
+
+def configure(project: Project) -> None:
+    """
+    Configures basic things for a new project.
+
+    API: https://docs.gitlab.com/api/projects/#manage-projects/
+    """
+    project.resolve_outdated_diff_discussions = True
+    project.only_allow_merge_if_pipeline_succeeds = True
+    project.only_allow_merge_if_all_discussions_are_resolved = True
+    project.merge_method = 'ff'
+
+    project.save()
+
+
+def push_rules(project: Project) -> None:
+    """
+    Sets all required push rules for the project.
+
+    API: https://docs.gitlab.com/api/project_push_rules/
+
+    GitLab may return either `404` or `null` when push rules have not been
+    created yet. `python-gitlab` expects a dictionary response
+    for `project.pushrules.get()`, so a `null` response becomes
+    `None` and raises `GitlabParsingError`.
+
+    To handle both cases, this function first tries to fetch existing push
+    rules and falls back to creating them when the server reports that they
+    do not exist yet.
+    """
+    payload = {
+        'deny_delete_tag': True,
+        'member_check': True,
+        'prevent_secrets': True,
+        'branch_name_regex': branch_regex,
+        'commit_message_regex': commit_regex.replace('\n', ''),
+    }
+
+    try:
+        rules = project.pushrules.get()
+    except (GitlabGetError, GitlabParsingError):
+        project.pushrules.create(payload)
+    else:
+        for rule_name, rule_value in payload.items():
+            setattr(rules, rule_name, rule_value)
+
+        rules.save()

kira_setup-0.2.0/kira_setup/pipelines/protected.py

@@ -0,0 +1,31 @@
+from gitlab import const
+from gitlab.v4.objects import Project
+
+from kira_setup.decorators import idempotent
+
+
+@idempotent
+def branches(project: Project) -> None:
+    """
+    Creates protected branch rules.
+
+    API: https://docs.gitlab.com/api/protected_branches/
+    """
+    project.protectedbranches.create({
+        'name': 'master',
+        'merge_access_level': const.DEVELOPER_ACCESS,
+        'push_access_level': const.MAINTAINER_ACCESS,
+    })
+
+
+@idempotent
+def tags(project: Project) -> None:
+    """
+    Creates protected tag rules.
+
+    API: https://docs.gitlab.com/api/protected_tags/
+    """
+    project.protectedtags.create({
+        'name': 'v*',
+        'create_access_level': const.MAINTAINER_ACCESS,
+    })

kira_setup-0.2.0/pyproject.toml

@@ -0,0 +1,166 @@
+[project]
+name = "kira-setup"
+version = "0.2.0"
+description = "Kira's CLI to setup new projects"
+requires-python = ">=3.11,<3.15"
+readme = "README.md"
+license = "MIT"
+dynamic = ["dependencies", "classifiers"]
+
+authors = [
+  { name = "sobolevn", email = "mail@sobolevn.me" },
+  { name = "Alexander Kondratev", email = "mail@kondratev.dev" },
+]
+
+keywords = [
+  "wemake.services",
+  "gitlab-bot",
+  "gitlab",
+  "kira",
+  "kira-bot",
+]
+
+classifiers = [
+  'Programming Language :: Python',
+  'Programming Language :: Python :: Implementation :: CPython',
+  'Programming Language :: Python :: Implementation :: PyPy',
+  'Programming Language :: Python :: 3',
+  'Programming Language :: Python :: 3 :: Only',
+  'Programming Language :: Python :: 3.11',
+  'Programming Language :: Python :: 3.12',
+  'Programming Language :: Python :: 3.13',
+  'Programming Language :: Python :: 3.14',
+  "Development Status :: 5 - Production/Stable",
+  "Environment :: Console",
+  "Typing :: Typed",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+]
+
+[project.scripts]
+kira-setup = "kira_setup.cli:main"
+
+[project.urls]
+repository = "https://github.com/wemake-services/kira-setup"
+homepage = "https://github.com/wemake-services/kira-setup"
+
+[build-system]
+requires = ["poetry-core>=2.0"]
+build-backend = "poetry.core.masonry.api"
+
+
+[tool.poetry.dependencies]
+python-gitlab = "^8.4"
+termcolor = "^3.3"
+
+[tool.poetry.group.dev.dependencies]
+mypy = "^2.1"
+wemake-python-styleguide = "^1.6"
+ruff = "^0.15"
+safety = "^3.8"
+
+
+[tool.ruff]
+# Ruff config: https://docs.astral.sh/ruff/settings
+preview = true
+fix = true
+target-version = "py311"
+line-length = 80
+
+[tool.ruff.format]
+quote-style = "single"
+docstring-code-format = true
+
+[tool.ruff.lint]
+select = [
+  "A",    # flake8-builtins
+  "ASYNC",
+  "B",    # flake8-bugbear
+  "C4",   # flake8-comprehensions
+  "C90",  # maccabe
+  "COM",  # flake8-commas
+  "D",    # pydocstyle
+  "DTZ",  # flake8-datetimez
+  "E",    # pycodestyle
+  "ERA",  # flake8-eradicate
+  "EXE",  # flake8-executable
+  "F",    # pyflakes
+  "FA",   # flake8-future-annotations
+  "FBT",  # flake8-boolean-trap
+  "FLY",  # pyflint
+  "FURB", # refurb
+  "G",    # flake8-logging-format
+  "I",    # isort
+  "ICN",  # flake8-import-conventions
+  "ISC",  # flake8-implicit-str-concat
+  "LOG",  # flake8-logging
+  "N",    # pep8-naming
+  "PERF", # perflint
+  "PIE",  # flake8-pie
+  "PL",   # pylint
+  "PT",   # flake8-pytest-style
+  "PTH",  # flake8-use-pathlib
+  "Q",    # flake8-quotes
+  "RET",  # flake8-return
+  "RSE",  # flake8-raise
+  "RUF",  # ruff
+  "S",    # flake8-bandit
+  "SIM",  # flake8-simpify
+  "SLF",  # flake8-self
+  "SLOT", # flake8-slots
+  "T100", # flake8-debugger
+  "TRY",  # tryceratops
+  "UP",   # pyupgrade
+  "W",    # pycodestyle
+  "YTT",  # flake8-2020
+]
+ignore = [
+  "A005",   # allow to shadow stdlib and builtin module names
+  # Different doc rules that we don't really care about:
+  "D100",
+  "D104",
+  "D106",
+  "D203",
+  "D212",
+  "D401",
+  "D404",
+  "D405",
+  "ISC001",  # implicit string concat conflicts with `ruff format`
+  "ISC003",  # prefer explicit string concat over implicit concat
+  "PLR09",   # we have our own complexity rules
+  "PLR2004", # do not report magic numbers
+  "PLR6301", # do not require classmethod / staticmethod when self not used
+  "RUF067",  # wps handles `__init__.py` logic better
+  "TRY003",  # long exception messages from `tryceratops`
+]
+external = ["WPS"]
+
+# Plugin configs:
+flake8-quotes.inline-quotes = "single"
+mccabe.max-complexity = 6
+pydocstyle.convention = "google"
+
+
+[tool.mypy]
+# Mypy configuration:
+# https://mypy.readthedocs.io/en/latest/config_file.html
+enable_error_code = [
+  "truthy-bool",
+  "truthy-iterable",
+  "redundant-expr",
+  "unused-awaitable",
+  "ignore-without-code",
+  "possibly-undefined",
+  "redundant-self",
+  "explicit-override",
+  "unimported-reveal",
+  "deprecated",
+  "exhaustive-match",
+]
+
+explicit_package_bases = true
+ignore_missing_imports = true
+extra_checks = true
+strict = true
+strict_equality_for_none = true
+warn_unreachable = true