angular-rison
v0.0.16
Published
Rison Object Encoding Service for AngularJS
Downloads
104
Maintainers
Readme
Angular Rison Service
Rison URL Object encoding service for Angular. Encode infinite-depth javascript objects into a url-friendly string.
Forked to publish to npm
Ported and extended from the original spec: http://mjtemplate.org/examples/rison.html
Example:
{
"a":0,
"b":"foo",
"c":"23skidoo"
}
Becomes the following, URI safe string:
(a:0,b:foo,c:'23skidoo')
Installing with npm
Very simple
npm install angular-rison
Documentation
The rison service provides two functions, stringifiy and parse. These two functions operate in the same manner as the traditional JSON object methods. Further documentation can be found by building the project and viewing the docs (see below).
Contributing - Steps
- Submit an RFC under issues.
- Fork the repo
- Clone your fork
- Build the environment (see below)
- Make your changes according to your RFC
- Update the tests
- Check test coverage (see below)
- Check complexity (see below)
- Build the result to make sure there aren't any compiler errors (see below).
- Push your changes
- Submit a pull request to your fork, and reference your RFC
Contributing - Building the Environment
Install JRE and set your JAVA_HOME path
Install global dependencies:
$ npm install -g grunt-cli
Install local dependencies:
$ npm install
Launch the development and testing environment:
$ grunt
On changes, the environment automatically performs linting, runs unit tests, creates documentation, creates a code coverage report, and creates a code complexity report for your convenience.
To view documentation materials, navigate to:
`http://127.0.0.1:9001/`
To view testing coverage reports via Istanbul, navigate to:
`http://127.0.0.1:9001/coverage`
To view code complexity reports via Plato, navigate to:
`http://127.0.0.1:9001/plato`
Finally, to ensure package-ability, ensure that you can compile the project without errors:
$ grunt build