Codecap is a file header standardization tool designed to streamline the process of maintaining consistent headers across diverse file types in your project. It automates the task of updating and unifying essential information such as license details, author credentials, and project descriptions, ensuring a cohesive style throughout your codebase.

• 🔍 Smart Header Inspection: Efficiently detect files with missing or incorrect headers.
• 🛠️ Automatic Correction: Seamlessly fix and update file headers with a single command.
• 🎯 Versatile Targeting: Support for multiple file types and patterns, enabling precise rule application.
• 🚫 Intelligent Exclusions: Respect .gitignore and custom exclusion patterns for granular control.
• 🔄 Year Range Automation: Automatically update copyright year ranges to stay current.
• 🧩 Flexible Configuration: Easily customize rules and headers via JSON configuration file.

This section shows how to get Codecap up and running on your local machine.

Ensure the following software is installed on your system before using Codecap:

• Node.js (v16 or later)

You can install Codecap either globally or locally in your project.

To install Codecap globally, use the following command:

npm install -g codecap

To install Codecap as a dev dependency in your project, use one of the following commands based on your package manager:

# npm
npm install -D codecap

# pnpm
pnpm add -D codecap

# yarn
yarn add -D codecap

Create a .codecaprc.json file at the root level of your project directory to define rules for managing headers. Here's an example configuration:

{
   "useYearRange": true,
   "ruleSet": [
      {
         "target": ["**/*.{js,ts}", "**/*.css"],
         "targetExclude": ["node_modules/**", "dist/**"],
         "headerFile": "path/to/file",
         "headerDelimiter": "^(?![\\/ ]\\*)."
      }
   ]
}

If you've installed Codecap globally, you can run it directly from any directory:

codecap --check
codecap --fix

If you've installed Codecap locally in your project, integrate it into your project by adding script entries in your package.json file:

{
   "scripts": {
      "check": "codecap --check",
      "fix": "codecap --fix"
   }
}

Then you can run:

• npm run check (or pnpm check or yarn check) to inspect your files for correct headers.
• npm run fix (or pnpm fix or yarn fix) to automatically correct any incorrect headers.

Feel free to modify these scripts as needed to fit your project requirements.

Codecap is available under the terms of the MIT license.

© 2024 Mayeku Khisa.