{"_id":"getit","_rev":"336705","name":"getit","description":"Retrieve local and remote files through a simple interface","dist-tags":{"latest":"1.2.0"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"time":{"modified":"2021-06-20T02:20:46.000Z","created":"2012-03-31T09:39:03.414Z","1.2.0":"2019-09-18T09:20:08.729Z","1.1.0":"2017-02-27T05:06:27.830Z","1.0.0":"2014-10-21T05:44:20.031Z","0.4.2":"2014-05-13T06:26:57.878Z","0.4.1":"2014-02-20T23:57:57.792Z","0.4.0":"2013-10-20T08:49:19.043Z","0.3.3":"2013-08-02T01:26:26.742Z","0.3.1":"2013-04-15T05:37:39.605Z","0.3.0":"2013-04-15T05:32:34.118Z","0.2.1":"2012-09-19T23:54:56.561Z","0.2.0":"2012-08-20T07:18:48.216Z","0.1.8":"2012-06-27T03:28:32.870Z","0.1.7":"2012-05-26T09:50:46.276Z","0.1.5":"2012-04-04T11:31:20.882Z","0.1.4":"2012-03-31T09:39:03.414Z"},"users":{"rocket0191":true},"author":{"name":"Damon Oehlman","email":"damon.oehlman@gmail.com"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"versions":{"1.2.0":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@gmail.com"},"version":"1.2.0","main":"index.js","dependencies":{"debug":"^4.1.1","hyperquest":"^2.1.2","mkdirp":"~0.5","urlish":"^1.0.1"},"stability":"stable","devDependencies":{"embellish-readme":"^1.5.2","eslint":"^6.4.0","eslint-config-djo-base":"github:damonoehlman/eslint-config-djo-base","eslint-plugin-import":"^2.18.2","eslint-plugin-mocha":"^6.1.1","mocha":"^6.2.0","rimraf":"^3.0.0"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"gendocs":"embellish README.md","lint":"eslint .","test":"$(npm bin)/mocha --reporter spec -t 20s"},"directories":{"test":"test"},"keywords":["download","fetch","curl","wget","request"],"license":"MIT","gitHead":"a9670a5ff0516030f33ac342e7d88eb1362b0fd1","homepage":"https://github.com/DamonOehlman/getit#readme","_id":"getit@1.2.0","_nodeVersion":"12.4.0","_npmVersion":"6.10.3","dist":{"shasum":"9a2ac57c7e284ebfbf805d11e3e65de62891959f","size":7867,"noattachment":false,"key":"/getit/-/getit-1.2.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-1.2.0.tgz"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"_npmUser":{"name":"damonoehlman","email":"damon.oehlman@gmail.com"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/getit_1.2.0_1568798408583_0.12924113608186993"},"_hasShrinkwrap":false,"publish_time":1568798408729,"_cnpm_publish_time":1568798408729},"1.1.0":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@gmail.com"},"version":"1.1.0","main":"index.js","dependencies":{"debug":"^2.6.1","hyperquest":"^2.1.2","mkdirp":"~0.5","urlish":"^1.0.1"},"stability":"stable","devDependencies":{"mocha":"^3.2.0","rimraf":"^2"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"gendocs":"gendocs > README.md","lint":"jshint *.js && jshint lib/schemes/*.js","test":"$(npm bin)/mocha --reporter spec -t 20s"},"directories":{"test":"test"},"keywords":["download","fetch","curl","wget","request"],"license":"MIT","gitHead":"b606919e3502495fca16837a83e47436c50bf556","homepage":"https://github.com/DamonOehlman/getit#readme","_id":"getit@1.1.0","_shasum":"819f8cb4c49530358a5a1d9ec02273ae1e5993a6","_from":".","_npmVersion":"4.1.2","_nodeVersion":"7.6.0","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@gmail.com"},"dist":{"shasum":"819f8cb4c49530358a5a1d9ec02273ae1e5993a6","size":7493,"noattachment":false,"key":"/getit/-/getit-1.1.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-1.1.0.tgz"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/getit-1.1.0.tgz_1488171987586_0.9098862835671753"},"publish_time":1488171987830,"_cnpm_publish_time":1488171987830,"_hasShrinkwrap":false},"1.0.0":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@gmail.com"},"version":"1.0.0","main":"index.js","dependencies":{"debug":"*","hyperquest":"^1.0.1","mkdirp":"~0.5","urlish":"~0.1"},"stability":"stable","devDependencies":{"mocha":"^1","rimraf":"^2"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"gendocs":"gendocs > README.md","lint":"jshint *.js && jshint lib/schemes/*.js","test":"$(npm bin)/mocha --reporter spec -t 20s"},"directories":{"test":"test"},"keywords":["download","fetch","curl","wget","request"],"license":"MIT","gitHead":"d47b850111e8f8e7390aa8c2ada83e4a571c432d","homepage":"https://github.com/DamonOehlman/getit","_id":"getit@1.0.0","_shasum":"33ebbed31b7a1a354d3a1a214aaafbd42d8695c7","_from":".","_npmVersion":"1.4.28","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@gmail.com"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"dist":{"shasum":"33ebbed31b7a1a354d3a1a214aaafbd42d8695c7","size":7639,"noattachment":false,"key":"/getit/-/getit-1.0.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-1.0.0.tgz"},"publish_time":1413870260031,"_cnpm_publish_time":1413870260031,"_hasShrinkwrap":false},"0.4.2":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@gmail.com"},"version":"0.4.2","main":"index.js","dependencies":{"debug":"*","mkdirp":"~0.5","hyperquest":"~0.3","urlish":"~0.1"},"devDependencies":{"mocha":"^1","rimraf":"^2"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"gendocs":"gendocs > README.md","lint":"jshint *.js && jshint lib/schemes/*.js","test":"$(npm bin)/mocha --reporter spec -t 20s"},"directories":{"test":"test"},"keywords":["download","fetch","curl","wget","request"],"license":"MIT","homepage":"https://github.com/DamonOehlman/getit","_id":"getit@0.4.2","_shasum":"9149c5e55865d767e42712b7c9d0d51b1bf6bca1","_from":".","_npmVersion":"1.4.9","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@gmail.com"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"dist":{"shasum":"9149c5e55865d767e42712b7c9d0d51b1bf6bca1","size":7240,"noattachment":false,"key":"/getit/-/getit-0.4.2.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.4.2.tgz"},"publish_time":1399962417878,"_hasShrinkwrap":false,"_cnpm_publish_time":1399962417878},"0.4.1":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@gmail.com"},"version":"0.4.1","main":"index.js","dependencies":{"debug":"*","mkdirp":"~0.3.5","hyperquest":"~0.2.0","urlish":"~0.1.0"},"devDependencies":{"mocha":"~1.12.0","rimraf":"~2.2.2"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"gendocs":"gendocs > README.md","lint":"jshint *.js && jshint lib/schemes/*.js","test":"$(npm bin)/mocha --reporter spec -t 20s"},"directories":{"test":"test"},"keywords":["download","fetch","curl","wget","request"],"license":"MIT","homepage":"https://github.com/DamonOehlman/getit","_id":"getit@0.4.1","dist":{"shasum":"52d92cdfd5747d67d24e8b6ea8170426267581ef","size":6992,"noattachment":false,"key":"/getit/-/getit-0.4.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.4.1.tgz"},"_from":".","_npmVersion":"1.3.25","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@gmail.com"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"publish_time":1392940677792,"_cnpm_publish_time":1392940677792,"_hasShrinkwrap":false},"0.4.0":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@gmail.com"},"version":"0.4.0","main":"index.js","dependencies":{"debug":"*","mkdirp":"~0.3.5","hyperquest":"~0.1.7","urlish":"~0.1.0"},"devDependencies":{"mocha":"~1.12.0","rimraf":"~2.2.2"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"gendocs":"gendocs > README.md","lint":"jshint *.js && jshint lib/schemes/*.js","test":"$(npm bin)/mocha --reporter spec -t 20s"},"directories":{"test":"test"},"keywords":["download","fetch","curl","wget","request"],"license":"MIT","readmeFilename":"README.md","_id":"getit@0.4.0","dist":{"shasum":"21c0b1830a6a165259b74109884ab47b0e684d4d","size":7069,"noattachment":false,"key":"/getit/-/getit-0.4.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.4.0.tgz"},"_from":".","_npmVersion":"1.3.11","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@gmail.com"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"publish_time":1382258959043,"_cnpm_publish_time":1382258959043,"_hasShrinkwrap":false},"0.3.3":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@gmail.com"},"version":"0.3.3","main":"index.js","dependencies":{"debug":"*","mkdirp":"~0.3.5","hyperquest":"~0.1.7"},"devDependencies":{"mocha":"~1.12.0","rimraf":"~2.2.2"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"gendocs":"codeme > README.md","lint":"jshint *.js && jshint lib/schemes/*.js","test":"$(npm bin)/mocha --reporter spec --timeout 10000"},"directories":{"test":"test"},"keywords":["download","fetch","curl","wget","request"],"license":"MIT","readmeFilename":"README.md","_id":"getit@0.3.3","dist":{"shasum":"03992afe310297f6bfd509322474306386f2b7ae","size":6687,"noattachment":false,"key":"/getit/-/getit-0.3.3.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.3.3.tgz"},"_from":".","_npmVersion":"1.3.5","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@gmail.com"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"publish_time":1375406786742,"_cnpm_publish_time":1375406786742,"_hasShrinkwrap":false},"0.3.1":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@sidelab.com"},"tags":["request","http"],"version":"0.3.1","main":"index.js","engines":{"node":">= 0.4.x < 0.9.0"},"dependencies":{"debug":"*","mkdirp":"*","hyperquest":"0.1.x"},"devDependencies":{"mocha":"1.9.x","rimraf":"2.x.x"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"test":"mocha --reporter spec --timeout 10000"},"contributors":[],"optionalDependencies":{},"_id":"getit@0.3.1","dist":{"shasum":"0b2bf12c95e32b4c64706a39ad1bcf5aa98544dc","size":6208,"noattachment":false,"key":"/getit/-/getit-0.3.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.3.1.tgz"},"_npmVersion":"1.1.62","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@sidelab.com"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"directories":{},"publish_time":1366004259605,"_cnpm_publish_time":1366004259605,"_hasShrinkwrap":false},"0.3.0":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@sidelab.com"},"tags":["request","http"],"version":"0.3.0","main":"index.js","engines":{"node":">= 0.4.x < 0.9.0"},"dependencies":{"debug":"*","mkdirp":"*","hyperquest":"0.1.x"},"devDependencies":{"mocha":"1.9.x","rimraf":"2.x.x"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"test":"mocha --reporter spec --timeout 10000"},"contributors":[],"optionalDependencies":{},"_id":"getit@0.3.0","dist":{"shasum":"401b47028f50488ca2d666a7db471ee1c4122577","size":6169,"noattachment":false,"key":"/getit/-/getit-0.3.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.3.0.tgz"},"_npmVersion":"1.1.62","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@sidelab.com"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"directories":{},"publish_time":1366003954118,"_cnpm_publish_time":1366003954118,"_hasShrinkwrap":false},"0.2.1":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@sidelab.com"},"tags":["request","http"],"version":"0.2.1","main":"index.js","engines":{"node":">= 0.4.x < 0.9.0"},"dependencies":{"debug":"*","mkdirp":"*","request":"2.x.x"},"devDependencies":{"mocha":"1.3.x","rimraf":"2.x.x"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"test":"mocha --reporter spec --timeout 10000"},"contributors":[],"optionalDependencies":{},"_id":"getit@0.2.1","dist":{"shasum":"bcac1c03b80d079f31cd8aa811ac223f19e49323","size":6136,"noattachment":false,"key":"/getit/-/getit-0.2.1.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.2.1.tgz"},"_npmVersion":"1.1.52","_npmUser":{"name":"damonoehlman","email":"damon.oehlman@sidelab.com"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"directories":{},"publish_time":1348098896561,"_cnpm_publish_time":1348098896561,"_hasShrinkwrap":false},"0.2.0":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@sidelab.com"},"tags":["request","http"],"version":"0.2.0","main":"index.js","engines":{"node":">= 0.4.x < 0.9.0"},"dependencies":{"debug":"*","mkdirp":"*","request":"2.x.x"},"devDependencies":{"mocha":"1.3.x","rimraf":"2.x.x"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"test":"mocha --reporter spec --timeout 10000"},"contributors":[],"optionalDependencies":{},"_id":"getit@0.2.0","dist":{"shasum":"fe7ebf756599a5e4b20941876b635fb03d8584a8","size":5594,"noattachment":false,"key":"/getit/-/getit-0.2.0.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.2.0.tgz"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"directories":{},"publish_time":1345447128216,"_cnpm_publish_time":1345447128216,"_hasShrinkwrap":false},"0.1.8":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@sidelab.com"},"tags":["request","http"],"version":"0.1.8","main":"index.js","engines":{"node":">= 0.4.x < 0.9.0"},"dependencies":{"debug":"*","mkdirp":"*","request":"2.x.x"},"devDependencies":{"mocha":"*","chai":"0.3.x","rimraf":"2.x.x"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"test":"mocha --reporter spec --timeout 10000"},"contributors":[],"optionalDependencies":{},"_id":"getit@0.1.8","dist":{"shasum":"415581bd8b9e4fb0f2da0346ac15689f0b83f195","size":6044,"noattachment":false,"key":"/getit/-/getit-0.1.8.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.1.8.tgz"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"directories":{},"publish_time":1340767712870,"_cnpm_publish_time":1340767712870,"_hasShrinkwrap":false},"0.1.7":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@sidelab.com"},"tags":["request","http"],"version":"0.1.7","main":"index.js","engines":{"node":">= 0.4.x < 0.7.0"},"dependencies":{"debug":"*","mkdirp":"*","request":"2.x.x"},"devDependencies":{"mocha":"*","chai":"0.3.x","rimraf":"2.x.x"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"test":"mocha --reporter spec --timeout 10000"},"contributors":[],"optionalDependencies":{},"_npmUser":{"name":"damonoehlman","email":"damon.oehlman@sidelab.com"},"_id":"getit@0.1.7","_engineSupported":true,"_npmVersion":"1.1.19","_nodeVersion":"v0.6.15","_defaultsLoaded":true,"dist":{"shasum":"6959dad894de5b6370880ffcfc6cdfaca775d9c9","size":6036,"noattachment":false,"key":"/getit/-/getit-0.1.7.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.1.7.tgz"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"directories":{},"publish_time":1338025846276,"_cnpm_publish_time":1338025846276,"_hasShrinkwrap":false},"0.1.5":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@sidelab.com"},"tags":["request","http"],"version":"0.1.5","main":"index.js","engines":{"node":">= 0.4.x < 0.7.0"},"dependencies":{"debug":"*","mkdirp":"*","request":"2.x.x"},"devDependencies":{"mocha":"*","chai":"0.3.x","rimraf":"2.x.x"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"test":"mocha --reporter spec --timeout 10000"},"contributors":[],"optionalDependencies":{},"_npmUser":{"name":"damonoehlman","email":"damon.oehlman@sidelab.com"},"_id":"getit@0.1.5","_engineSupported":true,"_npmVersion":"1.1.12","_nodeVersion":"v0.6.14","_defaultsLoaded":true,"dist":{"shasum":"c7af4443ecf1ac95120abafaafed11d5a60f3779","size":5841,"noattachment":false,"key":"/getit/-/getit-0.1.5.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.1.5.tgz"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"directories":{},"publish_time":1333539080882,"_cnpm_publish_time":1333539080882,"_hasShrinkwrap":false},"0.1.4":{"name":"getit","description":"Retrieve local and remote files through a simple interface","author":{"name":"Damon Oehlman","email":"damon.oehlman@sidelab.com"},"tags":["request","http"],"version":"0.1.4","main":"index.js","engines":{"node":">= 0.4.x < 0.7.0"},"dependencies":{"debug":"*","mkdirp":"*","request":"2.x.x"},"devDependencies":{"mocha":"*","chai":"0.3.x","rimraf":"2.x.x"},"repository":{"type":"git","url":"git://github.com/DamonOehlman/getit.git"},"bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"scripts":{"test":"mocha --reporter spec --timeout 10000"},"contributors":[],"_npmUser":{"name":"damonoehlman","email":"damon.oehlman@sidelab.com"},"_id":"getit@0.1.4","optionalDependencies":{},"_engineSupported":true,"_npmVersion":"1.1.12","_nodeVersion":"v0.6.14","_defaultsLoaded":true,"dist":{"shasum":"be8aa1c9019a2def6866b80fb6ab1816fe1f71cc","size":5420,"noattachment":false,"key":"/getit/-/getit-0.1.4.tgz","tarball":"http://registry.cnpm.dingdandao.com/getit/download/getit-0.1.4.tgz"},"maintainers":[{"name":"damonoehlman","email":"damon.oehlman@gmail.com"}],"directories":{},"publish_time":1333186743414,"_cnpm_publish_time":1333186743414,"_hasShrinkwrap":false}},"readme":"# getit\n\nThis is a simple remote file loader that makes it easy to open both local\nand remote files in a simple (and consistent) way.  Behind the scenes getit\nuses [hyperquest](https://github.com/substack/hyperquest) module to to the\nheavy lifting.\n\n[![NPM](https://nodei.co/npm/getit.png)](https://nodei.co/npm/getit/)\n\n[![stable](https://img.shields.io/badge/stability-stable-green.svg)](https://github.com/dominictarr/stability#stable) [![Build Status](https://api.travis-ci.org/DamonOehlman/getit.svg?branch=master)](https://travis-ci.org/DamonOehlman/getit) [![Maintainability](https://api.codeclimate.com/v1/badges/e34775d145b1886389b8/maintainability)](https://codeclimate.com/github/DamonOehlman/getit/maintainability)\n\n## Example Usage\n\nGetting a file:\n\n```js\ngetit('files/test.txt', function(err, data) {\n\n});\n```\n\nGetting some online content:\n\n```js\ngetit('http://www.google.com/', function(err, data) {\n\n});\n```\n\n### Specifying the Current Working Directory\n\nBy default, all files are resolved to the current working directory through\nusing `path.resolve`. The default directory resolved against can be\noverriden, however, by passing options to the `getit` function call:\n\n```js\ngetit('files/test.txt', { cwd: __dirname }, function(err, data) {\n\n});\n```\n\nSpecifying the `cwd` option has no effect on remote requests, but there\nmight be other options added in time to tweak the default\nhyperquest behaviour eventually.  The general principle is you should be\nable to use `getit` to get the content of both local and remote resources\nwithout having to dramatically change the way you use the library.\n\n## GetIt Options\n\nThe `getit` function supports a second argument for providing options to\nchange the default getit behaviour.\n\n### Caching use   `cachePath`\n\nIf you provide an optional `cachePath`, then getit will cache a copy of\nthe data retrieved in the specified path.  In addition to the data\nretrieved, an [etag](http://en.wikipedia.org/wiki/HTTP_ETag) value will\nbe stored in a lookup file.  This will be used in subsequent lookups\nusing the `If-None-Match` header.\n\nBy default, caching will only occur on a server that provides an etag\nvalue, but this can be overridden by also setting the `cacheAny`\noption to true.\n\n```js\nvar opts = {\n  cachePath: '/tmp'\n};\n\ngetit(\n  'github://DamonOehlman/getit/test/files/test.txt',\n  opts,\n  function(err, data) {\n\n  }\n);\n```\n\nFinally, if you would prefer not to wait around for a HTTP request and\na `304` response, then you can provide the `preferLocal` option always\nused the cached copy of a file if it exists in the cache folder.\n\n### Aggressive caching with   `preferLocal`\n\nIf you **really** want to avoid a round-trip to web servers to check the\nfreshness of the cache, then it might be worth using the `preferLocal`\noption also.  This instructs getit to skip the `etag` check if it finds\nthe required file in the cache directory.\n\nIf you do decide to implement this functionality, it's recommended that\nyou provide some option in your application to allow users to clear the\nlocal cache path.\n\n## getit cache helpers\n\n### cache.get(target, opts, callback)\n\n### cache.update(target, opts, resErr, res, body, callback)\n\n## Custom URL Schemes\n\nGetit supports a number of custom url schemes to help you type less\ncharacters:\n\n### Contributing URL Schemes\n\nThe task of the scheme translator is to convert a url of the custom scheme\ninto a standard URI that can be passed to the GET.\n\nTo create your own scheme translator simply fork the library,\ndecide on the scheme / protocol prefix (e.g. github, flickr, etc) and\nthen create the relevant translator in the `lib/schemes` directory.\nWhen `getit` encounters a request for a url matching your custom scheme\ntranslator will be required and involved before actually requesting the url.\n\nSimple.\n\n### Github Gists (gist://)\n\nTo get the default file (first file) from a particular gist:\n\n```js\ngetit('gist://DamonOehlman:6999398', function(err, content) {\n});\n```\n\nTo get a specific file from a particular gist:\n\n```js\ngetit('gist://DamonOehlman:6877717/index.js', function(err, content) {\n});\n```\n\n**NOTE:** Github recently changed the way gist raw urls were formatted\nwhich has meant a change is needed in the getit format.  You must now also\ninclude the username of the owner of the gist when requesting the file\nas shown in the examples above.\n\n### Github Includes (github://)\n\n```js\ngetit('github://DamonOehlman/getit/index.js', function(err, data) {\n});\n```\n\n## Licence\n\nThe MIT License (MIT)\n\nCopyright (c) 2019 Damon Oehlman <damon.oehlman@gmail.com>\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n","_attachments":{},"homepage":"https://github.com/DamonOehlman/getit#readme","bugs":{"url":"http://github.com/DamonOehlman/getit/issues"},"license":"MIT"}