Build Status Coverage Status Code Climate Dependency Status License Documentation


    CSVlint is an online validation tool for CSV files. It validates conformity of CSV releases to standards, checks for missing or malformed data, and can validate against both CSVW and Datapackage schema standards.

    Summary of features

    CSVlint is a rails app designed to act as a continuous validation service, so that when data is changed online, the validation is updated. Data can be online or uploaded for private validation.

    The validation code is actually all done in a Ruby gem that can also be freely reused in other projects

    Follow the public feature roadmap for CSVLint



    Ruby version 2.3.1

    The application uses mongod and redis databases as background jobs for data persistence

    .env file (see below)

    Environment variables

    For running tests:


    For development add:


    In production add:


    Setting up the required environment variables

    Pusher setup
    1. Log in to
    2. Create a new application and call it something sensible
    3. Select the App Keys tab and get the values and paste them in to your .env file

    NOTE: You may be set up for a non-default Pusher cluster (The default is us-east-1), which causes some confusion. Look at your App overiew on and get the Cluster value from the 'Keys' section. Add this to your .env file as PUSHER_CLUSTER=

    Create an AWS S3 bucket and grant its permissions accordingly

    1. Log in to your AWS account and create an S3 bucket with a sensible name
    2. Now head to the AWS IAM (Identity and Access Management page)
    3. Click Users
    4. Add user (call it something sensible like octopub-development) and select Programmatic Access for Access Type.
    5. For permissions, select Attach existing policies directly - this will open a new tab in your browser.
    6. CLick create your own policy and give it a name, like octopub-dev-permissions, then for the policy document, use the following template, but add your own bucket name instead of <BUCKETNAME>.
       "Version": "2012-10-17",
       "Statement": [
               "Sid": "AllowAdminAccessToBucketOnly",
               "Action": [
               "Effect": "Allow",
               "Resource": [
    1. Click validate policy just to be sure you've not made a typo. Then confirm.
    2. Now back on the Set permissions page, select the policy you've just created in the table by selecting the checkbox. Then click Review then Create user.
    3. Now download the csv file containing the credentials and add the following to your .env file

    System dependencies and Configuration

    Install mongo: brew install mongo redis (if using brew)

    make a data directory for mongo databases sudo mkdir -p /data/db

    change directory ownership so that mongodb can operate sudo chown -R $USERNAME /data/

    Development: Running the full application locally

    Pre-requisites: AWS account, Pusher Account - these instructions assume you have these in place already.

    Checkout the repository and run bundle in the checked out directory.

    Database initialization

    run mongo : mongod

    run redis : redis-server

    Services (job queues, cache servers, search engines, etc.)

    to initialise the app run this in root directory of app

    foreman start

    Known issues & Troubleshooting

    If you have trouble running bundle try these (if you see errors relating to openssl, eventmachine or therubyracer)

    brew install openssl # if not installed gem install eventmachine -v '1.0.7' -- --with-cppflags=-I/usr/local/opt/openssl/include gem install libv8 -v '' -- --with-system-v8 gem install therubyracer -- --with-v8-dir=/usr/local/opt/v8-315 ~ rubyracer with CSVlint


    ensure phantomjs is installed, brew install phantomjs (or however you prefer)

    To run the entire suite of rspec unit tests and cucumber features execute bundle exec rake

    alternatively execute each suite separately with

    for unit tests execute bundle exec rspec

    for Cucumber features execute bundle exec cucumber

    Rake Tasks

    rake csvs:clean_up rake summary:generate rake clean_up:dupes


    Deployment on Heroku


    Check that your CSV files are valid

    🚀 Github 镜像仓库 🚀




    贡献者 18



    • Ruby 44.6 %
    • HTML 21.7 %
    • Gherkin 13.1 %
    • SCSS 13.1 %
    • JavaScript 7.4 %