initial import

Author: andris9

.gitignore

@@ -0,0 +1,2 @@
+node_modules
+.DS_Store

.jshintrc

@@ -0,0 +1,17 @@
+{
+    "indent": 4,
+    "node": true,
+    "globalstrict": true,
+    "evil": true,
+    "unused": true,
+    "undef": true,
+    "newcap": true,
+    "esnext": true,
+    "curly": true,
+    "eqeqeq": true,
+
+    "predef": [
+        "describe",
+        "it"
+    ]
+}

.npmignore

@@ -0,0 +1,4 @@
+.travis.yml
+.jshintrc
+Gruntfile.js
+test

.travis.yml

@@ -0,0 +1,9 @@
+language: node_js
+node_js:
+  - "0.10"
+  - "0.11"
+before_install:
+  - npm install -g grunt-cli
+notifications:
+  email:
+    - [email protected]

Gruntfile.js

@@ -0,0 +1,29 @@
+module.exports = function(grunt) {
+    'use strict';
+
+    // Project configuration.
+    grunt.initConfig({
+        jshint: {
+            all: ['*.js', 'src/*.js', 'test/*.js'],
+            options: {
+                jshintrc: '.jshintrc'
+            }
+        },
+
+        mochaTest: {
+            all: {
+                options: {
+                    reporter: 'spec'
+                },
+                src: ['test/*-unit.js']
+            }
+        }
+    });
+
+    // Load the plugin(s)
+    grunt.loadNpmTasks('grunt-contrib-jshint');
+    grunt.loadNpmTasks('grunt-mocha-test');
+
+    // Tasks
+    grunt.registerTask('default', ['jshint', 'mochaTest']);
+};

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2014 Andris Reinman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,108 @@
+# libbase64
+
+Encode and decode base64 strings.
+
+## Usage
+
+Install with npm
+
+    npm install libbase64
+
+Require in your script
+
+```javascript
+var libbase64 = require('libbase64');
+```
+
+### Encode values
+
+Encode Buffer objects or unicode strings with
+
+    libbase64.encode(val) → String
+
+Where
+
+  * **val** is a Buffer or an unicode string
+
+**Example**
+
+```javascript
+libbase64.encode('jõgeva');
+// asO1Z2V2YQ==
+```
+
+### Wrap encoded values
+
+To enforce soft line breaks on lines longer than selected amount of characters, use `wrap`
+
+    libbase64.wrap(str[, lineLength]) → String
+
+Where
+
+  * **str** is a base64 encoded string
+  * **lineLength** (defaults to 76) is the maximum allowed line length
+
+**Example**
+
+```javascript
+libbase64.wrap('asO1Z2V2asO1Z2V2asO1Z2V2YQ==', 10)
+// asO1Z2V2as\r\n
+// O1Z2V2asO1\r\n
+// Z2V2YQ==
+```
+
+### Transform Streams
+
+`libbase64` makes it possible to encode and decode streams with `libbase64.Encoder` and `libbase64.Decoder` constructors.
+
+### Encoder Stream
+
+Create new Encoder Stream with
+
+    var encoder = new libbase64.Encoder([options])
+
+Where
+
+  * **options** is the optional stream options object with an additional option `lineLength` if you want to use any other line length than the default 76 characters (or set to `false` to turn the soft wrapping off completely)
+
+**Example**
+
+The following example script reads in a file, encodes it to base64 and saves the output to a file.
+
+```javascript
+var libbase64 = require('libbase64');
+var fs = require('fs');
+var source = fs.createReadStream('source.txt');
+var encoded = fs.createReadStream('encoded.txt');
+var encoder = new libbase64.Encoder();
+
+source.pipe(encoder).pipe(encoded);
+```
+
+### Decoder Stream
+
+Create new Decoder Stream with
+
+    var decoder = new libbase64.Decoder([options])
+
+Where
+
+  * **options** is the optional stream options object
+
+**Example**
+
+The following example script reads in a file in base64 encoding, decodes it and saves the output to a file.
+
+```javascript
+var libbase64 = require('libbase64');
+var fs = require('fs');
+var encoded = fs.createReadStream('encoded.txt');
+var dest = fs.createReadStream('dest.txt');
+var decoder = new libbase64.Decoder();
+
+encoded.pipe(decoder).pipe(dest);
+```
+
+## License
+
+**MIT**