Skip to content
moved -> 'lucid.publish'
Clojure CSS JavaScript
Branch: master
Clone or download
zcaudate Merge pull request #14 from orthographic-pedant/spell_check/accommodate
Fixed typographical error, changed accomodate to accommodate in README.
Latest commit 0e7e435 Oct 1, 2015
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs @ edffaa7 Regenerated midje-doc May 28, 2014
resources/template fixed bug in 0.0.9 Sep 23, 2013
src/leiningen Fixing tests Apr 21, 2015
test Fixed tests Oct 8, 2014
.gitignore Fixing tests Apr 21, 2015
.gitmodules fixing travis Apr 21, 2014
.travis.yml Fixing travis build Apr 19, 2014
README.md Fixed typographical error, changed accomodate to accommodate in README. Sep 30, 2015
documentation_tool.png Added video link Sep 26, 2013
project.clj Fixing tests Apr 21, 2015

README.md

lein-midje-doc

lein-midje-doc fixes the problem of incorrectly documented examples by bridging the gap between writing tests and writing documentation.

Build Status

DEPRECATION NOTICE

lein-midje-doc has been DEPRECATED, the new repo can be found at helpshift/hydrox. The announcement was made here.

Whats New

0.0.24

New submodules for working with project

  • markdown for testing code in your markdown files
  • scaffold for generating test scaffolding from souces
  • import for importing docstrings from tests
  • purge for removing docstrings from sources

Installation

lein-midje-doc is a leiningen plugin. Install by adding entries in ~/.lein/profiles.clj:

 {:user {:plugins ...
         [lein-midje-doc "0.0.24"]
         ...}}

Notice:

It has come to my attention that users of this plugin will need to install pygments as the library won't work otherwise. This will be definitely be fixed in future versions but I'm a little bit busy right now so please excuse the mess =)

Visit the main site for more information.

Here is a video of the demonstration of a workflow using midje, midje-doc and live-reload. For those that wish to cut to the chase, skip to ~around 7:20 ScreenShot

Features:

  1. To generate .html documentation from a .clj test file.
  2. To express documentation elements as clojure datastructures.
  3. To render clojure code and midje facts as code examples.
  4. To allow tagging of elements for numbering and linking.

Benefits:

  1. All documentation errors can be eliminated.
  2. Removes the need to cut and copy test examples into a readme file.
  3. Entire test suites can potentially be turned into nice looking documentation with relatively little work.

Turn off Advert Notice

It is hoped that users of lein-midje-doc can leave the Generated By: MidjeDoc notice in order to support this library. It can be turned off by placing {:documentation {:advertise false ...}} in project.clj.

Wishlist for the Future:

In the current state, this library is really just a hack job generating some pretty output. It is hoped that when I find some time, the library can be designed to accommodate more features:

  • Latex Features
    • Table of Figures
    • Table of Examples
    • Citations
    • Customisation Numbering
    • Appendices
    • Equations
  • Themes
  • Elements
    • :reference element for tabulization of ns-publics in a namespace
  • Attributes
    • :ignore
  • Linking to Multiple Documents (Generate an entire Site)
  • Additional Test Suites
    • core.test
    • purnam.test
  • pdf output with page numbering
  • markdown output
  • Codebase
    • Refactor with multimethods
    • Clean up hacked-in code

Contributors

  • Chris Zheng
  • Yannick Scherer
  • Alex Walker

License

Copyright © 2014 Chris Zheng

Distributed under the The MIT License.

You can’t perform that action at this time.