Upload files through POST/PUT HTTP request, using Request, a Node library known to work flawlessly with multipart file uploads. So now you can push a zip
/distthrough your CMS' API!
This plugin requires Grunt
>=0.4.0 (and is ready for Grunt 1.0).
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 grunt-http-upload --save-dev
The "http_upload" task
In your project's Gruntfile, add a section named
http_upload to the data object passed into
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.
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.3.2 - 2016-10-18: Use Request instead of Restler, which throws some deprecation warning on Node >= 6.0.0, and its project page seems dead. Request seems a pretty good alternative anyway.
- 0.2.0 - 2016-03-01: Straight bump to 0.2.0 with updated Restler (3.4.0) dependency and Grunt 1.0 compatibility. Yo.
- 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.