Skip to content

Commit 68856d7

Browse files
committed
Stable Version 3.0.0-alpha.1
1 parent 3c6861a commit 68856d7

20 files changed

+2411
-1313
lines changed

.babelrc

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
"presets": ["es2015"]
3+
}

.bowerrc

Lines changed: 0 additions & 3 deletions
This file was deleted.

.gitignore

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,4 +9,5 @@ coverage/
99

1010
npm-debug.log
1111
junit/
12-
dist/karma.start.js
12+
dist/karma.start.js
13+
doc/

.npmignore

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -20,17 +20,15 @@ bower_components/
2020

2121
*.iml
2222
.idea/
23-
23+
bs.jpg
2424
*.png
2525
CONTRIBUTING.md
2626
favicon.ico
2727
circle.yml
2828
bower.json
29-
.bowerrc
30-
Gruntfile.js
3129
*.start.js
3230
karma.conf.js
3331
test/
34-
lib/
3532
src/
36-
junit/
33+
junit/
34+
doc/

CONTRIBUTING.md

Lines changed: 32 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,46 @@
11
# Contributing Guide
22

3-
First, support is handled via the [Slack Channel](http://slack.js-data.io) and the [Mailing List](https://groups.io/org/groupsio/jsdata). Ask your questions there.
3+
## Support
44

5-
When submitting issues on GitHub, please include as much detail as possible to make debugging quick and easy.
5+
Support questions are handled via [StackOverflow][so], [Slack][slack], and the
6+
[Mailing List][ml]. Ask your questions there.
67

7-
- good - Your versions of js-data, js-data-localstorage, etc., relevant console logs/error, code examples that revealed the issue
8-
- better - A [plnkr](http://plnkr.co/), [fiddle](http://jsfiddle.net/), or [bin](http://jsbin.com/?html,output) that demonstrates the issue
9-
- best - A Pull Request that fixes the issue, including test coverage for the issue and the fix
8+
## Community
9+
- [StackOverflow Channel][so]
10+
- [Slack Chat][slack] [![Slack Status][sl_b]][slack]
11+
- [Announcements](http://www.js-data.io/blog)
12+
- [Mailing List](ml)
13+
- [Issues Tracker](https://github.com/js-data/js-data/issues)
14+
- [GitHub](https://github.com/js-data/js-data)
15+
- [Contributing Guide](https://github.com/js-data/js-data/blob/master/CONTRIBUTING.md)
1016

11-
[Github Issues](https://github.com/js-data/js-data-localstorage/issues).
17+
## Contributing
1218

13-
#### Submitting Pull Requests
19+
When submitting bug reports or feature requests on GitHub, please include _as
20+
much detail as possible_.
1421

15-
1. Contribute to the issue/discussion that is the reason you'll be developing in the first place
16-
1. Fork js-data-localstorage
22+
- good - Your versions of Angular, JSData, etc, relevant console logs, stack
23+
traces, code examples that revealed the issue, etc.
24+
- better - A [plnkr](http://plnkr.co/), [fiddle](http://jsfiddle.net/), or
25+
[bin](http://jsbin.com/?html,output) that demonstrates the issue
26+
- best - A Pull Request that fixes the issue, including test coverage for the
27+
issue and the fix
28+
29+
### Pull Requests
30+
31+
1. Contribute to the issue/discussion that is the reason you'll be developing in
32+
the first place
33+
1. Fork js-data
1734
1. `git clone [email protected]:<you>/js-data-localstorage.git`
1835
1. `cd js-data-localstorage; npm install;`
1936
1. Write your code, including relevant documentation and tests
2037
1. Run `npm test` (build and test)
2138
1. Your code will be linted and checked for formatting, the tests will be run
22-
1. The `dist/` folder & files will be generated, do NOT commit `dist/*`! They will be committed when a release is cut.
39+
1. The `dist/` folder & files will be generated, do NOT commit `dist/*`! They
40+
will be committed when a release is cut.
2341
1. Submit your PR and we'll review!
2442
1. Thanks!
43+
44+
[slack]: http://slack.js-data.io
45+
[ml]: https://groups.io/org/groupsio/jsdata
46+
[so]: http://stackoverflow.com/questions/tagged/jsdata

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
The MIT License (MIT)
22

3-
Copyright (c) 2014-2015 Jason Dobry
3+
Copyright (c) 2014-2016 Jason Dobry
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 65 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,30 +1,43 @@
1-
<img src="https://raw.githubusercontent.com/js-data/js-data/master/js-data.png" alt="js-data logo" title="js-data" align="right" width="64" height="64" />
1+
<img src="https://raw.githubusercontent.com/js-data/js-data/master/js-data.png" alt="js-data logo" title="js-data" align="right" width="96" height="96" />
22

3-
## js-data-localstorage [![Slack Status][sl_b]][sl_l] [![npm version][npm_b]][npm_l] [![Circle CI][circle_b]][circle_l] [![npm downloads][dn_b]][dn_l] [![Coverage Status][cov_b]][cov_l] [![Codacy][cod_b]][cod_l]
3+
# js-data-localstorage
4+
5+
[![Slack Status][sl_b]][sl_l]
6+
[![npm version][npm_b]][npm_l]
7+
[![Circle CI][circle_b]][circle_l]
8+
[![npm downloads][dn_b]][dn_l]
9+
[![Coverage Status][cov_b]][cov_l]
10+
[![Codacy][cod_b]][cod_l]
411

512
localStorage adapter for [js-data](http://www.js-data.io/).
613

714
Tested on IE9, Chrome 46, Firefox 41 & Safari 7.1 using
815
<img src="https://raw.githubusercontent.com/js-data/js-data-localstorage/master/bs.jpg" alt="bs logo" title="browserstack" width="150" height="35" style="vertical-align: middle" />
916

10-
### API Documentation
11-
[DSLocalStorageAdapter](http://www.js-data.io/docs/dslocalstorageadapter)
17+
## Table of contents
1218

13-
### Demo
14-
[https://js-data-localstorage.firebaseapp.com/](https://js-data-localstorage.firebaseapp.com/)
19+
* [Quick start](#quick-start)
20+
* [Documentation](#documentation)
21+
* [API Reference](#api-reference)
22+
* [Demo](#demo)
23+
* [Support](#support)
24+
* [Community](#community)
25+
* [Contributing](#contributing)
26+
* [License](#license)
27+
28+
## Quick Start
1529

16-
### Quick Start
1730
`npm install --save js-data js-data-localstorage` or `bower install --save js-data js-data-localstorage`.
1831

1932
Load `js-data-localstorage.js` after `js-data.js`.
2033

2134
```js
22-
var adapter = new DSLocalStorageAdapter();
35+
var adapter = new LocalStorageAdapter();
2336

24-
var store = new JSData.DS();
37+
var store = new JSData.DataStore();
2538
store.registerAdapter('localstorage', adapter, { default: true });
2639

27-
// "store" will now use the localstorage adapter for all async operations
40+
// "store" will now use the localstorage adapter
2841
```
2942

3043
You can also provide a custom storage medium (it just needs to implement the `localStorage` API):
@@ -33,7 +46,7 @@ You can also provide a custom storage medium (it just needs to implement the `lo
3346
var memory = {};
3447

3548
// Turn js-data-localstorage into an in-memory adapter
36-
var memoryAdapter = new DSLocalStorageAdapter({
49+
var memoryAdapter = new LocalStorageAdapter({
3750
storage: {
3851
getItem: function (key) {
3952
return memory[key];
@@ -48,52 +61,69 @@ var memoryAdapter = new DSLocalStorageAdapter({
4861
});
4962

5063
// Turn js-data-localstorage into a sessionStorage adapter
51-
var sessionAdapter = new DSLocalStorageAdapter({
64+
var sessionAdapter = new LocalStorageAdapter({
5265
storage: sessionStorage
5366
});
5467
```
5568

56-
### Changelog
57-
[CHANGELOG.md](https://github.com/js-data/js-data-localstorage/blob/master/CHANGELOG.md)
69+
## Documentation
70+
- [Getting Started with js-data](http://www.js-data.io/docs/home)
71+
- [js-data-http](http://www.js-data.io/docs/js-data-localstorage)
72+
- [CHANGELOG.md](https://github.com/js-data/js-data-localstorage/blob/master/CHANGELOG.md)
5873

59-
### Community
60-
- [Slack Channel][sl_l] - Better than IRC!
61-
- [Announcements](http://www.js-data.io/blog)
62-
- [Mailing List](https://groups.io/org/groupsio/jsdata) - Ask your questions!
63-
- [Issues](https://github.com/js-data/js-data-localstorage/issues) - Found a bug? Feature request? Submit an issue!
64-
- [GitHub](https://github.com/js-data/js-data-localstorage) - View the source code for js-data.
65-
- [Contributing Guide](https://github.com/js-data/js-data-localstorage/blob/master/CONTRIBUTING.md)
74+
## API Reference
75+
- [js-data](http://api.js-data.io/js-data/)
76+
- [js-data-localstorage](http://api.js-data.io/js-data-localstorage/)
6677

67-
### Contributing
78+
## Demo
79+
[https://js-data-localstorage.firebaseapp.com/](https://js-data-localstorage.firebaseapp.com/)
80+
81+
## Support
6882

69-
First, support is handled via the [Slack Channel][sl_l] and the [Mailing List](https://groups.io/org/groupsio/jsdata). Ask your questions there.
83+
Support questions are handled via [StackOverflow][so], [Slack][slack], and the
84+
[Mailing List][ml]. Ask your questions there.
85+
86+
## Community
87+
- [StackOverflow Channel][so]
88+
- [Slack Chat][slack] [![Slack Status][sl_b]][slack]
89+
- [Announcements](http://www.js-data.io/blog)
90+
- [Mailing List](ml)
91+
- [Issues Tracker](https://github.com/js-data/js-data/issues)
92+
- [GitHub](https://github.com/js-data/js-data)
93+
- [Contributing Guide](https://github.com/js-data/js-data/blob/master/CONTRIBUTING.md)
7094

71-
When submitting issues on GitHub, please include as much detail as possible to make debugging quick and easy.
95+
## Contributing
7296

73-
- good - Your versions of js-data, js-data-localstorage, etc., relevant console logs/error, code examples that revealed the issue
74-
- better - A [plnkr](http://plnkr.co/), [fiddle](http://jsfiddle.net/), or [bin](http://jsbin.com/?html,output) that demonstrates the issue
75-
- best - A Pull Request that fixes the issue, including test coverage for the issue and the fix
97+
When submitting bug reports or feature requests on GitHub, please include _as
98+
much detail as possible_.
7699

77-
[Github Issues](https://github.com/js-data/js-data-localstorage/issues).
100+
- good - Your versions of Angular, JSData, etc, relevant console logs, stack
101+
traces, code examples that revealed the issue, etc.
102+
- better - A [plnkr](http://plnkr.co/), [fiddle](http://jsfiddle.net/), or
103+
[bin](http://jsbin.com/?html,output) that demonstrates the issue
104+
- best - A Pull Request that fixes the issue, including test coverage for the
105+
issue and the fix
78106

79-
#### Submitting Pull Requests
107+
### Pull Requests
80108

81-
1. Contribute to the issue/discussion that is the reason you'll be developing in the first place
82-
1. Fork js-data-localstorage
109+
1. Contribute to the issue/discussion that is the reason you'll be developing in
110+
the first place
111+
1. Fork js-data
83112
1. `git clone [email protected]:<you>/js-data-localstorage.git`
84113
1. `cd js-data-localstorage; npm install;`
85114
1. Write your code, including relevant documentation and tests
86115
1. Run `npm test` (build and test)
87116
1. Your code will be linted and checked for formatting, the tests will be run
88-
1. The `dist/` folder & files will be generated, do NOT commit `dist/*`! They will be committed when a release is cut.
117+
1. The `dist/` folder & files will be generated, do NOT commit `dist/*`! They
118+
will be committed when a release is cut.
89119
1. Submit your PR and we'll review!
90120
1. Thanks!
91121

92-
### License
122+
## License
93123

94124
The MIT License (MIT)
95125

96-
Copyright (c) 2014-2015 Jason Dobry
126+
Copyright (c) 2014-2016 Jason Dobry
97127

98128
Permission is hereby granted, free of charge, to any person obtaining a copy
99129
of this software and associated documentation files (the "Software"), to deal
@@ -125,3 +155,4 @@ SOFTWARE.
125155
[cov_l]: https://coveralls.io/github/js-data/js-data-localstorage?branch=master
126156
[cod_b]: https://img.shields.io/codacy/b8e46008e6ad45159b7a6927dbfd66c3.svg
127157
[cod_l]: https://www.codacy.com/app/jasondobry/js-data-localstorage/dashboard
158+
[so]: http://stackoverflow.com/questions/tagged/jsdata

bower.json

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
22
"name": "js-data-localstorage",
33
"description": "localStorage adapter for js-data.",
4-
"homepage": "http://www.js-data.io/docs/dslocalstorageadapter",
4+
"homepage": "http://www.js-data.io/docs/js-data-localstorage",
55
"repository": {
66
"type": "git",
77
"url": "https://github.com/js-data/js-data-localstorage.git"
@@ -17,18 +17,16 @@
1717
".*",
1818
"*.iml",
1919
"src/",
20-
"lib/",
2120
"doc/",
22-
"guide/",
21+
"junit/",
2322
"coverage/",
24-
"Gruntfile.js",
2523
"node_modules/",
2624
"test/",
2725
"package.json",
2826
"karma.conf.js",
2927
"karma.start.js"
3028
],
3129
"dependencies": {
32-
"js-data": "~2.x"
30+
"js-data": "~3.x"
3331
}
3432
}

conf.json

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
{
2+
"source": {
3+
"includePattern": ".*js$"
4+
},
5+
"plugins": ["plugins/markdown"],
6+
"opts": {
7+
"template": "./node_modules/ink-docstrap/template",
8+
"destination": "./doc/",
9+
"recurse": true,
10+
"verbose": true,
11+
"readme": "./README.md",
12+
"package": "./package.json"
13+
},
14+
"templates": {
15+
"theme": "lumen",
16+
"systemName": "js-data-localstorage",
17+
"copyright": "js-data-localstorage Copyright © 2014-2016 Jason Dobry",
18+
"outputSourceFiles": true,
19+
"syntaxTheme": "dark",
20+
"linenums": true,
21+
"footer": "<div style=\"text-align:center\">Back to <a href=\"http://js-data.io\">js-data.io</a></div>"
22+
}
23+
}

0 commit comments

Comments
 (0)