chore(build): automate release process

Author: ajoslin

.editorconfig

@@ -0,0 +1,18 @@
+# This file is for unifying the coding style for different editors and IDEs
+# editorconfig.org
+
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+
+# Tabs in JS unless otherwise specified
+[**.js]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false

.gitignore

@@ -1,6 +1,7 @@
 .DS_Store
 node_modules
 *.sw[mnpcod]
+*.log
 example/cordova/iOS/www/js/framework
 
 example/cordova/iOS/www/js/framework
@@ -16,3 +17,4 @@ UserInterfaceState.xcuserstate
 
 bower_components/
 components/
+tmp

.travis.yml

@@ -6,3 +6,6 @@ before_script:
   - npm install -g grunt-cli
   - export DISPLAY=:99.0
   - sh -e /etc/init.d/xvfb start
+
+script:
+  - ./scripts/travis/ci.sh

Gruntfile.js

@@ -1,65 +1,50 @@
+var cp = require('child_process');
+var buildConfig = require('./config/build');
+
 module.exports = function(grunt) {
 
   grunt.initConfig({
+
     concat: {
       options: {
         separator: ';\n'
       },
       dist: {
-        src: [
-          'js/_license.js',
-
-          // Base
-          'js/ionic.js',
-
-          // Utils
-          'js/utils/**/*.js',
-
-          // Views
-          'js/views/view.js',
-
-          'js/views/scrollView.js',
-
-          'js/views/actionSheetView.js',
-          'js/views/checkboxView.js',
-          'js/views/headerBarView.js',
-          'js/views/listView.js',
-          'js/views/ListViewScroll.js',
-          'js/views/loadingView.js',
-          'js/views/modalView.js',
-          'js/views/navBarView.js',
-          'js/views/popupView.js',
-          'js/views/sideMenuView.js',
-          'js/views/sliderView.js',
-          'js/views/tabBarView.js',
-          'js/views/toggleView.js',
-
-          // Controllers
-          'js/controllers/viewController.js',
-
-          'js/controllers/navController.js',
-          'js/controllers/sideMenuController.js',
-          'js/controllers/tabBarController.js'
-
-        ],
+        src: buildConfig.files,
         dest: 'dist/js/ionic.js'
       },
       distAngular: {
-        src: [
-          'js/_license.js',
-          'js/ext/angular/src/ionicAngular.js',
-          'js/ext/angular/src/service/**/*.js',
-          'js/ext/angular/src/directive/**/*.js'
-        ],
+        src: buildConfig.angularFiles,
         dest: 'dist/js/ionic-angular.js'
       }
     },
+
     jshint: {
       files: ['Gruntfile.js', 'js/**/*.js', 'test/**/*.js'],
       options: {
         jshintrc: '.jshintrc'
       }
     },
+
+    karma: {
+      options: {
+        configFile: 'config/karma.conf.js'
+      },
+      single: {
+        options: {
+          singleRun: true
+        }
+      },
+      sauce: {
+        options: {
+          singleRun: true,
+          configFile: 'config/karma-sauce.conf.js'
+        }
+      },
+      watch: {
+      }
+    },
+
     uglify: {
       dist: {
         files: {
@@ -71,20 +56,23 @@ module.exports = function(grunt) {
         preserveComments: 'some'
       }
     },
+
     sass: {
       dist: {
         files: {
           'dist/css/ionic.css': 'scss/ionic.scss',
         }
       }
     },
+
     cssmin: {
       dist: {
         files: {
           'dist/css/ionic.min.css': 'dist/css/ionic.css',
         }
       }
     },
+
     'string-replace': {
       version: {
         files: {
@@ -103,6 +91,16 @@ module.exports = function(grunt) {
         }
       }
     },
+
+    bump: {
+     options: {
+        files: ['package.json'],
+        commit: false,
+        createTag: false,
+        push: false
+      }
+    },
+
     watch: {
       scripts: {
         files: ['js/**/*.js', 'ext/**/*.js'],
@@ -119,17 +117,45 @@ module.exports = function(grunt) {
         }
       }
     },
+
     pkg: grunt.file.readJSON('package.json')
   });
 
   require('load-grunt-tasks')(grunt);
 
   grunt.registerTask('default', [
+    'enforce',
     'jshint',
     'sass',
     'cssmin',
     'concat',
     'uglify',
     'string-replace'
   ]);
+
+  grunt.registerMultiTask('karma', 'Run karma', function() {
+    var done = this.async();
+    var options = this.options();
+    var config = options.configFile;
+    var browsers = grunt.option('browsers');
+    var singleRun = grunt.option('singleRun') || options.singleRun;
+    var reporters = grunt.option('reporters');
+
+    cp.spawn('node', ['node_modules/karma/bin/karma', 'start', config,
+             browsers ? '--browsers=' + browsers : '',
+             singleRun ? '--single-run=' + singleRun : '',
+             reporters ? '--reporters=' + reporters : ''
+    ], { stdio: 'inherit' })
+    .on('exit', function(code) {
+      if (code) return grunt.fail.warn('Karma test(s) failed. Exit code: ' + code);
+      done();
+    });
+  });
+
+  grunt.registerTask('enforce', 'Install commit message enforce script if it doesn\'t exist', function() {
+    if (!grunt.file.exists('.git/hooks/commit-msg')) {
+      grunt.file.copy('scripts/validate-commit-msg.js', '.git/hooks/commit-msg');
+      require('fs').chmodSync('.git/hooks/commit-msg', '0755');
+    }
+  });
 };

README.md

@@ -83,6 +83,25 @@ way is to use Python:
 + <https://twitter.com/adamdbradley>
 + <https://github.com/adamdbradley>
 
+## Development
+
+* `npm install` to setup
+* `grunt` to jshint & build
+* `grunt karma:single` to test one-time
+* `grunt karma:watch` to test and re-run on source change
+* Additionally, a commit message validator is installed for this repository when running `grunt`.  Read about it [here](https://github.com/ajoslin/conventional-changelog/blob/master/CONVENTIONS.md).
+
+### Pushing Releases
+
+(uses AngularJS's bash utils)
+
+* Run `./scripts/release/finalize-version.sh --action=prepare` to:
+  - Remove version suffix
+  - Write new version to package/bower/component.json
+  - Commit & tag the release
+* Run `./scripts/release/finalize-version.sh --action=publish` to:
+  - Push out new version
+* Once new version is pushed out, run `./scripts/release/initialize-new-version.sh` (usage is shown in file), to bump to next version with bump type / version suffix / version name specified.
 
 ## LICENSE
 

config/build.js

@@ -0,0 +1,42 @@
+module.exports = {
+  files: [
+    'js/_license.js',
+
+    // Base
+    'js/ionic.js',
+
+    // Utils
+    'js/utils/**/*.js',
+
+    // Views
+    'js/views/view.js',
+
+    'js/views/scrollView.js',
+
+    'js/views/actionSheetView.js',
+    'js/views/headerBarView.js',
+    'js/views/listView.js',
+    'js/views/loadingView.js',
+    'js/views/modalView.js',
+    'js/views/navBarView.js',
+    'js/views/popupView.js',
+    'js/views/sideMenuView.js',
+    'js/views/sliderView.js',
+    'js/views/tabBarView.js',
+    'js/views/toggleView.js',
+
+    // Controllers
+    'js/controllers/viewController.js',
+
+    'js/controllers/navController.js',
+    'js/controllers/sideMenuController.js',
+    'js/controllers/tabBarController.js'
+
+  ],
+  angularFiles: [
+    'js/_license.js',
+    'js/ext/angular/src/ionicAngular.js',
+    'js/ext/angular/src/service/**/*.js',
+    'js/ext/angular/src/directive/**/*.js'
+  ]
+};

config/karma-sauce.conf.js

@@ -0,0 +1,63 @@
+
+module.exports = function(config) {
+  require('./karma.conf.js')(config);
+
+  //username: angular-bootstrap
+  //password: password
+  config.set({
+    sauceLabs: {
+      testName: 'ionic',
+      username: 'ionic-test',
+      accessKey: '59373b3d-1ee5-43b9-8df4-31107bd21e57',
+      startConnect: true,
+      tunnelIdentifier: process.env.TRAVIS_JOB_NUMBER
+    },
+    //Saucelabs mobile emulation (esp android emulator)
+    //can be really slow sometimes, we need to give it time to connectk
+    captureTimeout: 60 * 1000,
+    browserDisconnectTimeout: 60 * 1000,
+    browserNoActivityTimeout: 60 * 1000,
+    browserDisconnectTolerance: 2,
+    transports: ['xhr-polling'],
+    browsers: [
+      // 'sauce_ios',
+      'sauce_safari',
+      // 'sauce_android',
+      'sauce_chrome',
+      'sauce_firefox',
+      // 'sauce_ie9',
+      // 'sauce_ie10',
+      // 'sauce_ie11'
+    ],
+    customLaunchers: {
+      'sauce_ios': {
+        base: 'SauceLabs',
+        platform: 'OS X 10.9',
+        browserName: 'iphone',
+        version: '7'
+      },
+      'sauce_safari': {
+        base: 'SauceLabs',
+        browserName: 'safari',
+        platform: 'OS X 10.9',
+        version: '7'
+      },
+      'sauce_android': {
+        base: 'SauceLabs',
+        platform: 'Linux',
+        browserName: 'android',
+        version: '4.0'
+      },
+      'sauce_chrome': {
+        base: 'SauceLabs',
+        browserName: 'chrome'
+      },
+      'sauce_firefox': {
+        base: 'SauceLabs',
+        platform: 'Linux',
+        browserName: 'firefox',
+        version: '26'
+      }
+    },
+  });
+};