Skip to content

Latest commit

 

History

History
100 lines (69 loc) · 3.5 KB

CONTRIBUTING.md

File metadata and controls

100 lines (69 loc) · 3.5 KB

GitHub license Code Style: Prettier

Contribution

Author's note:

This extension is my way of giving back / saying thanks to the open-source community. If you are an open-source contributor then I take it as you already thanked. :)

Otherwise if you wanna express yourself you can buy me a coffee. Or you can just rate the extension. Whatever fits your budget.

Contributing to the source

  • Report a bug ("properly").
  • Tell me about your desired features.
  • Create a pull request (against the development branch or master (if you sure your your PR is ready to be deployed)).

Clone Repo

It is recommended to create a push hook:

cp ./resources/githooks/pre-push ./.git/hooks/pre-push

Content of .git/hooks/pre-push file:

#!/bin/sh
echo "pre-push hook:"
set -e -x
npm audit --production
npm run compile
npx mocha ./out/test/Documentation.test.js ./out/test/ESLint.test.js

Install

nvm use
npm install

Test

After installing:

npm test

Debug

After test:

  1. Open the folder in VSCode: code ..
  2. Let task npm watch run in the background.
  3. VSCode "Run" / Debug page: Select Manual cpp.
  4. Start debugging.
  5. Add your folder to the newly opened VSCode's workspace. (Or change launch.json's Manual cpp to the folder which is intended to be debugged and the start.)

Issues are tipically related to file operations:

Publishing to market

If you think your changes worth of a release add a new version entry to CHANGELOG.md file without a date. Travis will publish it automatically.

TODO:future

VSCE_PAT

VSCode API Change tracking tool

LAST_CHECKED_VERSION="1.72.2" && \
curl "https://raw.githubusercontent.com/microsoft/vscode/${LAST_CHECKED_VERSION}/src/vscode-dts/vscode.d.ts" \
--output "./out/latest_checked.vscode.d.ts" && \
curl "https://raw.githubusercontent.com/microsoft/vscode/main/src/vscode-dts/vscode.d.ts" \
--output "./out/latest.vscode.d.ts" && \
bcomp "./out/latest_checked.vscode.d.ts" "./out/latest.vscode.d.ts"

VSCODE TESTING API

TODOs

    1. run skipped directly; 2. run skipped by parent; see status: not resetted, shouldn't be