Grunt plugin to upload multiple sourcemap files to Raygun.io using Restler.
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-raygun-sourcemaps --save-dev
The "raygun_sourcemaps" task
In your project's Gruntfile, add a section named
raygun_sourcemaps to the data object passed into
This is your App ID from the Raygun.io App. To get this id, either browse to Application Settings > JS Source Center and copy the last part of the path or just browse anywhere within Raygun and check the URL, your App ID will be in there, f.e.
https://app.raygun.io/dashboard/XXXXX. The XXXXX is xyour App ID.
You can create this external Token within your user settings in Raygun, just navigate to https://app.raygun.io/user and check the section
External Access Token. Generate it, pass it as option.
This is the url prefix to your final js directory on your server. Just the part which doesn
t change before any of the uploaded scripts. Like lets say:
This enables a Test Run. No files will be uploaded but the plugin displays all files that need to be uploaded with their parsed urls. You can check if everything will be correct before running the upload.
This callback function sends you the relative path to every
*.map*file it detects, you can modify this path and return a news one for every file. Useful if your local folder structure differs from your server's structure.
In this example, the Plugin will take all files ending with
*.mapwithin the provided directory, cycle them through the
prepareUrlParamsfunction and upload them to Raygun.io.
prepareUrlParamsFunction is nice when your real reachable folder structure is different than your local structure. You can use replace or any other string stuff to change the final path in the url to any uploaded file.
If you are unsure what this function does with your paths, just set
true. With this option no files will be uploaded, they are just gonna be displayed ion your terminal to check all the urls.
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.
keep your ideas coming..
- 0.1.2 - 2015-08-08: Initial Release.
- 0.1.1 - 2015-08-07: Initial Pre-release.