meteor-generate/lib/commands.coffee

Generate Meteor scaffolding on demand

# Meteor Generate
# Copyright(c) 2014 Adam Brodzinski <adambrodzinski@gmail.com>
# MIT Licensed

# boot CLI
prog = require 'commander'
prog.version('0.0.8')


# hardcode set template path
# TODO add a config to use your own templates
path = require 'path'
global.templatePath = path.resolve("#{__dirname}/../templates/default/") + "/"


# helper to make printing look a bit nicer
global.puts = (msg, param1) ->
  unless param1
    console.log(msg || '')
  else
    console.log(msg, param1)


# require mgen modules
Package = require './package'
Namespace = require './namespace'
Component = require './component'
Collection = require './collection'



# -------------------  CLI Commands  -------------------



# Create Command
prog.command('create <projectName>')
  .description('Create a basic running app with a router.')

  .action((projectName, options) ->
    puts('\nCreating basic app structure')
    require('./init').init(projectName, options)
  )

  .on('--help', ->
    puts 'Scaffold out common files like .jshintrc, smart.json, and a makefile'
    puts ''
    puts '  Example:'
    puts '  $ mgen create mybook'
    puts '  $ cd mybook'
    puts '  $ meteor'
    puts ''
  )


# Collections
prog.command('collection <collectionName>')
  .description('Add a collection to the clientside and serverside')

  .action((collectionName, options) ->
    puts("\nInserting #{collectionName} collection")
    new Collection(collectionName, options)
  )

  .on('--help', ->
    puts "Inserts a collection"
  )



# Components Command
# copies a Meteor component boilerplate folder and moves it into component directory.
#
prog.command('component <component_name>')
  .description('Create a component template, JS, and Sass files')

  .option("-d, --directory <path>", "Change the default component directory 'client/components'", "client/components/")

  .action((compName, options) ->
    component = new Component(compName, options)
  )

  .on('--help', ->
    puts '  Create a component boilerplate folder including a HTML template, JS, & Sass file.'
    puts "  If a component name has multiple words use 'snake_case'"
    puts ''
    puts '  Examples:'
    puts '  $ mgen component header'
    puts '  $ mgen component stock_ticker'
    puts ''
  )


# Page Command
# copies a Meteor page boilerplate folder and moves it into client/page directory.
prog.command('page <page_name>')
  .description('Create a page folder with HTML, JS, and Sass files')

  .option("-d, --directory <path>", "Change the default component directory 'client/pages'", "client/pages/")
  .option("-i, --index", "Only create an 'index' page")
  .option("-s, --show",  "Only create a 'show' page")
  .option("-n, --new",   "Only create a 'new' page")
  .option("-e, --edit",  "Only create an 'edit' page")

  .action((pageName, options) ->
    require('./page').run(pageName, options)
    puts('Creating Pages')
  )

  .on('--help', ->
    puts '  Create a page boilerplate folder including a HTML template, JS, & Sass file.'
    puts "  By default all crud actions will be generated, e.g., new.js, show.js, edit.js, index.js"
    puts "  Pass --show flag to only generate show.js, show.html, etc.."
    puts "  If a page name has multiple words use 'snake_case'"
    puts ''
    puts '  Examples:'
    puts '  $ mgen page users'
    puts ''
  )


# Controller Command
# create a controller and page template
prog.command('controller <name>')
  .description("Create a controller with it's associated pages. Routes are appended to both/routes.js")
  .option("-D, --directory <path>", "Change the default controller directory 'both/controllers/'\n", "both/controllers/")
  .option("-i, --index",  "Create an index controller  - Page of 'posts'")
  .option("-n, --new",    "Create a new controller     - Page to create 'a post'")
  .option("-s, --show",   "Create a show controller    - Page to show 'a post'")
  .option("-e, --edit",   "Create an edit controller   - Page to edit 'a post'")
  .option("-c, --create", "Create a create controller  - No page, No Route")
  .option("-u, --update", "Create an update controller - No page, No Route")
  .option("-d, --destroy", "Create a delete controller  - No page, No Route")

  .action((resourceName, opts) ->
    puts('\nCreating Routes')
    namespace = new Namespace
    namespace.createFile()
    require('./router').create()
    require('./controller').init(resourceName, opts)
    puts('Creating Pages')
  )

  .on('--help', ->
    puts '  Create Iron Router controllers & their page templates. Routes are automatically appended'
    puts "  to the bottom of routes.js. To create a single page/controller, pass in it's action flag"
    puts ''
    puts '  Data only controllers (create, update, destroy) do not create routes, but'
    puts '  allow you to organize data calls. Optional Meteor Methods in the future.'
    puts '  Run the `mrt` command to install Iron Router if this is the first time.'
    puts ''
    puts '  Examples:'
    puts '  $ mgen controller posts  ( generate all controllers )'
    puts '  $ mgen controller posts --edit --new'
    puts '  $ mgen controller posts -en'
    puts '  $ mrt  #run mrt first time to install iron router'
    puts ''
  )


# Package Command
prog.command('package <packageName>')
  .description('Create a basic Meteor/Atmosphere package')

  .action((packageName, options) ->
    puts('\nCreating package ' + packageName)
    _package = new Package()
    _package.create(packageName, options)
  )

  .on('--help', ->
    puts 'Create a basic Meteor/Atmosphere package. Includes a smart.json file'
    puts 'if you wish to publish it to atmosphere.'
    puts ''
    puts '  Example:'
    puts '  $ mgen package form-checker'
    puts ''
  )


# fire up Commander
prog.parse(process.argv)