Skip to content

Helps you document dependencies of your project

License

Notifications You must be signed in to change notification settings

cheeZery/depdoc

Repository files navigation

DepDoc helps you document the dependencies of your project, currently supporting Composer and Node packages.

Usage

Creating and updating dependencies file

./vendor/bin/depdoc update

Creates and updates a DEPENDENCIES.md file in your repository, which contains every installed Composer and Node package, its version and description, and offers you a way to document why and how you use this package.

By adding a lock emoji (🔒) after the version number, you can document that this package should not be updated. Alternatively you can use 🛇, ⚠, or ✋.

Validating dependencies file

./vendor/bin/depdoc validate

Validates that every installed dependency is documented in DEPENDENCIES.md. Also makes sure that no package surpasses its locked version.

Use strict modes to verify your package version matches the documented dependencies.

./vendor/bin/depdoc validate --strict

Checks for major and minor version to match, i.e. installed 1.0.1 and documented 1.0.0 will bypass validation but installed 1.1.0 and documented 1.0.0 won't.

./vendor/bin/depdoc validate --very-strict

Checks for full semantic versioning match, i.e. installed 1.0.1 and documented 1.0.0 will not bypass validation.

Configuration

Configuration can be provided via .depdoc.json, .depdoc.yml or .depdoc.yml files in the root directory of your project.

Options

newlineCharacter

Default is \n but if you need a different one you can provide it.

lockSymbol

Default is "🔒". Alternatively you can use 🛇, ⚠, or ✋.

exportExternalLink

Default is true, but if you do not want the external link in your dependencies file you can deactivate it.

composer

Default is true, if you do not want to add composer dependencies set this to false

npm

Default is true, if you do not want to add npm dependencies set this to false.