npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

generator-apiary-lib

v0.0.4

Published

Apiary Library Generator

Downloads

5

Readme

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