Code Monkey home page Code Monkey logo

generator-apiary-lib's Introduction

Deprecated Apiary Library Generator

Apiary's Yeoman generator for basic project scaffolding. Allows you to start a new library in couple of minutes, with all initial setup as required or recommended by internal directions.

CircleCI Build Status

Deprecation notice

Unfortunately, this project is no longer used in Apiary and won't be developed anymore. Feel free to fork it or get inspired by it, but do not expect any further support and development.

Demo

Demo

Templates

  • coffee for CoffeeScript
  • es5 for JavaScript
  • es6 for ECMAScript2015

Adding a new template

The generator was made with the idea of having templates available also for languages not based on JavaScript, but the initial version doesn't feature any. If you want to contribute a template for Ruby, Python, or other language, feel free to do so, but you might need to perform some changes also to the generator itself, as there is probably some code, which is JavaScript-specific and not general enough. This is a known limitation and an unfortunate burden put on the first contributors, but thanks to it the generator could become real very quickly.

Installation

$ npm install yo -g  # make sure Yeoman is installed
$ npm install generator-apiary-lib -g

Usage

Use the generator in the root of your project. If you want to start a new project, create yourself a new project directory. The generator doesn't have to be ran in an empty directory, though.

$ mkdir ~/<your directory with projects>/<project directory>
$ cd ~/<your directory with projects>/<project directory>
$ apiary-lib  # runs the generator

You shouldn't need to worry about existing .git directory or other files. The generator will ask you should it ever need to overwrite an existing file. Also, Git helps in case something gets overwritten. This way you should be able to use the template also on existing projects, not only on new ones.

Development

As the generator is written in ES6 and transpiled by Babel, seamless development of it is not so simple. Clone the repository and in the project directory (e.g. ~/<your directory with projects>/generator-apiary-lib) do following:

$ npm install yo -g  # make sure Yeoman is installed
$ npm install  # install local version of the generator
$ npm link  # make the local version accessible to the global Yeoman generator

Then create yourself a separate, empty directory (e.g. ~/<your directory with projects>/playground) where you want to play with the generator. In this new directory you can run:

$ (cd ~/<your directory with projects>/generator-apiary-lib && npm run compile) && apiary-lib

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.