w-trade-backtest 1.0.3 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/dist/w-trade-backtest.umd.js +8 -8
  2. package/dist/w-trade-backtest.umd.js.map +1 -1
  3. package/docs/buildKLinesTpSl.mjs.html +218 -0
  4. package/docs/calcOrders.mjs.html +2 -2
  5. package/docs/calcOrdersRatio.mjs.html +2 -2
  6. package/docs/calcOrdersSummary.mjs.html +2 -2
  7. package/docs/calcOrdersSummarySimple.mjs.html +2 -2
  8. package/docs/calcSummary.mjs.html +2 -2
  9. package/docs/closeAndSummaryOrders.mjs.html +2 -2
  10. package/docs/genKLinesTpSl.mjs.html +154 -0
  11. package/docs/genReport.mjs.html +2 -2
  12. package/docs/genReportCore.mjs.html +2 -2
  13. package/docs/global.html +2078 -380
  14. package/docs/index.html +2 -2
  15. package/docs/loadKLinesTpSl.mjs.html +189 -0
  16. package/docs/runStrategies.mjs.html +2 -2
  17. package/docs/runStrategiesAndBacktest.mjs.html +224 -0
  18. package/docs/runStrategy.mjs.html +2 -2
  19. package/package.json +1 -1
  20. package/src/WTradeBacktest.mjs +8 -0
  21. package/src/buildKLinesTpSl.mjs +146 -0
  22. package/src/genKLinesTpSl.mjs +82 -0
  23. package/src/loadKLinesTpSl.mjs +117 -0
  24. package/src/runStrategiesAndBacktest.mjs +152 -0
  25. package/test/unit-WTradeBacktest.test.mjs +23 -529
  26. package/test/unit-buildKLinesTpSl.test.mjs +98 -0
  27. package/test/unit-calcOrders.test.mjs +60 -0
  28. package/test/unit-calcOrdersRatio.test.mjs +39 -0
  29. package/test/unit-calcOrdersSummary.test.mjs +71 -0
  30. package/test/unit-calcOrdersSummarySimple.test.mjs +30 -0
  31. package/test/unit-calcSummary.test.mjs +30 -0
  32. package/test/unit-closeAndSummaryOrders.test.mjs +53 -0
  33. package/test/unit-genKLinesTpSl.test.mjs +46 -0
  34. package/test/unit-genReport.test.mjs +113 -0
  35. package/test/unit-genReportCore.test.mjs +39 -0
  36. package/test/unit-loadKLinesTpSl.test.mjs +158 -0
  37. package/test/unit-ott.test.mjs +20 -0
  38. package/test/unit-runStrategies.test.mjs +30 -0
  39. package/test/unit-runStrategiesAndBacktest.test.mjs +114 -0
  40. package/test/unit-runStrategy.test.mjs +53 -0
  41. package/test/unit-setup.mjs +120 -0
  42. package/test/unit-writeJson.test.mjs +29 -0
  43. package/test/unit-writeTxt.test.mjs +27 -0
@@ -0,0 +1,30 @@
1
+ import assert from 'assert'
2
+ import ott from '../src/ott.mjs'
3
+ import runStrategies from '../src/runStrategies.mjs'
4
+ import { buildStrategy, buildFunGetSeries } from './unit-setup.mjs'
5
+
6
+
7
+ //規格來源: src/runStrategies.mjs
8
+ // runStrategies(ott, strategies, funGetSeries, opt): 逐策略執行(withSummary:false), 合併orders附sid, 以uIni總和跑calcSummary
9
+
10
+
11
+ describe('runStrategies', function() {
12
+
13
+ let funGetSeries = buildFunGetSeries()
14
+
15
+ it('合併多策略訂單附sid, 以uIni總和2000計算summary', async function() {
16
+ let strategies = [
17
+ { sid: 's1', ...buildStrategy('long', '>', 0.5) },
18
+ { sid: 's2', ...buildStrategy('short', '<', 0.5) },
19
+ ]
20
+ let rr = await runStrategies(ott, strategies, funGetSeries)
21
+ //s1: t00/t08下單2筆; s2: sig<0.5於t04/t12/t16/t20下單4筆(t20單其後無K棒未平倉)
22
+ assert.strictEqual(rr.orders.length, 6)
23
+ assert.deepStrictEqual(rr.orders.map((o) => o.sid), ['s1', 's2', 's1', 's2', 's2', 's2']) //依timeStart排序
24
+ assert.strictEqual(rr.summary.uIni, 2000)
25
+ assert.strictEqual(rr.summary.numTrade, 6)
26
+ assert.strictEqual(rr.summary.numTradeFin, 5)
27
+ assert.strictEqual(rr.summary.rWin, '40.00%') //s1一勝一敗, s2一勝二敗一未平
28
+ })
29
+
30
+ })
@@ -0,0 +1,114 @@
1
+ import assert from 'assert'
2
+ import fs from 'fs'
3
+ import path from 'path'
4
+ import ott from '../src/ott.mjs'
5
+ import runStrategiesAndBacktest from '../src/runStrategiesAndBacktest.mjs'
6
+ import { t00, t20, buildArrOhlc, buildArrSig, buildStrategy, buildFdTmp } from './unit-setup.mjs'
7
+
8
+
9
+ //規格來源: src/runStrategiesAndBacktest.mjs
10
+ // runStrategiesAndBacktest(ott, fdOhlc, fdParam, strategies, timeStart, timeEnd, fdTest, opt):
11
+ // 以w-data-tdprovide讀取fdOhlc/fdParam數據建立funGetSeries後跑runStrategies, 結果name為'全部策略',
12
+ // 並依opt.writeOrders/writeSummary/writeReport(皆預設true)輸出orders.json/summary.json/report.html至fdTest
13
+
14
+
15
+ let fdTmp = buildFdTmp('runStrategiesAndBacktest')
16
+
17
+
18
+ describe('runStrategiesAndBacktest', function() {
19
+
20
+ after(function() {
21
+ fs.rmSync(fdTmp, { recursive: true, force: true })
22
+ })
23
+
24
+ let strategies = [
25
+ { sid: 's1', ...buildStrategy('long', '>', 0.5) },
26
+ { sid: 's2', ...buildStrategy('short', '<', 0.5) },
27
+ ]
28
+
29
+ //buildFdData: 於`${fdTmp}/${fd}`建立data-ohlc(btc.json)與data-param(sig.json), 回傳兩資料夾路徑
30
+ let buildFdData = (fd) => {
31
+ let fdOhlc = path.resolve(fdTmp, fd, 'data-ohlc')
32
+ let fdParam = path.resolve(fdTmp, fd, 'data-param')
33
+ fs.mkdirSync(fdOhlc, { recursive: true })
34
+ fs.mkdirSync(fdParam, { recursive: true })
35
+ fs.writeFileSync(path.resolve(fdOhlc, 'btc.json'), JSON.stringify(buildArrOhlc()), 'utf8')
36
+ fs.writeFileSync(path.resolve(fdParam, 'sig.json'), JSON.stringify(buildArrSig()), 'utf8')
37
+ return { fdOhlc, fdParam }
38
+ }
39
+
40
+ it('讀取數據執行多策略, 回傳name為全部策略之合併結果並輸出orders.json/summary.json/report.html', async function() {
41
+ let { fdOhlc, fdParam } = buildFdData('rsab-all')
42
+ let fdTest = path.resolve(fdTmp, 'rsab-all', 'result')
43
+
44
+ let r = await runStrategiesAndBacktest(ott, fdOhlc, fdParam, strategies, t00, t20, fdTest)
45
+
46
+ //r, 同runStrategies之合併結果(s1兩單, s2四單, 依timeStart排序)另附name
47
+ assert.strictEqual(r.name, '全部策略')
48
+ assert.strictEqual(r.orders.length, 6)
49
+ assert.deepStrictEqual(r.orders.map((o) => o.sid), ['s1', 's2', 's1', 's2', 's2', 's2'])
50
+ assert.strictEqual(r.summary.uIni, 2000)
51
+ assert.strictEqual(r.summary.timeOhlcStart, t00)
52
+ assert.strictEqual(r.summary.timeOhlcEnd, t20)
53
+ assert.strictEqual(r.summary.numTrade, 6)
54
+ assert.strictEqual(r.summary.numTradeUnsettled, 1)
55
+ assert.strictEqual(r.summary.rWin, '40.00%')
56
+
57
+ //orders.json
58
+ let orders = JSON.parse(fs.readFileSync(path.resolve(fdTest, 'orders.json'), 'utf8'))
59
+ assert.strictEqual(orders.length, 6)
60
+ assert.strictEqual(orders[0].sid, 's1')
61
+ assert.strictEqual(orders[0].timeStart, t00)
62
+
63
+ //summary.json
64
+ let stsm = JSON.parse(fs.readFileSync(path.resolve(fdTest, 'summary.json'), 'utf8'))
65
+ assert.strictEqual(stsm.name, '全部策略')
66
+ assert.strictEqual(stsm.summary.numTrade, 6)
67
+ assert.strictEqual(stsm.summary.rWin, '40.00%')
68
+
69
+ //report.html, 已置換name與orders
70
+ let fpHtml = path.resolve(fdTest, 'report.html')
71
+ assert.ok(fs.existsSync(fpHtml))
72
+ let h = fs.readFileSync(fpHtml, 'utf8')
73
+ assert.ok(h.includes('全部策略'))
74
+ assert.ok(!h.includes('{orders}'))
75
+ assert.ok(!h.includes('{summary}'))
76
+ })
77
+
78
+ it('writeOrders/writeSummary/writeReport皆false時不輸出檔案, 仍回傳結果', async function() {
79
+ let { fdOhlc, fdParam } = buildFdData('rsab-nowrite')
80
+ let fdTest = path.resolve(fdTmp, 'rsab-nowrite', 'result')
81
+
82
+ let r = await runStrategiesAndBacktest(ott, fdOhlc, fdParam, strategies, t00, t20, fdTest, {
83
+ writeOrders: false,
84
+ writeSummary: false,
85
+ writeReport: false,
86
+ })
87
+
88
+ assert.strictEqual(r.orders.length, 6)
89
+ assert.ok(!fs.existsSync(path.resolve(fdTest, 'orders.json')))
90
+ assert.ok(!fs.existsSync(path.resolve(fdTest, 'summary.json')))
91
+ assert.ok(!fs.existsSync(path.resolve(fdTest, 'report.html')))
92
+ })
93
+
94
+ it('fdOhlc非資料夾時reject', async function() {
95
+ let { fdParam } = buildFdData('rsab-invalid')
96
+ let fdOhlc = path.resolve(fdTmp, 'rsab-invalid', 'none')
97
+ let fdTest = path.resolve(fdTmp, 'rsab-invalid', 'result')
98
+ await assert.rejects(runStrategiesAndBacktest(ott, fdOhlc, fdParam, strategies, t00, t20, fdTest), { message: `fdOhlc[${fdOhlc}] is not a forder` })
99
+ })
100
+
101
+ it('fdParam非資料夾時reject', async function() {
102
+ let { fdOhlc } = buildFdData('rsab-invalid2')
103
+ let fdParam = path.resolve(fdTmp, 'rsab-invalid2', 'none')
104
+ let fdTest = path.resolve(fdTmp, 'rsab-invalid2', 'result')
105
+ await assert.rejects(runStrategiesAndBacktest(ott, fdOhlc, fdParam, strategies, t00, t20, fdTest), { message: `fdParam[${fdParam}] is not a forder` })
106
+ })
107
+
108
+ it('strategies非有效陣列時reject', async function() {
109
+ let { fdOhlc, fdParam } = buildFdData('rsab-nostrategies')
110
+ let fdTest = path.resolve(fdTmp, 'rsab-nostrategies', 'result')
111
+ await assert.rejects(runStrategiesAndBacktest(ott, fdOhlc, fdParam, [], t00, t20, fdTest), { message: `invalid strategies` })
112
+ })
113
+
114
+ })
@@ -0,0 +1,53 @@
1
+ import assert from 'assert'
2
+ import ott from '../src/ott.mjs'
3
+ import runStrategy from '../src/runStrategy.mjs'
4
+ import { t00, t04, t08, t12, t20, buildStrategy, buildFunGetSeries } from './unit-setup.mjs'
5
+
6
+
7
+ //規格來源: src/runStrategy.mjs
8
+ // runStrategy(ott, strategy, funGetSeries, opt): 依conds(sym/th/opr)於各時間點判斷觸發下單, 以settings計算止盈止損價格, 再走calcOrders+summary
9
+
10
+
11
+ describe('runStrategy', function() {
12
+
13
+ let funGetSeries = buildFunGetSeries()
14
+
15
+ it('long策略: sig>0.5於t00與t08下單, t00單止盈於t04, t08單止損於t12', async function() {
16
+ let r = await runStrategy(ott, buildStrategy('long', '>', 0.5), funGetSeries)
17
+ assert.strictEqual(r.orders.length, 2)
18
+ let o0 = r.orders[0]
19
+ assert.strictEqual(o0.mode, 'long')
20
+ assert.strictEqual(o0.timeStart, t00)
21
+ assert.strictEqual(o0.priceStart, 100) //下單時Close
22
+ assert.strictEqual(o0.timeEnd, t04)
23
+ assert.strictEqual(o0.priceEnd, 105) //priceTakeProfit=(1+0.05)*100
24
+ assert.strictEqual(o0.modeResult, 'profit')
25
+ let o1 = r.orders[1]
26
+ assert.strictEqual(o1.timeStart, t08)
27
+ assert.strictEqual(o1.priceStart, 103)
28
+ assert.strictEqual(o1.timeEnd, t12)
29
+ assert.strictEqual(o1.priceEnd, 99.91) //priceStopLoss=(1-0.03)*103
30
+ assert.strictEqual(o1.modeResult, 'loss')
31
+ })
32
+
33
+ it('summary附timeOhlcStart/timeOhlcEnd/uIni與統計欄位', async function() {
34
+ let r = await runStrategy(ott, buildStrategy('long', '>', 0.5), funGetSeries)
35
+ assert.strictEqual(r.summary.timeOhlcStart, t00)
36
+ assert.strictEqual(r.summary.timeOhlcEnd, t20)
37
+ assert.strictEqual(r.summary.uIni, 1000)
38
+ assert.strictEqual(r.summary.numTrade, 2)
39
+ assert.strictEqual(r.summary.numTradeFin, 2)
40
+ assert.strictEqual(r.summary.rWin, '50.00%')
41
+ })
42
+
43
+ it('mode非long或short時reject', async function() {
44
+ await assert.rejects(runStrategy(ott, { mode: 'x' }, funGetSeries), { message: `invalid strategy.mode[x] not 'long' or 'short'` })
45
+ })
46
+
47
+ it('withSummary:false時summary不含統計欄位', async function() {
48
+ let r = await runStrategy(ott, buildStrategy('long', '>', 0.5), funGetSeries, { withSummary: false })
49
+ assert.strictEqual(r.summary.numTrade, undefined)
50
+ assert.strictEqual(r.summary.timeOhlcStart, t00)
51
+ })
52
+
53
+ })
@@ -0,0 +1,120 @@
1
+ import path from 'path'
2
+
3
+
4
+ //共用fixtures與工具, 各unit-*.test.mjs引用
5
+ // 本檔不帶.test.中綴, 不會被mocha當測試檔抓取
6
+
7
+
8
+ //approx, 浮點容差比較
9
+ let approx = (a, b, tol = 1e-9) => Math.abs(a - b) < tol
10
+
11
+
12
+ //fixtures: 6根4hr K線(同一日內, 2020-01-01T00:00至20:00)
13
+ let t00 = '2020-01-01T00:00:00'
14
+ let t04 = '2020-01-01T04:00:00'
15
+ let t08 = '2020-01-01T08:00:00'
16
+ let t12 = '2020-01-01T12:00:00'
17
+ let t16 = '2020-01-01T16:00:00'
18
+ let t20 = '2020-01-01T20:00:00'
19
+ let buildArrOhlc = () => {
20
+ return [
21
+ { time: t00, Open: 100, High: 101, Low: 99, Close: 100 },
22
+ { time: t04, Open: 100, High: 106, Low: 100, Close: 105 },
23
+ { time: t08, Open: 105, High: 107, Low: 102, Close: 103 },
24
+ { time: t12, Open: 103, High: 104, Low: 94, Close: 95 },
25
+ { time: t16, Open: 95, High: 98, Low: 92, Close: 93 },
26
+ { time: t20, Open: 93, High: 99, Low: 95, Close: 97 },
27
+ ]
28
+ }
29
+
30
+ //buildOrders: 4張手工下單(calcOrders會就地修改訂單, 故每次重建)
31
+ // A: long@t00, priceStart=100, TP=105(t04之High=106觸發止盈), SL=97
32
+ // B: long@t04, priceStart=105, TP=110.25, SL=101.85(t12之Low=94觸發止損)
33
+ // C: short@t08, priceStart=103, TP=97.85(t12之Low=94觸發止盈), SL=106.09
34
+ // D: long@t16, priceStart=93, TP=105, SL=85(其後K棒皆未觸發, 未平倉)
35
+ let buildOrder = (mode, timeStart, priceStart, priceTakeProfit, priceStopLoss) => {
36
+ return {
37
+ mode,
38
+ timeStart,
39
+ priceStart,
40
+ uTrade: 100,
41
+ priceTakeProfit,
42
+ priceStopLoss,
43
+ timeEnd: '',
44
+ priceEnd: '',
45
+ modeResult: '',
46
+ uFee: 0.05, //rFee=0.0005, uFee=0.0005*100
47
+ }
48
+ }
49
+ let buildOrders = () => {
50
+ return [
51
+ buildOrder('long', t00, 100, 105, 97),
52
+ buildOrder('long', t04, 105, 110.25, 101.85),
53
+ buildOrder('short', t08, 103, 97.85, 106.09),
54
+ buildOrder('long', t16, 93, 105, 85),
55
+ ]
56
+ }
57
+
58
+ //buildArrSig: sig訊號, t00與t08為1(>th觸發), 其餘為0
59
+ let buildArrSig = () => {
60
+ return [
61
+ { time: t00, param: 1 },
62
+ { time: t04, param: 0 },
63
+ { time: t08, param: 1 },
64
+ { time: t12, param: 0 },
65
+ { time: t16, param: 0 },
66
+ { time: t20, param: 0 },
67
+ ]
68
+ }
69
+
70
+ //buildStrategy: 單一策略, keyOhlc為btc, 條件序列為sig
71
+ let buildStrategy = (mode, sym, th) => {
72
+ return {
73
+ mode,
74
+ keyOhlc: 'btc',
75
+ conds: [{ key: 'sig', sym, th, opr: 'and' }],
76
+ settings: {
77
+ uIni: 1000,
78
+ uTrade: 100,
79
+ rTakeProfit: 0.05,
80
+ rStopLoss: 0.03,
81
+ rFee: 0.0005,
82
+ },
83
+ }
84
+ }
85
+
86
+ //buildFunGetSeries: 序列查詢函數, btc回傳K線, sig回傳訊號
87
+ let buildFunGetSeries = () => {
88
+ let arrSig = buildArrSig()
89
+ return async (key) => {
90
+ if (key === 'btc') {
91
+ return buildArrOhlc()
92
+ }
93
+ if (key === 'sig') {
94
+ return arrSig
95
+ }
96
+ throw new Error(`invalid key[${key}]`)
97
+ }
98
+ }
99
+
100
+ //buildFdTmp: 暫存根資料夾, 各測試檔獨立使用./test/tmp-unit-{函數名}, 結束時整夾刪除,
101
+ // 各檔不共用父層, 故平行測試(mocha --parallel)時互不干擾
102
+ let buildFdTmp = (name) => path.resolve(`./test/tmp-unit-${name}`)
103
+
104
+
105
+ export {
106
+ approx,
107
+ t00,
108
+ t04,
109
+ t08,
110
+ t12,
111
+ t16,
112
+ t20,
113
+ buildArrOhlc,
114
+ buildOrder,
115
+ buildOrders,
116
+ buildArrSig,
117
+ buildStrategy,
118
+ buildFunGetSeries,
119
+ buildFdTmp,
120
+ }
@@ -0,0 +1,29 @@
1
+ import assert from 'assert'
2
+ import fs from 'fs'
3
+ import path from 'path'
4
+ import writeJson from '../src/writeJson.mjs'
5
+ import { buildFdTmp } from './unit-setup.mjs'
6
+
7
+
8
+ //規格來源: src/writeJson.mjs
9
+ // writeJson(fp, obj, {structured}): 自動建立上層資料夾後寫出json, structured:true為多行縮排
10
+
11
+
12
+ let fdTmp = buildFdTmp('writeJson')
13
+
14
+
15
+ describe('writeJson', function() {
16
+
17
+ after(function() {
18
+ fs.rmSync(fdTmp, { recursive: true, force: true })
19
+ })
20
+
21
+ it('自動建立資料夾並寫出json, structured:true為多行縮排', function() {
22
+ let fp = path.resolve(fdTmp, 'sub-json', 'a.json')
23
+ writeJson(fp, { a: 1, b: [2, 3] }, { structured: true })
24
+ let c = fs.readFileSync(fp, 'utf8')
25
+ assert.deepStrictEqual(JSON.parse(c), { a: 1, b: [2, 3] })
26
+ assert.ok(c.includes('\n'))
27
+ })
28
+
29
+ })
@@ -0,0 +1,27 @@
1
+ import assert from 'assert'
2
+ import fs from 'fs'
3
+ import path from 'path'
4
+ import writeTxt from '../src/writeTxt.mjs'
5
+ import { buildFdTmp } from './unit-setup.mjs'
6
+
7
+
8
+ //規格來源: src/writeTxt.mjs
9
+ // writeTxt(fp, txt): 自動建立上層資料夾後寫出文字檔
10
+
11
+
12
+ let fdTmp = buildFdTmp('writeTxt')
13
+
14
+
15
+ describe('writeTxt', function() {
16
+
17
+ after(function() {
18
+ fs.rmSync(fdTmp, { recursive: true, force: true })
19
+ })
20
+
21
+ it('自動建立資料夾並寫出文字', function() {
22
+ let fp = path.resolve(fdTmp, 'sub-txt', 'a.txt')
23
+ writeTxt(fp, 'abc中文')
24
+ assert.strictEqual(fs.readFileSync(fp, 'utf8'), 'abc中文')
25
+ })
26
+
27
+ })