Sha256: 460d4b9b7325436e8418cc3f62921dc12f3509fe9699ccef7a7900cb7275630c

Contents?: true

Size: 1.74 KB

Versions: 1

Compression:

Stored size: 1.74 KB

Contents

## danger-jazzy
[![Build Status](https://img.shields.io/travis/fwal/danger-jazzy.svg)](https://travis-ci.org/fwal/danger-jazzy)
[![Coveralls](https://img.shields.io/coveralls/fwal/danger-jazzy.svg)](https://coveralls.io/github/fwal/danger-jazzy)
[![Gem](https://img.shields.io/gem/v/danger-jazzy.svg)](http://rubygems.org/gems/danger-jazzy)

This is a danger plugin to check for undocumented symbols via Jazzy.

<blockquote>Fail on undocumented symbols in modified files.
  <pre>
jazzy.check</pre>
</blockquote>

<blockquote>Fail on undocumented symbols in all files.
  <pre>
jazzy.check fail: :all</pre>
</blockquote>

<blockquote>Warn about undocumented symbols in modified files.
  <pre>
jazzy.check warn: :modified</pre>
</blockquote>

<blockquote>Write custom handling for undocumented symbols in modified files.
  <pre>
jazzy.undocumented.each do |item|
    message "You forgot to document this", file:item.file, line:item.line
end</pre>
</blockquote>

<blockquote>Write a custom handling for undocumented symbols in all files.
  <pre>
jazzy.undocumented(:all).each do |item|
    message "You forgot to document this", file:item.file, line:item.line
end</pre>
</blockquote>


#### Attributes

`path` - Path to the docs folder, defaults to 'docs/'.

`ignore` - List of files to ignore, defaults to [].

`message` -  Message to display, defaults to `Undocumented symbol %<symbol>s in *%<file>s*`.

`inline_message` - Message to display inline, defaults to `Undocumented symbol %<symbol>s`.


#### Methods

`check` - Checks files for modified symbols.

Takes a hash with the following keys:

 * `fail`
 * `warn`

Available scopes:

 * `modified`
 * `all`

`undocumented` - Returns a list of undocumented symbols in the current diff.

Available scopes:

 * `modified`
 * `all`

Version data entries

1 entries across 1 versions & 1 rubygems

Version Path
danger-jazzy-1.1.0 README.md