
Research
/Security News
Toptal’s GitHub Organization Hijacked: 10 Malicious Packages Published
Threat actors hijacked Toptal’s GitHub org, publishing npm packages with malicious payloads that steal tokens and attempt to wipe victim systems.
grunt-github-api
Advanced tools
Query Github's API and save the returned JSON files locally.
Project authored and maintained by github/https://github.com/jeffHerb.
This plugin requires Grunt ~0.4.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-github-api --save-dev
Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-github-api');
Run this task with the grunt github
command.
Task targets, files and options may be specified according to the grunt Configuring tasks guide.
Options for this plugin are broken down into sub-option categories as defined below. Please note that all option sections by default are objects and contain simple key-value pairs unless otherwise noted.
Used to idenify where cache and downloaded request data should be stored by default
dest
.Examples:
{
options: {
output: {
path: 'my/api/data/',
cache: 'my/api/cache/'
format: {
indent: 4,
encoding: 'utf8'
}
}
}
}
Connection headers used when connecting the GitHub.
HTTPS
headers.
User-Agent
: node-http/0.10.1
Content-Type
: application/json
Examples:
{
options: {
connection: {
host: 'api.github.com',
headers: {
'User-Agent': 'node-http/0.10.1',
'Content-Type': 'application/json'
}
}
}
}
Type of data the task will be downloading
Indicates the type of request, may be set to either data
or file
. Default is data
.
Control which files do or do not get tracked for changes.
Specifies whether or not to cache API responses. Default is true
.
Concatinate JSON data together before writting it to a file when property is set to
true
. Default isfalse
.
Query search parameters
Additional information about different filters can be found in the Github Developer Documentation.
GitHub access credentials
These credentials are required to preform many actions or continual usage of the plugin. In order to get access using oAuth the repo owner will need to create an access token via their Application Settings page.
src
: is the specified API query path. Source paths are everything that appears after api.github.com
. Additional information about different query paths can be found in the Github Developer Documentation. The src
can be an array
or a string
value.dest
: (optional) - is the path and filename where the retured request should be saved. If nothing is given files will be saved into the same path as the task cache file and will be broken down into a folder structure that mimics its query path. (EXCEPTION: If you define multiple sources that are being concatenated together, you must define at least a filename).Options may be defined at either the task and/or target levels (target-level options override task-level options).
github: {
// Concatentate returned JSON responses into a single file.
combindedIssues: {
options: {
filters: {
state: 'open'
},
task: {
concat: true
}
},
src: [
'/repos/assemble/grunt-github-api-example/issues',
'/repos/assemble/grunt-github-api/issues'
],
dest: 'combinded-issues.json'
// File created will be save along the gruntfile.
},
// Create two different files from two different repos.
seperateIssues: {
options: {
// Access repo using credentials provided
oAuth: {
access_token: 'XXXXXXXXXXXXXXXXXX'
}
},
src: [
'/repos/assemble/grunt-github-api-example/issues',
'/repos/assemble/grunt-github-api/issues'
]
// Files created will be saved inside the api-data folder
},
// Downloads a copy of the example.json file from GitHub.
examplePkg: {
options: {
task: {
type: 'file',
}
},
src: '/repos/assemble/grunt-github-api-example/contents/example.json'
// File created will be saved inside the api-data folder
}
}
Please see the Contributing to Assemble guide for information on contributing to this project.
Copyright (c) 2013 Jeffrey Herb, contributors. Released under the MIT license
This file was generated on Tue Oct 29 2013 21:13:51.
FAQs
Query Github's API and save the returned JSON files locally.
The npm package grunt-github-api receives a total of 2 weekly downloads. As such, grunt-github-api popularity was classified as not popular.
We found that grunt-github-api demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Threat actors hijacked Toptal’s GitHub org, publishing npm packages with malicious payloads that steal tokens and attempt to wipe victim systems.
Research
/Security News
Socket researchers investigate 4 malicious npm and PyPI packages with 56,000+ downloads that install surveillance malware.
Security News
The ongoing npm phishing campaign escalates as attackers hijack the popular 'is' package, embedding malware in multiple versions.