harmony: A web service specification compiler that generates implementation and tests.

[ development, gpl, library, program ] [ Propose Tags ]

A parser of web service specification that is able to generate servers, clients and tests.

[Skip to Readme]


Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


  • No Candidates
Versions [RSS],,,, (info)
Dependencies array, base (>=4.6 && <5), BNFC, containers, derive, directory, harmony, hastache, hslogger, mtl, process, QuickCheck, text [details]
License GPL-3.0-only
Author Santiago Munín
Maintainer santimunin@gmail.com
Category Development
Bug tracker https://github.com/SantiMunin/harmony/issues
Source repo head: git clone https://github.com/SantiMunin/harmony
Uploaded by SantiMunin at 2015-08-19T06:41:53Z
Executables harmony
Downloads 2823 total (12 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-08-19 [all 1 reports]

Readme for harmony-

[back to package description]

Harmony Hackage version Build Status

Harmony is a web service specification compiler that generates implementation (server and client) and tests.

Targets supported

  • Server
    • Node.js (-sjs)
  • Client
    • Python (-cpython)
    • Java (-cjava)


  • From Hackage: cabal install harmony
  • From source code: git clone https://www.github.com/SantiMunin/harmony && cd harmony && cabal install


After installing the package (cabal install), you will get the harmony executable. Afterwards:

Usage: harmony [OPTION...] input_file
  -c[CLIENTS]     --client[=CLIENTS]         Desired output for the client: {-cpython, -cjava}
  -s[SERVERS]     --server[=SERVERS]         Desired output for the server: {-sjs}
  -o[OUTPUT_DIR]  --output_dir[=OUTPUT_DIR]  Output path

Check the Targets supported section to figure out the code related to each target. Also, refer to the wiki for more information.


The input file should follow the syntax specified in language_spec/Language.cf. Example:

service_name: HouseworkService
service_version: 1.0.0

enum Color { RED, BLUE, BLACK }

struct Task {
   // Primary key
   name : String,
   color : Color

struct Person {
  name: String,
  age: Int,
  tasks: [Task]

resource Person ("/person")


See the wiki.