Skip to content

Commit

Permalink
doc: Update contributing guidelines
Browse files Browse the repository at this point in the history
  • Loading branch information
q2s2t committed Dec 3, 2018
1 parent 3302813 commit add27cc
Show file tree
Hide file tree
Showing 4 changed files with 64 additions and 17 deletions.
8 changes: 5 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,8 @@ easy-to-follow rules.

* Use [StandrdJS](https://standardjs.com/)
* Write test for your modifications (use `mocha` and `chai` modules).
* Keep the code coverage as high as possible (100% is awesome!). Install
`istanbul` module and run `npm run coverage` to check it.
* Proudly add yourself to the contributors in `package.json`! :+1:
* Keep the code coverage as high as possible (100% is awesome!)
* Unit test with `npm run test-unit-coverage` and check the result.
* Functionnal test with `npm run test-unit-func` and check the result.
* Proudly add yourself to the contributors in `package.json`! :+1:
* Commit your changes using [Conventionnal Commits](https://www.conventionalcommits.org/)
22 changes: 11 additions & 11 deletions TODO
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@ Code quality:
✔ Code coverage 100 % @done(18-11-02 15:52)
✔ Tests file naming and test naming conventions @done(18-09-29 09:28)
✔ Windows testing on AppVeyor @done(18-11-13 20:03)
https://conventionalcommits.org
https://conventionalcommits.org @done(18-12-03 22:23)
✘ Use c8 for coverage @cancelled(18-12-02 16:32)
✔ Move to CircleCI because TravisCI is not using p7zip-full v16.x @done(18-10-17 20:35)
✔ CircleCi local test with docker (add circleci to system dev deps) @done(18-10-17 20:36)
Expand All @@ -15,36 +15,33 @@ Package:
✘ 7zip-bin as peer dependecy? @cancelled(18-11-13 20:04) See README.md for installation
☐ upload to npm
Switches:
☐ Add auto-`--` switch when file name starts with `-`
☐ Auto-`-an` (Disable parsing of archive_name) switch
☐ Implement -bd Disable progress indicator
☐ Implement -bt Show execution time statistics
☐ Implement -slt Show technical information
✔ Implement -bt Show execution time statistics @done(18-12-03 19:51)
✔ Implement -slt Show technical information @done(18-12-03 19:55)
✔ wildcards and raw outside of `toChildProcessArgs()` @done(18-09-04 21:49)
✔ -snc and -ssc @done(18-08-21 22:50)
✔ Default to `-y` @done(18-08-21 22:50)
✔ Update test cases @started(18-08-21 22:51) @done(18-08-23 12:36) @lasted(1d13h45m3s)
✔ Set -bb as default as it is required for the lib to works @done(18-09-11 22:58)
☐ Proper propagation of errors (both sync and async)
Maintenance:
✔ Proper propagation of errors (both sync and async) @done(18-12-03 22:23)
✔ Upgrade codebase to ES6 @done(18-09-11 22:58)
✔ Spaces in achive name, file name or in switches @done(18-08-23 12:36)
Keep a Promise and callback style interface on top (do not recommand using it)
Keep a Promise and callback style interface on top (do not recommand using it) @cancelled(18-12-03 22:23)
☐ Check all issues from GitHub and test them
✔ fix: dual instance (see test-debug) @done(18-11-13 20:05)
Refactor in dependecy injection style @started(18-11-13 20:05)
Refactor in dependecy injection style @started(18-11-13 20:05) @done(18-12-02 21:37) @lasted(2w5d1h32m17s)
Features:
✔ Streams? Buffer or Object mode? @done(18-09-09 18:58)
✔ 7z path option @done(18-09-02 19:34)
Exit codes
Exit codes @cancelled(18-12-03 22:23)
☐ TypeScript support
☐ Babel/ES5 etc support
✔ Close/end SevenZipStream @done(18-12-02 12:31)
✔ Full-named switches for cleaner API @done(18-11-04 19:54)
✔ Stream methods returns stream @done(18-10-17 20:35)
✔ Esier to use progress @done(18-12-02 12:31)
☐ Status (TU+R. and others?) as plain text
Documentation:
☐ Status (TU+R. and others?) as plain text
☐ Usage for wildcard/raw/bin input ($ instead of _ preffix)
☐ Usage for repeating switches
☐ Usage for -r (Recurse subdirectories) switch
Expand All @@ -55,10 +52,13 @@ Documentation:
☐ $defer
☐ attch a child process $childProcess
☐ add(archive, [source1, source2]) usage
☐ `-bd` Disable progress indicator is like using a different log level and incompatible with this implementation
☐ No benchmark command: It will output based on the system that it is on, "system-static"
☐ No Show information about supported formats command: It will output based on the system that it is on, "system-static"
☐ Hack to use delete() command (delete is a JS reserved word)
☐ use `$cherryPick` as name for clarity
☐ list and rename doesn't output progress percentage (upstream behaviour)
☐ Only support recent versions of 7z
☐ $legacy support
☐ `--` switch when file name starts with `-`
☐ `-an` (Disable parsing of archive_name) switch
44 changes: 42 additions & 2 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

7 changes: 6 additions & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@
"main": "lib/index.js",
"scripts": {
"test": "npx mocha -r esm --reporter=spec \"test/**/*.spec.js\" --timeout=0",
"test-unit": "npx mocha -r esm --reporter=spec \"test/unit/*.spec.js\"",
"test-unit-coverage": "npx nyc --reporter=html npm run test-unit",
"test-func": "npx mocha -r esm --reporter=spec \"test/func/*.spec.js\" --timeout=0",
"test-func-coverage": "npx nyc --reporter=html npm run test-func",
"test-debug": "DEBUG=node-7z npm run test",
"test-coverage": "npx nyc --reporter=lcov npm run test"
},
Expand Down Expand Up @@ -50,7 +54,8 @@
"debug": "^4.1.0",
"esm": "^3.0.79",
"lodash": "^4.17.11",
"normalize-path": "^3.0.0"
"normalize-path": "^3.0.0",
"stream-to-promise": "^2.2.0"
},
"optionalDependencies": {},
"devDependencies": {
Expand Down

0 comments on commit add27cc

Please sign in to comment.