add repository files api

Author: fengmk2

.gitignore

@@ -1,6 +1,5 @@
 lib-cov
 coverage.html
-test/config.js
 *.seed
 *.log
 *.csv
@@ -14,4 +13,4 @@ logs
 results
 
 node_modules
-npm-debug.log
+npm-debug.log

.jshintignore

@@ -0,0 +1,4 @@
+node_modules/
+coverage/
+.tmp/
+.git/

.jshintrc

@@ -0,0 +1,95 @@
+{
+    // JSHint Default Configuration File (as on JSHint website)
+    // See http://jshint.com/docs/ for more details
+
+    "maxerr"        : 50,       // {int} Maximum error before stopping
+
+    // Enforcing
+    "bitwise"       : true,     // true: Prohibit bitwise operators (&, |, ^, etc.)
+    "camelcase"     : false,    // true: Identifiers must be in camelCase
+    "curly"         : true,     // true: Require {} for every new block or scope
+    "eqeqeq"        : true,     // true: Require triple equals (===) for comparison
+    "forin"         : false,    // true: Require filtering for..in loops with obj.hasOwnProperty()
+    "immed"         : false,    // true: Require immediate invocations to be wrapped in parens e.g. `(function () { } ());`
+    "indent"        : false,    // {int} Number of spaces to use for indentation
+    "latedef"       : false,    // true: Require variables/functions to be defined before being used
+    "newcap"        : false,    // true: Require capitalization of all constructor functions e.g. `new F()`
+    "noarg"         : true,     // true: Prohibit use of `arguments.caller` and `arguments.callee`
+    "noempty"       : true,     // true: Prohibit use of empty blocks
+    "nonew"         : false,    // true: Prohibit use of constructors for side-effects (without assignment)
+    "plusplus"      : false,    // true: Prohibit use of `++` & `--`
+    "quotmark"      : false,    // Quotation mark consistency:
+                                //   false    : do nothing (default)
+                                //   true     : ensure whatever is used is consistent
+                                //   "single" : require single quotes
+                                //   "double" : require double quotes
+    "undef"         : true,     // true: Require all non-global variables to be declared (prevents global leaks)
+    "unused"        : false,    // true: Require all defined variables be used
+    "strict"        : true,     // true: Requires all functions run in ES5 Strict Mode
+    "trailing"      : false,    // true: Prohibit trailing whitespaces
+    "maxparams"     : false,    // {int} Max number of formal params allowed per function
+    "maxdepth"      : false,    // {int} Max depth of nested blocks (within functions)
+    "maxstatements" : false,    // {int} Max number statements per function
+    "maxcomplexity" : false,    // {int} Max cyclomatic complexity per function
+    "maxlen"        : false,    // {int} Max number of characters per line
+
+    // Relaxing
+    "asi"           : false,     // true: Tolerate Automatic Semicolon Insertion (no semicolons)
+    "boss"          : true,      // true: Tolerate assignments where comparisons would be expected
+    "debug"         : false,     // true: Allow debugger statements e.g. browser breakpoints.
+    "eqnull"        : false,     // true: Tolerate use of `== null`
+    "es5"           : false,     // true: Allow ES5 syntax (ex: getters and setters)
+    "esnext"        : true,      // true: Allow ES.next (ES6) syntax (ex: `const`)
+    "moz"           : false,     // true: Allow Mozilla specific syntax (extends and overrides esnext features)
+                                 // (ex: `for each`, multiple try/catch, function expression…)
+    "evil"          : false,     // true: Tolerate use of `eval` and `new Function()`
+    "expr"          : true,      // true: Tolerate `ExpressionStatement` as Programs
+    "funcscope"     : false,     // true: Tolerate defining variables inside control statements"
+    "globalstrict"  : false,     // true: Allow global "use strict" (also enables 'strict')
+    "iterator"      : false,     // true: Tolerate using the `__iterator__` property
+    "lastsemic"     : false,     // true: Tolerate omitting a semicolon for the last statement of a 1-line block
+    "laxbreak"      : true,      // true: Tolerate possibly unsafe line breakings
+    "laxcomma"      : false,     // true: Tolerate comma-first style coding
+    "loopfunc"      : false,     // true: Tolerate functions being defined in loops
+    "multistr"      : true,      // true: Tolerate multi-line strings
+    "proto"         : false,     // true: Tolerate using the `__proto__` property
+    "scripturl"     : false,     // true: Tolerate script-targeted URLs
+    "smarttabs"     : false,     // true: Tolerate mixed tabs/spaces when used for alignment
+    "shadow"        : true,      // true: Allows re-define variables later in code e.g. `var x=1; x=2;`
+    "sub"           : false,     // true: Tolerate using `[]` notation when it can still be expressed in dot notation
+    "supernew"      : false,     // true: Tolerate `new function () { ... };` and `new Object;`
+    "validthis"     : true,      // true: Tolerate using this in a non-constructor function
+
+    // Environments
+    "browser"       : true,     // Web Browser (window, document, etc)
+    "couch"         : false,    // CouchDB
+    "devel"         : true,     // Development/debugging (alert, confirm, etc)
+    "dojo"          : false,    // Dojo Toolkit
+    "jquery"        : false,    // jQuery
+    "mootools"      : false,    // MooTools
+    "node"          : true,     // Node.js
+    "nonstandard"   : false,    // Widely adopted globals (escape, unescape, etc)
+    "prototypejs"   : false,    // Prototype and Scriptaculous
+    "rhino"         : false,    // Rhino
+    "worker"        : false,    // Web Workers
+    "wsh"           : false,    // Windows Scripting Host
+    "yui"           : false,    // Yahoo User Interface
+    "noyield"       : true,     // allow generators without a yield
+
+    // Legacy
+    "nomen"         : false,    // true: Prohibit dangling `_` in variables
+    "onevar"        : false,    // true: Allow only one `var` statement per function
+    "passfail"      : false,    // true: Stop on first error
+    "white"         : false,    // true: Check against strict whitespace and indentation rules
+
+    // Custom Globals
+    "globals"       : {         // additional predefined global variables
+      // mocha
+      "describe": true,
+      "it": true,
+      "before": true,
+      "afterEach": true,
+      "beforeEach": true,
+      "after": true
+    }
+}

.npmignore

@@ -4,3 +4,4 @@ lib-cov/
 Makefile
 .travis.yml
 logo.png
+.jshint*

.travis.yml

@@ -1,5 +1,4 @@
 language: node_js
 node_js:
   - '0.10'
-  - '0.11'
 script: make test-coveralls

Makefile

@@ -1,6 +1,6 @@
 TESTS = test/*.test.js
 REPORTER = spec
-TIMEOUT = 10000
+TIMEOUT = 16000
 MOCHA_OPTS =
 
 install:

README.md

@@ -173,21 +173,68 @@ Repository.prototype.getTree = function (params, callback);
 Repository.prototype.getBlob = function (params, callback);
 ```
 
-## Authors
-
-```bash
-$ git summary
-
- project  : gitlab
- repo age : 5 months
- active   : 11 days
- commits  : 22
- files    : 26
- authors  :
-    20  fengmk2                 90.9%
-     2  Ondrej                  9.1%
+### RepositoryFiles
+
+https://gitlab.com/help/api/repository_files
+
+#### client.repositoryFiles.get({id, file_path, ref})
+
+Get file from repository.
+Allows you to receive information about file in repository like name, size, content.
+Note that file content is Base64 encoded.
+
+```json
+{
+  "file_name": "key.rb",
+  "file_path": "app/models/key.rb",
+  "size": 1476,
+  "encoding": "base64",
+  "content": "IyA9PSBTY2hlbWEgSW5mb3...",
+  "ref": "master",
+  "blob_id": "79f7bbd25901e8334750839545a9bd021f0e4c83",
+  "commit_id": "d5a3ff139356ce33e37e73add446f16869741b50"
+}
 ```
 
+Parameters:
+
+* {String} file_path (required) - Full path to new file. Ex. lib/class.rb
+* {String} ref (required) - The name of branch, tag or commit
+
+#### client.repositoryFiles.create({id, file_path, branch_name, encoding, content, commit_message})
+
+Create new file in repository
+
+Parameters:
+
+* {String} file_path (required) - Full path to new file. Ex. lib/class.rb
+* {String} branch_name (required) - The name of branch
+* {String} encoding (optional) - 'text' or 'base64'. Text is default.
+* {String} content (required) - File content
+* {String} commit_message (required) - Commit message
+
+#### client.repositoryFiles.update({id, file_path, branch_name, encoding, content, commit_message})
+
+Update existing file in repository
+
+Parameters:
+
+* {String} file_path (required) - Full path to new file. Ex. lib/class.rb
+* {String} branch_name (required) - The name of branch
+* {String} encoding (optional) - 'text' or 'base64'. Text is default.
+* {String} content (required) - New file content
+* {String} commit_message (required) - Commit message
+
+#### client.repositoryFiles.remove({id, file_path, branch_name, commit_message})
+
+Delete existing file in repository
+
+Parameters:
+
+* {String} file_path (required) - Full path to new file. Ex. lib/class.rb
+* {String} branch_name (required) - The name of branch
+* {String} commit_message (required) - Commit message
+
 ## License
 
 (The MIT License)

lib/gitlab.js

@@ -22,10 +22,11 @@ var Issue = require('./issue');
 var User = require('./user');
 var Repository = require('./repository');
 var MergeRequest = require('./merge_request');
+var RepositoryFile = require('./repository_file');
 
 /**
  * Create a gitlab API client.
- * 
+ *
  * @param {Object} options
  *  - {String} api, api root url, e.g.: 'http://gitlab.com/api/v3'
  *  - {String} privateToken, You can find or reset your private token in your profile.
@@ -43,11 +44,12 @@ function Gitlab(options) {
   this.globalHooks = new GlobalHook(this);
   this.issues = new Issue(this);
   this.users = new User(this);
-  this.merge_requests = new MergeRequest(this);
+  this.merge_requests = this.mergeRequests = new MergeRequest(this);
 
   this.addResources({
     projects: Project,
     repository: Repository,
+    repositoryFiles: RepositoryFile,
   });
 }
 

lib/repository_file.js

@@ -0,0 +1,25 @@
+/**!
+ * gitlab - lib/repository_file.js
+ *
+ * Copyright(c) fengmk2 and other contributors.
+ * MIT Licensed
+ *
+ * Authors:
+ *   fengmk2 <[email protected]> (http://fengmk2.github.com)
+ */
+
+'use strict';
+
+/**
+ * Module dependencies.
+ */
+
+var util = require('util');
+var restful = require('restful-client');
+
+module.exports = RepositoryFile;
+
+function RepositoryFile(client) {
+  this.constructor.super_.call(this, client, '/projects/:id/repository/files');
+}
+util.inherits(RepositoryFile, restful.RESTFulResource);

package.json

@@ -10,7 +10,7 @@
   },
   "dependencies": {
     "debug": "~0.8.1",
-    "restful-client": "~0.0.4"
+    "restful-client": "~0.1.0"
   },
   "devDependencies": {
     "autod": "*",
@@ -20,7 +20,7 @@
     "mocha": "*",
     "mocha-lcov-reporter": "*",
     "pedding": "~0.0.3",
-    "should": "~3.3.1",
+    "should": "~3.3.2",
     "travis-cov": "*"
   },
   "homepage": "https://github.com/repo-utils/gitlab",