#documentation #automation #cli #rust

app docstring-rs

📒 Generate or update docstrings for new and existing files

2 unstable releases

0.3.0 Oct 4, 2023
0.2.0 Oct 1, 2023

#194 in #automation

Custom license

44KB
866 lines



Crates.io (latest) License: MIT codecov CI Tests

🔎 Overview

Automatically generate new files or update existing codebases with header docstrings based on LICENSE information.

📦 Installation

cargo install docstring-rs

🚀 Usage

Usage: docstring-rs.exe [OPTIONS] --directory <DIRECTORY>

Options:
  -d, --directory <DIRECTORY>  Name of the directory in which to create new file or update existing files,
                               if it does not already exist, creates the directory
  -f, --file <FILE_NAME>       Name of a new file to create with docstring as header. Prepends to top of
                               file if the target file already exists [default: *.*]
  -l, --license <LICENSE>      Relative path to the LICENSE file to use as header docstring. If not specified,
                               expects a LICENSE file to exist in the current working directory [default: LICENSE]
  -u, --update                 Specify whether or not to try and update all available docstrings in a directory
                               recursively, requires <DIRECTORY> to have been set
  -h, --help                   Print help
  -V, --version                Print version

📋 License

All code is to be held under a general MIT license, please see LICENSE for specific information.

Dependencies

~5–7.5MB
~127K SLoC