Skip to content

Commit 3666ee8

Browse files
author
Vitor Silva
committed
Merge branch 'master' of github.com:reTHINK-project/dev-runtime-core
2 parents 3ed1496 + ba6a5e5 commit 3666ee8

File tree

2 files changed

+46
-25
lines changed

2 files changed

+46
-25
lines changed

readme.md

Lines changed: 29 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,39 +1,46 @@
1-
## Runtime-Core
1+
Runtime-Core
2+
------------
3+
4+
[Release 0.1.0](release_notes_0.1.0.md)
25

36
### Setup Environment
4-
On the first time you are cloning this repository, you need to run the command ```npm run init-setup```;
7+
8+
On the first time you are cloning this repository, you need to run the command `npm run init-setup`;
59

610
After running successfully this command you will have 2 folders (node_modules and vendor), these folders are excluded from the commit process, and are only for development.
711

8-
if you already have the project configured on your machine, you only need run the command ```npm install``` to add new dependencies;
12+
if you already have the project configured on your machine, you only need run the command `npm install` to add new dependencies;
913

1014
if you have some trouble with the environment, you can open an issue;
1115

1216
### Javascript Environment
13-
JavaScript code should be written in ES6.
14-
There are direct dependencies from nodejs and npm, these can be installed separately or in conjunction with [nvm](https://github.com/creationix/nvm)
17+
18+
JavaScript code should be written in ES6. There are direct dependencies from nodejs and npm, these can be installed separately or in conjunction with [nvm](https://github.com/creationix/nvm)
1519

1620
#### dependencies:
17-
* nodejs
18-
* npm
19-
* karma - Make the communication between unit test tool and jenkins. See more on [karma](http://karma-runner.github.io/0.13/index.html)
20-
* mocha - Unit test tool. See more on [http://mochajs.org](http://mochajs.org/)
21-
* jspm - Don't need compile the code, it uses babel (or traucer or typescript) to run ES6 code on browser. Know more in [jspm.io](http://jspm.io/)
22-
* gulp - Automate and enhance your workflow. See more about gulp on [gulp](http://gulpjs.com/)
21+
22+
- nodejs
23+
- npm
24+
- karma - Make the communication between unit test tool and jenkins. See more on [karma](http://karma-runner.github.io/0.13/index.html)
25+
- mocha - Unit test tool. See more on [http://mochajs.org](http://mochajs.org/)
26+
- jspm - Don't need compile the code, it uses babel (or traucer or typescript) to run ES6 code on browser. Know more in [jspm.io](http://jspm.io/)
27+
- gulp - Automate and enhance your workflow. See more about gulp on [gulp](http://gulpjs.com/)
2328

2429
#### Code Style and Hinting
30+
2531
On the root directory you will find **.jshintrc** and **.jscsrc**, these files are helpers to maintain syntax consistency, it signals syntax mistakes and makes the code equal for all developers.
2632

27-
- [jscs](http://jscs.info/) - Maintain JavaScript Code Style
28-
- [jshint](http://jshint.com/) - Detect errors and potential problems in JavaScript code.
33+
- [jscs](http://jscs.info/) - Maintain JavaScript Code Style
34+
- [jshint](http://jshint.com/) - Detect errors and potential problems in JavaScript code.
2935

3036
All IDE's and Text Editors can handle these tools.
3137

3238
#### Documentation
3339

34-
To generates api documentation you can run ```gulp doc```
40+
To generates api documentation you can run `gulp doc`
3541

3642
### Unit Testing
43+
3744
Unit testing can be launched manually with **karma start**.
3845

3946
~~It's advisable to use [expect.js](https://github.com/Automattic/expect.js) instead of assert.~~
@@ -50,9 +57,7 @@ How to include this repository in other software parts, like [dev-runtime-browse
5057

5158
example: [dev-runtime-browser](https://github.com/reTHINK-project/dev-runtime-browser)
5259

53-
Verify these use cases:
54-
1. if you will create a new repository, you can use this template, and can configure your development environment;
55-
2. if you already have an respository cloned;
60+
Verify these use cases: 1. if you will create a new repository, you can use this template, and can configure your development environment; 2. if you already have an respository cloned;
5661

5762
for both cases you just have run the command:
5863

@@ -92,17 +97,16 @@ if you found some issues, please submit them into the respective repository;
9297
---
9398

9499
### Karma
95-
if you have some problems starting the karma tests, try running this commands for the following order:
96100

97-
1. ```npm uninstall karma karma-browserify karma-mocha karma-mocha-reporter karma-chrome-launcher -g```
98-
2. ```npm install karma-cli -g```
99-
3. ```npm install```
100-
4. ```jspm update```
101+
if you have some problems starting the karma tests, try running this commands for the following order:
101102

103+
1. `npm uninstall karma karma-browserify karma-mocha karma-mocha-reporter karma-chrome-launcher -g`
104+
2. `npm install karma-cli -g`
105+
3. `npm install`
106+
4. `jspm update`
102107

103108
#### Note
104-
This repository is ready to start working on development of runtime-core.
105-
The code will go to the **src** folder.
106-
The unit tests will be on **test** folder, following the name standard <component>.spec.js
109+
110+
This repository is ready to start working on development of runtime-core. The code will go to the **src** folder. The unit tests will be on **test** folder, following the name standard <component>.spec.js
107111

108112
The npm module **live-server** can be used for development tests, but it's not mandatory: [live-server](https://www.npmjs.com/package/live-server)

release_notes_0.1.0.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
Release 0.1.0 Notes
2+
-------------------
3+
4+
Supported features:
5+
6+
- [deploy protostub](https://github.com/reTHINK-project/core-framework/blob/master/docs/specs/runtime/dynamic-view/basics/deploy-protostub.md)
7+
- [deploy Hyperty in the App Sandbox](https://github.com/reTHINK-project/core-framework/blob/master/docs/specs/runtime/dynamic-view/basics/deploy-hyperty.md)
8+
- [Hyperty Registration](https://github.com/reTHINK-project/core-framework/blob/master/docs/specs/runtime/dynamic-view/basics/register-hyperty.md)
9+
- [Message Routing](https://github.com/reTHINK-project/core-framework/blob/master/docs/specs/runtime/dynamic-view/basics/bus-msg-routing.md)
10+
- [exchange of messages between local Hyperties](https://github.com/reTHINK-project/core-framework/blob/master/docs/specs/runtime/dynamic-view/basics/intra-local-comm.md)
11+
12+
Known issues:
13+
14+
- no integration with Catalogue server
15+
- no integration with Domain Registry Server
16+
- Messages format not fully compliant with [WP2 Spec](https://github.com/reTHINK-project/architecture/tree/master/docs/datamodel/message).
17+
- Hyperty descriptor and Protostub descriptor not fully compliant with [WP2 Spec](https://github.com/reTHINK-project/architecture/tree/master/docs/datamodel/hyperty-catalogue).

0 commit comments

Comments
 (0)