BTCPrivate
/
bitcore
mirror of https://github.com/BTCPrivate/bitcore.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Merge pull request #135 from maraoz/feature/configurable-bundle 

Customizable browser bundle
This commit is contained in:
Ryan X. Charles 2014-03-11 18:19:23 -04:00
parent 55d236741d 8312f90458
commit 089a47591a
6 changed files with 79 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Gruntfile.js
View File

@ -16,7 +16,7 @@ module.exports = function(grunt) {
stdout: true, stdout: true,
stderr: true stderr: true
}, },
command: 'node ./browser/browserify.js', command: 'node ./browser/browserify.js -a',
} }
}, },
watch: { watch: {
@ -25,7 +25,7 @@ module.exports = function(grunt) {
tasks: ['markdown'] tasks: ['markdown']
}, },
scripts: { scripts: {
files: ['**/*.js', '**/*.html', '!**/node_modules/**', '!browser/bundle.js', '!browser/testdata.js'], files: ['**/*.js', '**/*.html', '!**/node_modules/**', '!browser/bundle.js', '!browser/testdata.js', '!browser/vendor-bundle.js'],
tasks: ['shell'], tasks: ['shell'],
}, },
}, },

44
README.md
View File

@ -257,13 +257,49 @@ Bitcore is still under heavy development and not quite ready for "drop-in" produ
Bitcore needs some developer love. Please send pull requests for bug fixes, code optimization, and ideas for improvement. Bitcore needs some developer love. Please send pull requests for bug fixes, code optimization, and ideas for improvement.
#Browser support #Browser support
Work to enable Bitcore for use in the browser is ongoing. To build bitcore for the browser: ## Building the browser bundle
To build bitcore full bundle for the browser:
(this is automatically executed after you run `npm install`)
``` ```
npm install -g grunt-cli node browser/browserify.js -a
grunt shell ```
This will generate a `browser/bundle.js` file which you can include
in your HTML to use bitcore in the browser.
##
##Example browser usage
From example/simple.html
```
<!DOCTYPE html>
<html>
<body>
<script src="../browser/bundle.js"></script>
<script>
var bitcore = require('bitcore');
var Address = bitcore.Address;
var a = new Address('1KerhGhLn3SYBEQwby7VyVMWf16fXQUj5d');
console.log('1KerhGhLn3SYBEQwby7VyVMWf16fXQUj5d is valid? '+a.isValid());
</script>
</body>
</html>
``` ```
You can check a usage example at examples/example.html You can check a more complex usage example at examples/example.html
## Generating a customized browser bundle
To generate a customized bitcore bundle, you can specify
which submodules you want to include in it with the -s option:
```
node browser/browserify.js -s Transaction,Address
```
This will generate a `browser/bundle.js` containing only the Transaction
and Address class, with all their dependencies.
Use this option if you are not using the whole bitcore library, to optimize
the bundle size, script loading time, and general resource usage.
#License #License

21
browser/browserify.js
View File

@ -10,6 +10,7 @@
var fs = require('fs'); var fs = require('fs');
var browserify = require('browserify'); var browserify = require('browserify');
var browserPack = require('browser-pack'); var browserPack = require('browser-pack');
var program = require('commander');
// concat browser vendor files // concat browser vendor files
var exec = require('child_process').exec; var exec = require('child_process').exec;
@ -22,6 +23,20 @@ var puts = function(error, stdout, stderr) {
exec('cd browser; sh concat.sh', puts); exec('cd browser; sh concat.sh', puts);
var list = function(val) {
return val.split(',');
};
program
.version('0.0.1')
.option('-a, --includeall', 'Include all submodules.')
.option('-s, --submodules <items>', 'Include the listed comma-separated submodules.', list)
.parse(process.argv);
if (!program.includeall && (!program.submodules || program.submodules.length === 0)) {
console.log('Must use either -s or -a option. For more info use the --help option');
process.exit(1);
}
var pack = function (params) { var pack = function (params) {
var preludePath = 'node_modules/soop/example/custom_prelude.js'; var preludePath = 'node_modules/soop/example/custom_prelude.js';
@ -75,9 +90,11 @@ b.require('./util/log');
b.require('./util/util'); b.require('./util/util');
b.require('./util/EncodedData'); b.require('./util/EncodedData');
b.require('./util/VersionedData'); b.require('./util/VersionedData');
b.add('./browser/bignum_config.js');
modules.forEach(function(m) { modules.forEach(function(m) {
b.require('./' + m + '.js' ,{expose: './'+m} ); if (program.includeall || program.submodules.indexOf(m) > -1) {
console.log('Including '+m+' in the browser bundle');
b.require('./' + m + '.js' , {expose: './'+m} );
}
}); });
b.require('soop'); b.require('soop');

12
examples/simple.html Normal file
View File

@ -0,0 +1,12 @@
<!DOCTYPE html>
<html>
<body>
<script src="../browser/bundle.js"></script>
<script>
var bitcore = require('bitcore');
var Address = bitcore.Address;
var a = new Address('1KerhGhLn3SYBEQwby7VyVMWf16fXQUj5d');
console.log('1KerhGhLn3SYBEQwby7VyVMWf16fXQUj5d is valid? '+a.isValid());
</script>
</body>
</html>

6
package.json
View File

@ -41,7 +41,8 @@
"url": "https://github.com/bitpay/bitcore.git" "url": "https://github.com/bitpay/bitcore.git"
}, },
"scripts": { "scripts": {
"test": "mocha test -R spec" "test": "mocha test -R spec",
"postinstall": "node ./browser/browserify.js -a"
}, },
"dependencies": { "dependencies": {
"soop": "git://github.com/bitpay/soop.git", "soop": "git://github.com/bitpay/soop.git",
@ -66,7 +67,8 @@
"browserify-buffertools": "~1.0.2", "browserify-buffertools": "~1.0.2",
"chai": "~1.9.0", "chai": "~1.9.0",
"brfs": "~1.0.0", "brfs": "~1.0.0",
"async": "~0.2.10" "async": "~0.2.10",
"commander": "~2.1.0"
}, },
"license": "MIT" "license": "MIT"
} }

2
test/index.html
View File

@ -38,6 +38,8 @@
<script src="test.VersionedData.js"></script> <script src="test.VersionedData.js"></script>
<script src="test.Wallet.js"></script> <script src="test.Wallet.js"></script>
<script src="test.WalletKey.js"></script> <script src="test.WalletKey.js"></script>
<!--
-->
<script> <script>
mocha.run(); mocha.run();
</script> </script>