Cohesion

Intro

Cohesion is a group of tasks that allow you to check link cohesion in a site.

Installation

Add to your Gemfile

gem 'cohesion'

or you can just install without bundler with

gem install cohesion

Usage

Command Line

Running from the command line has the following syntax

cohesion --url http://your-site-to-check.com/

Options

Cohesion allows you to control the crawl through various command line options. These are available through help (see below) and are listed here.

• —url Url to start crawl from
• —internal_urls <url1,url2 or filename> List of url patterns to include (comma seperated list or filename with url per line)
• —external_urls <exclude_url1, exclude_url2 or filename> List of url patterns to exclude (comma seperated list or filename with url per line)
• —seed_urls <seed_url1,seed_url2 or filename> Seed urls (comma seperated list or filename with url per line)
• —crawl_limit Limit the crawl to a number of urls
• —thread_count Set the number of threads used
• —cache Sets the timeout for the cache, leave blank for no cache
• —timeout Sets the timeout for http requests
• —output Path to output data to
• —output_format Output format, csv or json
• —authentication Authentication to use, currently only basic
• —username Username to use with authentication specified
• —password Password to use with authentication specified

• -v, —verbose Display crawl information
• -d, —debug Display debug information
• -w, —web_statistics Start web stats server (http://localhost:4567)

Help

Help with available options is available with —help

cohesion --help

Rake

You can check an external site with the rake task below. This will crawl the site and check each link within the site, and will also check the links to external sites. It will also check image, stylesheet and javascript references from link tags.

rake cohesion:check["http://your-site-to-check.com"]

Checking your local development environment

Originally the intention was to add this to your specs and render the rails templates from within the app, i’ve not completed this yet so currently you can check your local development environment the same way as you do an external, but point to your local server:

rake cohesion:check["http://localhost:3000/"]
k

Future

I intend to add the ability to check the rails app without starting the server though, which would allow you to add it to your specs.

Contribute

If you want to contribute, you can fork the github repository and submit pull requests, or you can donate me some development fuel… ie coffee/beer use this link

DONATE!