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-js-api

v0.9.0

Published

Generates a setup for building a Javascript API supporting the AMD modules and more.

Downloads

10

Readme

generator-js-api Build Status

Yeoman generator that scaffolds out a develoment environment for a Javascript API.

Features

  • Automatically lint your scripts
  • Unit Testing with Karma and PhantomJS
  • Minification and versioning
  • Support for source maps
  • Support for JSDoc

For more information on what generator-js-api can do for you, take a look at the Gruntfile.js.

Getting Started

  • Install: npm install -g generator-js-api
  • Run: yo js-api
  • Run grunt for building

Prompts

  • namespace

    The namspace (default is 'my.Api') will be added to the API's (see filename prompt below) file. The API file will ensure that the namespace is created for testing and that the top level object is known to JSHint. There is no validation done on the namespace.

  • module

    The name of the AMD module (default is 'my-api') will used when registering the API as an AMD module. The module will only be registered if the define function is present and contains the 'amd' property.

  • filename

    This input will be the filename of your API. It will be used to rename the default, 'api.js', to whatever you choose, i.e. my-api.js. Any whitespace within the filename will be replaced with a dash '-'.

Options

  • --skip-install

    Skips the automatic execution of npm install after scaffolding has finished.

Project Overview

The API template uses a functional style for the API, which allows for better encapsulation by declaring private functions and members. All public interface methods are returned by the function in form of an object. They can either point to private function or be a function implementation themselves.

Contribute

Feel free to contact me if you like to contribute.

If not, generator-js-api is fork-friendly and you can always maintain a custom version which you npm install && npm link to continue using via yo js-api or a name of your choosing.

Changelog

0.8.0

  • Updated dependencies of the API project
  • Fixed issue in Gruntfile where the wrong file names would be used inside the "dist" folder

0.7.0

  • Upgraded yeoman-generator dependency and fixed deprecated calls
  • Changed JsMock dependency version to 0.x
  • Switch grunt task loader to git-grunt
  • Added missing dependencies to package.json

0.6.0

  • Upgraded yeoman-generator dependency and fixed deprecated calls

0.5.0

  • Switched mocking library from Sinon.JS to JsMock

0.4.1

  • Updated package due to NPM packaging errors

0.4.0

  • Updated all npm dependencies in generator and templates

License

MIT