Grunt plugin to upload files through POST/PUT HTTP request
Upload files through POST/PUT HTTP request, using Restler, the only Node library known to work flawlessly with multipart file uploads. So now you can push a zip
/distthrough your CMS' API!
If you wonder how to install or use this plugin, or even Grunt itself, you should check out our "Discover Grunt" book.
It starts at the very beginning (including how to properly set-up your command-line on Windows and Mac OS X), and goes beyond the official Getting Started guide.
This plugin requires Grunt
If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:
npm install grunt-http-upload --save-dev
In your project's Gruntfile, add a section named
http_upload to the data object passed into
gruntinitConfighttp_upload:your_target:options:url: '<%= config.apiKey %>'method: 'PUT'rejectUnauthorized: falseheaders:'Authorization': 'Token <%= your_token_here %>'data:someKey: 'some value'console.log'Response: ' + data;src: '<%= yeoman.dist %>/dist.zip'dest: 'myField'
This is the full URL to which you can upload a file. You can append some variables, like an API token.
The HTTP method to use to upload the file. Look in the API documentation you want to use, this is usually POST or PUT.
Verify the server certificate and will fail if it is not valid. Set to false if you need to bypass the SSL verification.
Any form data fields to be sent in addition to the file upload
Headers to send along with your HTTP request. For example, a lot of API require the Authentication to be sent through the Headers.
Callback used to process server's response. For example, when server returns id of uploaded file you need to process afterwards.
The local path of the file you wish to upload, using the current working directory as a reference. You can upload only 1 file at a time.
The field name of the file to be uploaded, on the API side.
In this example, the default POST method is used to upload the local picture
./images/status.jpg to Basecamp. Their API can be accessed through the URL
https://basecamp.com (using Basic Auth). When creating an attachment in Basecamp, the "dest" field name is not important, so you can set it to anything (
img in this case).
method is set to "POST", but could have been omitted as this is the default value.
onComplete method is then used to display API's response.
gruntinitConfighttp_upload:basecamp:options:url: ''method: 'POST'console.log'Response: ' + data;src: 'images/status.jpg'dest: 'img'
In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.
You should fork this repo, and issue a Pull Request with your proposed changes.
For now the upload is limited to 1 file per target. This could change if I find a scenario needing it.
- 0.1.8 - 2015-01-12: Happy New Year! Now gives more information on unknown error (like when there's no connectivity), rather than
null(PR from Marcus).
- 0.1.7 - 2014-12-30: Add onComplete as an optional callback function used to process server's response (PR from Remigiusz Jackowski).
- 0.1.6 - 2014-10-13: Add rejectUnauthorized option to bypass SSL certificate verification (PR from GODDET).
- 0.1.4/0.1.5 - 2014-05-25: Upload success on all 2XX codes (PR from Shane Smith) + Fix.
- 0.1.3 - 2014-05-14: Added a headers option to send HTTP headers (PR from Andrey Okonetchnikov).
- 0.1.2 - 2014-04-03: Updated Restler to latest (3.2.0) version.
- 0.1.1 - 2014-04-03: Added a data option to pass other form data in addition to the uploaded file (PR from Micah Condon).
- 0.1.0 - 2013-10-30: Initial release. Supports only 1 multipart file upload.