Welcome to rsmetacheck-bot’s documentation

An automated bot that analyzes repository metadata quality and creates issues with improvement suggestions.

Part of the CodeMetaSoft project.

Contents:

• Installation
  • Requirements
  • Install from PyPI
  • From source for contributors
• Usage
  • Command Line Interface
  • Example Workflow
  • Decision Tree for Issue Creation
• Output storage conventions
  • Repository-centric layout
  • Important rules
  • Legacy snapshot detection
  • Conversion workflow
  • Flattened vs nested layout
  • Operational conventions
  • Why this design
• API Reference
  • Analysis Runtime Module
  • Check Parsing Module
  • Commit Lookup Module
  • Config Utils Module
  • RSMetaCheck Wrapper Module
  • GitHub API Module
  • GitLab API Module
  • History Module
  • Incremental Module
  • Main Module
  • Pipeline Module
  • Pitfalls Module
  • Publish Module
  • Token Resolver Module
  • Verify Tokens Module

Quick Start

Install from PyPI:

pip install rsmetacheck-bot

Run analysis with a campaign configuration file:

rsmetacheck-bot run-analysis --config-file path/to/config.json

Review the generated snapshot, then publish the approved results:

rsmetacheck-bot publish --analysis-root outputs/<run_name>/<snapshot_tag>

For installation choices, configuration examples, and token setup, see Installation and Usage.

Indices and tables

• Index

• Module Index

• Search Page