Compare commits
17 Commits
Author | SHA1 | Date | |
---|---|---|---|
77a06a0fc4 | |||
c9792b1955 | |||
b87de178c0 | |||
0580f29d30 | |||
2c17273671 | |||
669ed2e6ab | |||
8bc73b2bf4 | |||
78e5defd7c | |||
7e540bda87 | |||
b293dfe92d | |||
a753a5db2c | |||
27f79b4425 | |||
1ada5dd5a9 | |||
a41bfd442c | |||
2917b10ffb | |||
bfc5bbbbb7 | |||
cf507a4a17 |
35
README.md
35
README.md
@ -1,6 +1,13 @@
|
||||
# npmts
|
||||
Write npm modules with TypeScript without hassle.
|
||||
|
||||
## Status
|
||||
[](https://travis-ci.org/pushrocks/npmts)
|
||||
[](https://david-dm.org/pushrocks/npmts)
|
||||
[](https://www.bithound.io/github/pushrocks/npmts/master/dependencies/npm)
|
||||
[](https://www.bithound.io/github/pushrocks/npmts)
|
||||
[](https://coveralls.io/github/pushrocks/npmts?branch=master)
|
||||
|
||||
## How to use npmts
|
||||
|
||||
### Install
|
||||
@ -19,6 +26,23 @@ Then use it in package.json's script section to trigger a build:
|
||||
```
|
||||
|
||||
### Default behaviour
|
||||
|
||||
**Execution order of tasks**
|
||||
|
||||
1. Install typings
|
||||
2. Compile TypeScript
|
||||
3. Create Declaration Files
|
||||
4. Instrumentalize created JavaScript files with istanbul
|
||||
5. Run Tests
|
||||
6. Create Coverage report
|
||||
7. Upload Coverage reports to travis (must be activated, only triggers on travis)
|
||||
|
||||
|
||||
#### Typings
|
||||
**npmts** looks for `./ts/typings.json` by default and installs any defined typings to `.ts/typings/`.
|
||||
You can then reference the ./ts/typings/main.d.ts file in your TypeScript code.
|
||||
|
||||
#### TypeScript
|
||||
by default npmts looks for `./ts/index.ts` and `./ts/test.ts` that will compile to
|
||||
`./index.js` and `./test.js`
|
||||
|
||||
@ -31,13 +55,21 @@ You can reference it in your package.json like this:
|
||||
"typings": "./index.d.ts",
|
||||
```
|
||||
|
||||
#### Instrumentalize Code
|
||||
npmts instrumentalizes the created JavaScript code to create a coverage report.
|
||||
|
||||
#### Tests
|
||||
When Typings have been installed, TypeScript + Declaration files have been transpiled and the resulting JS has been instrumentalized,
|
||||
npmts runs `.test/test.js` with mocha.
|
||||
|
||||
When requiring the module from other TypeScript files,
|
||||
the TypeScript Compiler will use the declaration file to resolve typings.
|
||||
|
||||
|
||||
|
||||
### Custom behaviour
|
||||
NPMTS looks for an npmts.json at the root of your package.
|
||||
Custom behaviour can be achieved through a config file at the root of your package.
|
||||
The file must be named **npmts.json**
|
||||
|
||||
```json
|
||||
{
|
||||
@ -55,6 +87,7 @@ NPMTS looks for an npmts.json at the root of your package.
|
||||
* **ts** You can list as many TypeScript files as you like. The key represents the source TypeScript file, the value the output file.
|
||||
* **typings** is an array of all direcories that have a typings.json present. Uses the new typings tool from npm.
|
||||
|
||||
|
||||
## Readme for Devs
|
||||
There is a [README-dev.md](README-dev.md) in the repo.
|
||||
This is only of interest for you when looking to contribute to, improve or build upon this package.
|
2
index.d.ts
vendored
2
index.d.ts
vendored
@ -6,7 +6,6 @@ declare module NpmtsPlugins {
|
||||
gulp: any;
|
||||
g: {
|
||||
coveralls: any;
|
||||
if: any;
|
||||
insert: any;
|
||||
istanbul: any;
|
||||
mocha: any;
|
||||
@ -44,7 +43,6 @@ declare var plugins: {
|
||||
gulp: any;
|
||||
g: {
|
||||
coveralls: any;
|
||||
if: any;
|
||||
insert: any;
|
||||
istanbul: any;
|
||||
mocha: any;
|
||||
|
21
index.js
21
index.js
@ -10,7 +10,6 @@ var NpmtsPlugins;
|
||||
gulp: require("gulp"),
|
||||
g: {
|
||||
coveralls: require("gulp-coveralls"),
|
||||
if: require("gulp-if"),
|
||||
insert: require("gulp-insert"),
|
||||
istanbul: require("gulp-istanbul"),
|
||||
mocha: require("gulp-mocha"),
|
||||
@ -77,7 +76,7 @@ var NpmtsOptions;
|
||||
var done = plugins.q.defer();
|
||||
var config = configArg;
|
||||
if (typeof config.coveralls === "undefined") {
|
||||
config.coveralls = true;
|
||||
config.coveralls = false;
|
||||
}
|
||||
if (config.mode == "default") {
|
||||
config.typings = [
|
||||
@ -85,6 +84,7 @@ var NpmtsOptions;
|
||||
];
|
||||
config.ts = (_a = {},
|
||||
_a["./ts/index.ts"] = "./index.js",
|
||||
_a["./ts/test.ts"] = "./test/test.js",
|
||||
_a
|
||||
);
|
||||
config.test = ["./index.js"];
|
||||
@ -168,7 +168,8 @@ var NpmtsCompile;
|
||||
var tsStream = plugins.gulp.src(plugins.path.join(paths.cwd, key))
|
||||
.pipe(plugins.g.typescript({
|
||||
out: outputName,
|
||||
declaration: true
|
||||
declaration: true,
|
||||
target: "ES5"
|
||||
}));
|
||||
var stream = plugins.mergeStream([
|
||||
tsStream.dts.pipe(plugins.gulp.dest(outputDir)),
|
||||
@ -209,15 +210,20 @@ var NpmtsTests;
|
||||
return stream;
|
||||
};
|
||||
var coveralls = function () {
|
||||
var stream = plugins.gulp.src("./coverage/**/lcov.info")
|
||||
.pipe(plugins.g.if((process.env.TRAVIS && config.coveralls), plugins.g.coveralls()));
|
||||
var stream = plugins.gulp.src([plugins.path.join(paths.cwd, "./coverage/lcov.info")])
|
||||
.pipe(plugins.g.coveralls());
|
||||
return stream;
|
||||
};
|
||||
istanbul().on("finish", function () {
|
||||
mocha().on("finish", function () {
|
||||
coveralls().on("finish", function () {
|
||||
if (process.env.TRAVIS && config.coveralls) {
|
||||
coveralls().on("finish", function () {
|
||||
done.resolve(config);
|
||||
});
|
||||
}
|
||||
else {
|
||||
done.resolve(config);
|
||||
});
|
||||
}
|
||||
});
|
||||
});
|
||||
return done.promise;
|
||||
@ -246,5 +252,6 @@ var NpmtsPromisechain;
|
||||
/// <reference path="./npmts.promisechain.ts" />
|
||||
console.log("**** starting NPMTS ****");
|
||||
var plugins = NpmtsPlugins.init();
|
||||
plugins.beautylog.figletSync("NPMTS");
|
||||
var paths = NpmtsPaths.init();
|
||||
var promisechain = NpmtsPromisechain.init();
|
||||
|
11
package.json
11
package.json
@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "npmts",
|
||||
"version": "2.1.10",
|
||||
"version": "2.3.0",
|
||||
"description": "write npm modules with TypeScript",
|
||||
"main": "index.js",
|
||||
"typings": "./index.d.ts",
|
||||
@ -26,20 +26,19 @@
|
||||
},
|
||||
"homepage": "https://github.com/pushrocks/npmts#readme",
|
||||
"dependencies": {
|
||||
"beautylog": "2.0.7",
|
||||
"beautylog": "2.1.1",
|
||||
"fs-extra": "^0.26.5",
|
||||
"gulp": "3.9.0",
|
||||
"gulp": "3.9.1",
|
||||
"gulp-coveralls": "^0.1.4",
|
||||
"gulp-if": "^2.0.0",
|
||||
"gulp-insert": "0.5.0",
|
||||
"gulp-istanbul": "^0.10.3",
|
||||
"gulp-mocha": "^2.2.0",
|
||||
"gulp-typescript": "2.10.0",
|
||||
"gulp-typescript": "2.11.0",
|
||||
"gulp-typings": "0.0.0",
|
||||
"merge2": "1.0.1",
|
||||
"q": "^1.4.1",
|
||||
"smartcli": "0.0.11",
|
||||
"smartfile": "0.0.11",
|
||||
"typings": "^0.6.6"
|
||||
"typings": "^0.6.8"
|
||||
}
|
||||
}
|
||||
|
@ -77,7 +77,7 @@
|
||||
</div><!-- /wrapper -->
|
||||
<div class='footer quiet pad2 space-top1 center small'>
|
||||
Code coverage
|
||||
generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Tue Feb 09 2016 17:01:13 GMT+0100 (CET)
|
||||
generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Tue Feb 16 2016 10:28:50 GMT+0100 (CET)
|
||||
</div>
|
||||
</div>
|
||||
<script src="../prettify.js"></script>
|
||||
|
@ -76,7 +76,7 @@ module.exports = testplugin;
|
||||
</div><!-- /wrapper -->
|
||||
<div class='footer quiet pad2 space-top1 center small'>
|
||||
Code coverage
|
||||
generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Tue Feb 09 2016 17:01:13 GMT+0100 (CET)
|
||||
generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Tue Feb 16 2016 10:28:50 GMT+0100 (CET)
|
||||
</div>
|
||||
</div>
|
||||
<script src="../prettify.js"></script>
|
||||
|
@ -77,7 +77,7 @@
|
||||
</div><!-- /wrapper -->
|
||||
<div class='footer quiet pad2 space-top1 center small'>
|
||||
Code coverage
|
||||
generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Tue Feb 09 2016 17:01:13 GMT+0100 (CET)
|
||||
generated by <a href="http://istanbul-js.org/" target="_blank">istanbul</a> at Tue Feb 16 2016 10:28:50 GMT+0100 (CET)
|
||||
</div>
|
||||
</div>
|
||||
<script src="prettify.js"></script>
|
||||
|
2
test/assets/test/test.d.ts
vendored
Normal file
2
test/assets/test/test.d.ts
vendored
Normal file
@ -0,0 +1,2 @@
|
||||
/// <reference path="ts/typings/main.d.ts" />
|
||||
declare var testplugin: any;
|
@ -1,3 +1,5 @@
|
||||
#!/usr/bin/env node
|
||||
|
||||
/// <reference path="./typings/main.d.ts" />
|
||||
console.log("**** starting test ****");
|
||||
var testplugin = require("../index.js");
|
||||
|
@ -7,7 +7,8 @@
|
||||
/// <reference path="./npmts.compile.ts" />
|
||||
/// <reference path="./npmts.tests.ts" />
|
||||
/// <reference path="./npmts.promisechain.ts" />
|
||||
console.log("**** starting NPMTS ****")
|
||||
console.log("**** starting NPMTS ****");
|
||||
var plugins = NpmtsPlugins.init();
|
||||
plugins.beautylog.figletSync("NPMTS");
|
||||
var paths = NpmtsPaths.init();
|
||||
var promisechain = NpmtsPromisechain.init();
|
||||
|
@ -70,7 +70,8 @@ module NpmtsCompile {
|
||||
var tsStream = plugins.gulp.src(plugins.path.join(paths.cwd,key))
|
||||
.pipe(plugins.g.typescript({
|
||||
out: outputName,
|
||||
declaration: true
|
||||
declaration: true,
|
||||
target: "ES5"
|
||||
}));
|
||||
var stream = plugins.mergeStream([
|
||||
tsStream.dts.pipe(plugins.gulp.dest(outputDir)),
|
||||
|
@ -4,14 +4,15 @@ module NpmtsOptions {
|
||||
var done = plugins.q.defer();
|
||||
var config = configArg;
|
||||
if (typeof config.coveralls === "undefined"){
|
||||
config.coveralls = true;
|
||||
config.coveralls = false;
|
||||
}
|
||||
if (config.mode == "default"){
|
||||
config.typings = [
|
||||
"./ts/"
|
||||
];
|
||||
config.ts = {
|
||||
["./ts/index.ts"]: "./index.js"
|
||||
["./ts/index.ts"]: "./index.js",
|
||||
["./ts/test.ts"]: "./test/test.js"
|
||||
};
|
||||
config.test = ["./index.js"];
|
||||
done.resolve(config);
|
||||
|
@ -7,7 +7,6 @@ module NpmtsPlugins {
|
||||
gulp: require("gulp"),
|
||||
g: {
|
||||
coveralls: require("gulp-coveralls"),
|
||||
if: require("gulp-if"),
|
||||
insert: require("gulp-insert"),
|
||||
istanbul: require("gulp-istanbul"),
|
||||
mocha: require("gulp-mocha"),
|
||||
|
@ -23,19 +23,20 @@ module NpmtsTests {
|
||||
};
|
||||
|
||||
var coveralls = function(){
|
||||
var stream = plugins.gulp.src("./coverage/**/lcov.info")
|
||||
.pipe(plugins.g.if(
|
||||
(process.env.TRAVIS && config.coveralls),
|
||||
plugins.g.coveralls()
|
||||
));
|
||||
var stream = plugins.gulp.src([plugins.path.join(paths.cwd,"./coverage/lcov.info")])
|
||||
.pipe(plugins.g.coveralls());
|
||||
return stream;
|
||||
};
|
||||
|
||||
istanbul().on("finish",function(){
|
||||
mocha().on("finish",function(){
|
||||
coveralls().on("finish",function(){
|
||||
if(process.env.TRAVIS && config.coveralls){
|
||||
coveralls().on("finish",function(){
|
||||
done.resolve(config);
|
||||
})
|
||||
} else {
|
||||
done.resolve(config);
|
||||
})
|
||||
}
|
||||
})
|
||||
});
|
||||
return done.promise;
|
||||
|
Reference in New Issue
Block a user