Skip to content

Commit

Permalink
Edited README.md via GitHub
Browse files Browse the repository at this point in the history
  • Loading branch information
duncan-bayne committed Oct 13, 2011
1 parent c7cf4aa commit 2dc1f16
Showing 1 changed file with 18 additions and 9 deletions.
27 changes: 18 additions & 9 deletions README.md
@@ -1,21 +1,26 @@
= roodi
roodi
=====

* http://roodi.rubyforge.org

== DESCRIPTION:
DESCRIPTION
-----------

Roodi stands for Ruby Object Oriented Design Inferometer. It parses your Ruby code and warns you about design issues you have based on the checks that is has configured.

== INSTALL:
INSTALL
-------

* sudo gem install roodi

== SYNOPSIS:
SYNOPSIS
--------

To check one or more files using the default configuration that comes with Roodi, use:
roodi [-config=file] [pattern ...]

=== EXAMPLE USAGE
EXAMPLE USAGE
-------------

Check all ruby files in a rails app:
roodi "rails_app/**/*.rb"
Expand All @@ -32,7 +37,8 @@ Check all ruby files in a rails app with a custom configuration file:
If you're writing a check, it is useful to see the structure of a file the way that Roodi tokenizes it (via ruby_parser). Use:
roodi-describe [filename]

== CUSTOM CONFIGURATION
CUSTOM CONFIGURATION
--------------------

To change the set of checks included, or to change the default values of the checks, you can provide your own config file. The config file is a YAML file that lists the checks to be included. Each check can optionally include a hash of options that are passed to the check to configure it. For example, the default config file looks like this:

Expand All @@ -50,7 +56,8 @@ To change the set of checks included, or to change the default values of the che
ModuleNameCheck: { pattern: !ruby/regexp /^[A-Z][a-zA-Z0-9]*$/ }
ParameterNumberCheck: { parameter_count: 5 }

== SUPPORTED CHECKS:
SUPPORTED CHECKS
----------------

* AssignmentInConditionalCheck - Check for an assignment inside a conditional. It's probably a mistaken equality comparison.
* CaseMissingElseCheck - Check that case statements have an else statement so that all cases are covered.
Expand All @@ -66,11 +73,13 @@ To change the set of checks included, or to change the default values of the che
* ModuleNameCheck - Check that module names match convention.
* ParameterNumberCheck - Check that the number of parameters on a method is below the threshold.

== SUGGESTED CHECKS:
SUGGESTED CHECKS
----------------

* BlockVariableShadowCheck - Check that a block variable does not have the same name as a method parameter or local variable. It may be mistakenly referenced within the block.

== LICENSE:
LICENSE
-------

(The MIT License)

Expand Down

0 comments on commit 2dc1f16

Please sign in to comment.