Codecap is a file header standardization tool that simplifies the updating and uniformity of headers across various file types within a project. It ensures consistent presentation of details like license information, author credentials, or project descriptions, promoting a harmonized style throughout your codebase.
- Header Inspection: Check if files have the correct header.
- Header Correction: Automatically fix files with incorrect headers.
- Flexible Targeting: Apply rules to a wide range of file types, with support for both individual and multiple patterns.
- Exclusion Patterns: Exclude specific files or directories from being processed, with support for single or multiple exclusion patterns.
This section shows how to get the tool up and running on your local machine.
To use this tool, ensure the following software is installed on your system:
- Node.js 16 or newer
-
Open your terminal.
-
Navigate to your node project's directory.
-
Execute the following command:
npm install -D codecap
Set up a .codecaprc.json
file at the root level of your project directory as shown in the example below:
{
"useYearRange": true,
"ruleSet": [
{
"target": ["**/*.{js,ts}", "**/*.css"],
"targetExclude": ["node_modules/**", "dist/**"],
"headerFile": "path/to/file",
"headerDelimiter": "^(?![\\/ ]\\*)."
}
]
}
useYearRange
(optional): A boolean that enables automatic year range updates, from file creation to current year.ruleSet
: An array of rules defining how headers should be applied. Each rule can handle different file types uniquely.target
: A pattern or an array of patterns for matching files. It specifies which files the rule should apply to.targetExclude
(optional): A pattern or an array of patterns for files or directories to exclude from the rule.headerFile
: The path to a file containing the header content to be prepended to each matched file.headerDelimiter
: A regex pattern that helps identify where the header ends in a file for correct insertion or replacement.
To ensure your file headers remain up-to-date with the current year, use the
$YEAR
placeholder within your header file content.
Integrate the tool into your project by adding script entries in your package.json
file:
{
"scripts": {
"check-headers": "codecap --check",
"fix-headers": "codecap --fix"
}
}
- Run
npm run check-headers
to inspect your files for correct headers. - Use
npm run fix-headers
to automatically correct any incorrect headers.
Feel free to modify these scripts as needed to fit your project requirements.
This tool is available under the terms of the MIT license.
© 2024 Mayeku Khisa.