Added example for basic-auth

basicAuth/app.js

@@ -0,0 +1,31 @@
+var auth = require('koa-basic-auth');
+var koa = require('koa');
+var app = koa();
+
+// custom 401 handling
+
+app.use(function *(next){
+  try {
+    yield next;
+  } catch (err) {
+    if (401 == err.status) {
+      this.status = 401;
+      this.body = 'cant haz that';
+    } else {
+      throw err;
+    }
+  }
+});
+
+// require auth
+
+app.use(auth({ name: 'tj', pass: 'tobi' }));
+
+// secret response
+
+app.use(function *(){
+  this.body = 'secret';
+});
+
+app.listen(3000);
+console.log('listening on port 3000');

basicAuth/test.js

@@ -0,0 +1,52 @@
+var basicAuth = require('koa-basic-auth');
+var request = require('supertest');
+var koa = require('koa');
+var assert = require('assert');
+
+describe('Koa Basic Auth', function(){
+
+  describe('with no credentials', function(){
+    it('should `throw` 401', function(done){
+      var app = koa();
+
+      app.use(basicAuth({ name: 'user', pass: 'pass' }));
+
+      request(app.listen())
+        .get('/')
+        .expect(401)
+        .end(done);
+    })
+  })
+
+  describe('with invalid credentials', function(){
+    it('should `throw` 401', function(done){
+      var app = koa();
+
+      app.use(basicAuth({ name: 'user', pass: 'pass' }));
+
+      request(app.listen())
+        .get('/')
+        .auth('foo', 'bar')
+        .expect(401)
+        .end(done);
+    })
+  })
+
+  describe('with valid credentials', function(){
+    it('should call the next middleware', function(done){
+      var app = koa();
+
+      app.use(basicAuth({ name: 'user', pass: 'pass' }));
+      app.use(function *(){
+        this.body = 'Protected';
+      })
+
+      request(app.listen())
+        .get('/')
+        .auth('user', 'pass')
+        .expect(200)
+        .expect('Protected')
+        .end(done);
+    })
+  })
+})

errors/app.js

@@ -33,6 +33,7 @@ app.use(function *(){
 app.on('error', function(err){
   if (process.env.NODE_ENV != 'test') {
     console.log('sent error %s to the cloud', err.message);
+    console.log(err);
   }
 });
 

package.json

@@ -21,7 +21,8 @@
     "raw-body": "^1.1.1",
     "save-to": "^1.0.0",
     "streaming-json-stringify": "^1.0.0",
-    "swig": "^1.2.2"
+    "swig": "^1.2.2",
+    "koa-basic-auth": "^1.1.1"
   },
   "devDependencies": {
     "co": "*",