Skip to content

Baucis enables you to build scalable REST APIs using the open source tools and standards you and your team already know.

License

Notifications You must be signed in to change notification settings

CoorpAcademy/baucis

 
 

Repository files navigation

baucis

lerna Npm version Build Status codecov

Build scalable REST APIs using the open source tools and standards you and your team already know — Mongoose, Express, and Node.js streams.

Baucis takes the boilerplate out of building and maintaining scalable HATEOAS/Level 3 REST APIs.

⚠️ This is a fork from the Coorpacademy Tech Team ⚠️

This is so far intended for intern use

About this fork 📖

This fork adapt the internal structure of baucis, and the plugin system. It consist in a monorepros hosting the main baucis plugins (adapted to the new system).

One other major changes is that it enable you to inject the version of express or mongoose you want, getting ride of the mongoose <5 constraint.

Packages are release for the moment under @coorpacademy/ scope, but this is subject to change if the fork happens to be working and interest span out coorpacademy

Features 🛠️

  • Automatically build controllers from your Mongoose schemas, then easily configure them.
  • Built on Express 4 so adding custom middleware is a snap. Compatible with existing Express middleware.
  • Fully takes advantage of Node.js streaming to nimbly process large datasets.
  • Implements the HTTP specification according to the specifications (RFC 7231, etc.)
  • Widely compatible with a variety of front end frameworks.
  • Perform rich queries of the API using an expressive JSON syntax via query string.
  • Supports geolocation and full text search.
  • Version your API using semver.
  • Automatically generate interactive Swagger documentation for the API.
  • Highly customizable, simple interface. Can be extended with plugins.
  • Compatible with MongoDB 2.x and 3.x
  • Over 140 Mocha.js tests in addition to Express' and Mongoose's.

Getting Started 🚀

To install:

npm install --save @coorpacademy/baucis

It's easy to create an API from a Mongoose model:

const mongoose = require('mongoose');
const express = require('express');
const baucis = require('@coorpacademy/baucis')(mongoose, express)
// Create a mongoose schema.
const Vegetable = new mongoose.Schema({ name: String });
// Register new models with mongoose.
mongoose.model('vegetable', Vegetable);
// Create a simple controller.  By default these HTTP methods
// are activated: HEAD, GET, POST, PUT, DELETE
baucis.rest('vegetable');
// Create the app and listen for API requests
const app = express();
app.use('/api', baucis());
app.listen(4312);

That's it! Now you have an RFC-compliant, flexible, and semantically rich API dealing with vegetables. You could access it with URLs like http://localhost:4312/api/vegetables. CRUD is supported using GET, PUT, POST, and DELETE.

Examples 🏞️

Some new example is present in the examples folder. It make use of swagger plugins so you can directly have some explorer disponible when you run it.

Documentation 📕

Check out the Doc for more in-depth information about baucis.

Check the change log for info on recently implemented features.

About

Baucis enables you to build scalable REST APIs using the open source tools and standards you and your team already know.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 99.3%
  • HTML 0.7%