Skip to content

chrisbarrett/apidoc-checker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

74 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

apidoc-checker

Tooltip displayed over syntax error in Emacs

A tool to validate apidoc specifications. Provides pretty error messages for command-line use, and includes a Flycheck checker for Emacs.

Dog at a computer with an overlay labelled "excellent"

Usage

apidoc-checker - apidoc spec validator

Usage: apidoc-checker FILE [--plain]
  Validates an apidoc JSON specification

Available options:
  -h,--help                Show this help text
  FILE                     Path to the apidoc spec to validate
  --plain                  Remove ANSI colour codes from output.

Installation

  1. Install stack

  2. Clone this repository and install the tool with stack

    git clone https://github.com/chrisbarrett/apidoc-checker.git
    cd apidoc-checker
    stack install

Flycheck Integration

  1. Configure Emacs to use MELPA as one of your package sources. This is already done for you in Spacemacs.

  2. Run M-x package-install-file apidoc-checker/elisp/apidoc-checker.el to install the package and its dependencies.

When you visit api.json files you should now automatically enter apidoc-mode and get those sweet sweet error squiggles.

Contributions

PRs welcome.

License

See LICENSE. Copyright (c) 2016 Chris Barrett.

About

A command-line tool to verify apidoc specifications

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published