atropa-objects

JavaScript utilities for handling objects.

Installation

The current published version:

npm install git+https://github.com/matthewkastor/atropa-objects.git#master

For some packages I simply publish to the gh-pages branch since it's easier to generate web docs in the repo and push the whole thing. Check the repo if you try installing the master branch and don't get what you expect.

Source code available at: https://github.com/matthewkastor/atropa-objects/

Usage

In node:

var objects = require('atropa-objects').objects;
console.log(objects);

In the browser this module is attached to the global namespace atropa, which will be created if it does not exist. Include ./browser/atropa-objects_web.js in your page and atropa.objects will be available in your page.

For full documentation see docs/jsdoc. For Visual Studio intellisense files see docs/vsdoc.

Tests

Tests can be run from the root of this package with npm test. They require jasmine-node to be installed on the system. If they're not already on your system, navigate to the root of this package and run npm install to get the devDependencies.

To run the browser tests open browser/atropa-objects_tests.html in your favorite web browser.

To edit the tests for both the browser and Node, edit the jasmine test files in browser/tests. For tests specific to Node edit the files in the specs directory.

Hacking

There are several scripts listed in package.json for development and hacking on this module. They can be run with npm run-script followed by the scripts property corresponding to the script you want to run. For example, given a script called buildDocs, it could be run from the package root by:

npm run-script buildDocs

Of course you need to have the devDependencies installed. If they're not already on your system, navigate to the root of this package and run npm install.

If you would like to reconfigure the browser module, edit dev/browserMain.js and then run npm run-script buildBrowserModule from the root of this package.

If you alter the source in src/atropa-objects.js please run the srcFormat, lint, and buildDocs scripts on it before submitting a pull request.

Author

Matthew Kastor

[email protected]

https://plus.google.com/100898583798552211130

License

The license, gpl-3.0, can be found in the License folder or online at http://www.gnu.org/licenses/gpl-3.0-standalone.html