ngi 0.2.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 119801cbccb57371891100b9178b947823859d00
+  data.tar.gz: b129e85c5cc365c3e4fc2f2672fe1c0e40ca7506
+SHA512:
+  metadata.gz: 255746a7d8b4dcf7c23f38cae6829adba8631860c9c8da90c48583ffd446889c541f362456d5237d3a2c63c1b51f7084832b37439610f39d907f9492bce3ac19
+  data.tar.gz: e6fd90484636fc1a66ec48dfe7082022c8f80795edf6538701af40fa68cbaebea07ae53a3b72723a0820ab01fa3409f54249056efeefbd554315bc90e7b4ad03

data/.gitignore

@@ -0,0 +1,23 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.DS_Store

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ngi.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2015 Joshua Beam
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,164 @@
+# angular_init 0.2.0
+
+<a href="http://joshbeam.github.io/angular_init">Website</a>
+
+**What's different?**
+- Install it as a gem (`gem install ngi`)
+- You can now make an `index` boilerplate HTML page (`ngi index`)
+- Use `ngi -h` to see all commands
+
+## In simple terms:
+
+This tool (`ngi`) can make (for example) an AngularJS controller template file for you (`.js`), so that **whenever you want to make a new controller for your app, you don't have to type the same starting code over and over again** (by the way, this tool doesn't only create controllers. It does directives, filters... almost anything).
+
+## Why use `ngi` (and not something else)?
+
+**`ngi` has one task, and one task only, which makes it lightweight and specialized**. Most AngularJS developers are probably using the command line already (Gulp, Bower, npm, Git, etc.), so why not use the command line to streamline your code-writing too?
+
+Type less, write more AngularJS! Use `ngi`, the simple template generator.
+
+![Example](https://github.com/joshbeam/angular_init/blob/master/ngi_example.gif "Example")
+
+# Table of Contents
+
+- [Sample Usage][sample-usage]
+- [Features][features]
+- [Install in 1 step][install]
+- [How to use it (docs)][commands]
+- [FAQ][faq]
+- [Technical Info][tech-info]
+
+# Sample Usage
+
+After you [do the 1-step installation][install] of `ngi` (the short-name for the shell script of `angular_init`), go to where your site is at (in this case, `~/MyAwesomeApp`). When you're in your site's project directory, just type `ngi <component>` to create a new JavaScript file for you!
+
+## Command line
+
+```shell
+~/MyAwesomeApp $ ngi controller # this will create a controller!
+
+# you'll be prompted for some quick info
+[?] New file name: myAwesome.controller.js
+[?] Module name: myModule
+[?] Controller name: MyAwesomeController
+[?] Inject (already injected $scope): $route
+
+# all done!
+```
+
+## Output (your new boilerplate code)
+
+```javascript
+// ~/MyAwesomeApp/myAwesome.controller.js
+
+;(function(app) {
+
+	'use strict';
+
+	app.controller('MyAwesomeController',MyAwesomeController);
+
+	MyAwesomeController.$inject = ['$route', '$scope'];
+
+	function MyAwesomeController($route, $scope) {
+	
+	}
+
+})(angular.module('myModule'));
+```
+
+By the way, the output of this little tool is meant to follow [John Papa's AngularJS Style Guide][style-guide].
+
+# Features
+
+## Current features
+
+- Create a module, directive, controller, filter, run, config, "routes" config, constant, service, factory, or index HTML page by saying `ngi <component>`, where `<component>` is any of the above types (module, directive, etc.)
+- Current languages that have default templates: CoffeeScript, ECMAScript5 (choose your language with `ngi --config (or -c)`)
+
+## Coming soon
+
+- Add custom templates and languages
+
+Feel free to fork the project or get <a href="http://frontendcollisionblog.com/about">in touch with Josh (me)</a> with any feature requests!
+
+# Installation (in 1 step)
+
+**Dependencies** [Ruby 2.1.0][ruby] and [RubyGems][rubygems] (optional [Bundler][bundler])
+
+Add this line to your application's Gemfile:
+
+    gem 'ngi'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ngi
+
+# Commands
+
+```shell
+~/MyAwesomeApp $ ngi controller # => controller
+~/MyAwesomeApp $ ngi directive # => directive
+~/MyAwesomeApp $ ngi factory # => factory
+~/MyAwesomeApp $ ngi service # => service (same as factory)
+~/MyAwesomeApp $ ngi constant # => constant
+~/MyAwesomeApp $ ngi run # => a run block
+~/MyAwesomeApp $ ngi config # => a config block
+~/MyAwesomeApp $ ngi routes # => a config block with $routeProvider injected
+~/MyAwesomeApp $ ngi module # => module (you can inject dependencies too)
+~/MyAwesomeApp $ ngi filter # => filter
+
+# or
+
+~/MyAwesomeApp $ ngi index # => an index page in HTML
+
+# or
+
+# use either --options or -o
+~/MyAwesomeApp $ ngi --options # => choose your language to use (CoffeeScript or ECMAScript5)
+```
+
+# FAQ
+
+**1. Can you explain why the module name is passed as the argument to the IIFE (in the default template)?**
+
+- If you're using a JSHint plug-in, it will only say 'angular is not defined' in one place
+- Eliminates the clutter of declaring something like `var app = angular.module('myModule')`
+- Something like `angular.module('myModule')` cannot be minified, but the argument `app` can (only an issue if the full module getter happens multiple time)
+- Streamlines the pattern across all of the templates
+
+**2. Why are you using `$inject`?**
+
+Check out [John Papa's Style Guide][style-guide].
+
+**3. Why are you following the snake-case convention (`angular_init`) and not camelCase (`angularInit`) if this is a JavaScript project?**
+
+The command line tool itself is written in <a href="https://www.ruby-lang.org/en/">Ruby</a>, and the <a href="https://github.com/bbatsov/ruby-style-guide#snake-case-files">convention</a> is to use snake-case for class file naming.
+
+*For other questions and comments, check out this <a href="http://www.reddit.com/r/angularjs/comments/30ydha/command_line_tool_to_create_angularjs_controllers/">Reddit discussion</a> about `ngi` (feel free to post your own question too). Or, open a new issue on GitHub.*
+
+# Technical Information
+
+**Version** 0.2.0
+
+**Language** Ruby
+
+**Requirements** Only tested with `ruby 2.1.0p0 (2013-12-25 revision 44422) [x86_64-darwin13.0]`. Compatibility with previous versions of Ruby cannot be guaranteed.
+
+<hr>
+
+&copy; 2015 Joshua Beam (MIT License) &mdash; <a href="http://frontendcollisionblog.com">Front End Collision</a>
+
+[install]: #installation-in-1-step
+[sample-usage]: #sample-usage
+[features]: #features
+[commands]: #commands
+[faq]: #faq
+[tech-info]: #technical-information
+[style-guide]: https://github.com/johnpapa/angular-styleguide
+[rubygems]: https://rubygems.org/pages/download
+[ruby]: https://www.ruby-lang.org/en/downloads/
+[bundler]: http://bundler.io/

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/ngi

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+
+# angular_init (short-name: ngi)
+# Copyright 2015 Joshua Beam
+# github.com/joshbeam/angular_init
+# MIT License
+
+# Ngi is the main module (src/ruby/angular_init.rb)
+require_relative '../lib/ngi'
+require_relative '../lib/ngi/utils/utils'
+
+class Parser
+	@@config = Ngi::Delegate::Configure.new.from_json
+	@@types = Ngi::UserInput.new(valid_inputs: @@config['global']['components'].collect{ |t| t['name'] })
+
+	def self.parse(args)
+		parser = Utils::CommandParser.new do |parser|
+			parser.name = "ngi"
+			parser.version = Ngi::VERSION
+			parser.banner << "\n(<command> can be one of the following)"
+
+			parser.on(@@types.valid_inputs, "Create a new component") do |command|
+				Ngi::Delegate::Generator.run(type: command, config: @@config)
+			end
+
+			parser.on(["-o","--options"], "Configure ngi") do
+				Ngi::Delegate::Configure.run()
+			end
+		end
+
+		parser.parse(args)
+	end
+end
+
+Parser.parse(ARGV)

data/lib/config/angular_init.config.json

@@ -0,0 +1,100 @@
+{
+  "global": {
+    "configurable": {
+      "language": "language"
+    },
+    "menus": {
+      "options": "-options"
+    },
+    "languages": {
+      "script": [
+        "es5",
+        "coffee"
+      ],
+      "markup": [
+        "html"
+      ]
+    },
+    "language": {
+      "script": "es5",
+      "markup": "html"
+    },
+    "types": {
+      "script": "script",
+      "markup": "markup"
+    },
+    "components": [
+      {
+        "name": "directive",
+        "type": "script",
+        "using": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "controller",
+        "type": "script",
+        "using": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "factory",
+        "type": "script",
+        "using": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "service",
+        "type": "script",
+        "using": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "config",
+        "type": "script",
+        "using": "default",
+        "template": "config.js"
+      },
+      {
+        "name": "run",
+        "type": "script",
+        "using": "default",
+        "template": "config.js"
+      },
+      {
+        "name": "routes",
+        "type": "script",
+        "using": "default",
+        "template": "config.js"
+      },
+      {
+        "name": "filter",
+        "type": "script",
+        "using": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "module",
+        "type": "script",
+        "using": "default",
+        "template": "module.js"
+      },
+      {
+        "name": "constant",
+        "type": "script",
+        "using": "default",
+        "template": "constant.js"
+      },
+      {
+        "name": "index",
+        "type": "markup",
+        "using": "default",
+        "template": "index.html"
+      }
+    ],
+    "aliases": {
+      "config": [
+        "routes"
+      ]
+    }
+  }
+}

data/lib/config/backup.angular_init.config.json

@@ -0,0 +1,72 @@
+{
+  "global": {
+    "configurable": {
+      "language": "language"
+    },
+    "menus": {
+      "options": "-options"
+    },
+    "languages": [
+      "es5",
+      "coffee"
+    ],
+    "language": "es5",
+    "types": [
+      {
+        "name": "directive",
+        "source": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "controller",
+        "source": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "factory",
+        "source": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "service",
+        "source": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "config",
+        "source": "default",
+        "template": "config.js"
+      },
+      {
+        "name": "run",
+        "source": "default",
+        "template": "config.js"
+      },
+      {
+        "name": "routes",
+        "source": "default",
+        "template": "config.js"
+      },
+      {
+        "name": "filter",
+        "source": "default",
+        "template": "basic.js"
+      },
+      {
+        "name": "module",
+        "source": "default",
+        "template": "module.js"
+      },
+      {
+        "name": "constant",
+        "source": "default",
+        "template": "constant.js"
+      }
+    ],
+    "aliases": {
+      "config": [
+        "routes"
+      ]
+    }
+  }
+}

data/lib/dep/json.rb

@@ -0,0 +1,62 @@
+require 'json/common'
+
+##
+# = JavaScript Object Notation (JSON)
+#
+# JSON is a lightweight data-interchange format. It is easy for us
+# humans to read and write. Plus, equally simple for machines to generate or parse.
+# JSON is completely language agnostic, making it the ideal interchange format.
+#
+# Built on two universally available structures:
+#   1. A collection of name/value pairs. Often referred to as an _object_, hash table, record, struct, keyed list, or associative array.
+#   2. An ordered list of values. More commonly called an _array_, vector, sequence or list.
+#
+# To read more about JSON visit: http://json.org
+#
+# == Parsing JSON
+#
+# To parse a JSON string received by another application or generated within
+# your existing application:
+#
+#   require 'json'
+#
+#   my_hash = JSON.parse('{"hello": "goodbye"}')
+#   puts my_hash["hello"] => "goodbye"
+#
+# Notice the extra quotes <tt>''</tt> around the hash notation. Ruby expects
+# the argument to be a string and can't convert objects like a hash or array.
+#
+# Ruby converts your string into a hash
+#
+# == Generating JSON
+#
+# Creating a JSON string for communication or serialization is
+# just as simple.
+#
+#   require 'json'
+#
+#   my_hash = {:hello => "goodbye"}
+#   puts JSON.generate(my_hash) => "{\"hello\":\"goodbye\"}"
+#
+# Or an alternative way:
+#
+#   require 'json'
+#   puts {:hello => "goodbye"}.to_json => "{\"hello\":\"goodbye\"}"
+#
+# <tt>JSON.generate</tt> only allows objects or arrays to be converted
+# to JSON syntax. <tt>to_json</tt>, however, accepts many Ruby classes
+# even though it acts only as a method for serialization:
+#
+#   require 'json'
+#
+#   1.to_json => "1"
+#
+module JSON
+  require 'json/version'
+
+  begin
+    require 'json/ext'
+  rescue LoadError
+    require 'json/pure'
+  end
+end