Awesome

<a href="https://codeship.com/projects/132638"><img alt="Build Status" src="https://codeship.com/projects/33492670-b039-0133-9188-565ee1f98c10/status?branch=master"></a>

<a href="https://travis-ci.org/mabrasil/generator-ocaml"><img alt="Build Status" src="https://travis-ci.org/mabrasil/generator-ocaml.svg?branch=master"></a>

<a href="https://codeclimate.com/github/mabrasil/generator-ocaml"><img alt="Code Climate" src="https://codeclimate.com/github/mabrasil/generator-ocaml/badges/gpa.svg"/></a>

<a href="https://david-dm.org/mabrasil/generator-ocaml" title="Dependency status"><img src="https://david-dm.org/mabrasil/generator-ocaml.svg"/></a>

<a href="https://david-dm.org/mabrasil/generator-ocaml#info=devDependencies" title="devDependency status"><img src="https://david-dm.org/mabrasil/generator-ocaml/dev-status.svg"/></a>

Table of Contents

• This Project
  • Scaffold OCaml modules?
  • Getting To Know Yeoman
• Installation
• Usage
  • Getting Started
  • Other Options
• Development
• Contributing
• History
• License
• Credits

This Project

Scaffold OCaml modules?

OCaml is a general purpose programming language with an emphasis on expressiveness and safety which supports both functional, imperative and object-oriented paradigms and features a powerful type system, user-definable algebraic data types and pattern-matching.

This project is Yeoman generator that provides a OCaml project skeleton with the following integrated features:

• The OASIS build-system
• The OCamlDoc automatic documentation generation
• The OUnit testing framework
• The Bisect code coverage framework

Getting To Know Yeoman

Yeoman is a node.js tool used to scaffold new applications. It can create common project assets like stylesheets and JavaScript files. Basically Yo provides an easy way to create all of the boilerplate code you need to get started on a project.

Feel free to learn more about it here.

Installation

First, make sure you have the main dependencies:

• node.js dependencies:
  • node.js & npm
  • Yeoman
• OCaml dependencies:
  • OCaml
  • OPAM
• General
  • GNU Make

Then install the generator-ocaml.

npm install -g generator-ocaml

Usage

Getting Started

1. Generate your new project:

yo ocaml

You will be asked the following about your project:

• What's the package name?
• What's your package all about?
• What's the package version?
• What's your name?
• What's your email?
• What's your Github username?
• Choose your license type (Use arrow keys)

And the you should see the following structure:

|-- lib/
|   |-- myModule.ml/
|-- test/
|   |-- myModule_test.ml
|-- .gitattributes
|-- .gitignore
|-- _oasis
|-- CHANGELOG.md
|-- CONTRIBUTING.md
|-- LICENSE.md
|-- Makefile
|-- README.md

1. Install the OCaml dependencies:

opam init
opam install oasis ounit bisect

1. Generate the setup.ml file - which will handle any high-level operation on the project source.

oasis setup

1. Configure the build-system:

ocaml setup.ml -configure --enable-tests

1. Build the project:

make

Other Options

To run the test suite, you just have to:

make tests
# Or
ocaml setup.ml -tests

Generating the documentation with OCamlDoc is just the same:

make doc
# Or
ocaml setup.ml -doc

These are the commands you have in setup.ml:

Development

All the tasks needed for development automation are defined in the package.json scripts property and can be run via:

npm run <command>

Here is a summary of all the commands:

Contributing

Contributions are very welcome! If you'd like to contribute, these guidelines may help you.

History

Check the releases list.

License

generator-ocaml is distributed under the MIT License, available in this repository.

All contributions are assumed to be also licensed under the same.

Credits

The templates codebase was originally inspired by these two projects.