git extension: first steps
This commit is contained in:
parent
492264d2e2
commit
8650a786ee
65
extensions/git/README.md
Normal file
65
extensions/git/README.md
Normal file
|
@ -0,0 +1,65 @@
|
||||||
|
# git README
|
||||||
|
|
||||||
|
This is the README for your extension "git". After writing up a brief description, we recommend including the following sections.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
Describe specific features of your extension including screenshots of your extension in action. Image paths are relative to this README file.
|
||||||
|
|
||||||
|
For example if there is an image subfolder under your extension project workspace:
|
||||||
|
|
||||||
|
\!\[feature X\]\(images/feature-x.png\)
|
||||||
|
|
||||||
|
> Tip: Many popular extensions utilize animations. This is an excellent way to show off your extension! We recommend short, focused animations that are easy to follow.
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
If you have any requirements or dependencies, add a section describing those and how to install and configure them.
|
||||||
|
|
||||||
|
## Extension Settings
|
||||||
|
|
||||||
|
Include if your extension adds any VS Code settings through the `contributes.configuration` extension point.
|
||||||
|
|
||||||
|
For example:
|
||||||
|
|
||||||
|
This extension contributes the following settings:
|
||||||
|
|
||||||
|
* `myExtension.enable`: enable/disable this extension
|
||||||
|
* `myExtension.thing`: set to `blah` to do something
|
||||||
|
|
||||||
|
## Known Issues
|
||||||
|
|
||||||
|
Calling out known issues can help limit users opening duplicate issues against your extension.
|
||||||
|
|
||||||
|
## Release Notes
|
||||||
|
|
||||||
|
Users appreciate release notes as you update your extension.
|
||||||
|
|
||||||
|
### 1.0.0
|
||||||
|
|
||||||
|
Initial release of ...
|
||||||
|
|
||||||
|
### 1.0.1
|
||||||
|
|
||||||
|
Fixed issue #.
|
||||||
|
|
||||||
|
### 1.1.0
|
||||||
|
|
||||||
|
Added features X, Y, and Z.
|
||||||
|
|
||||||
|
-----------------------------------------------------------------------------------------------------------
|
||||||
|
|
||||||
|
## Working with Markdown
|
||||||
|
|
||||||
|
**Note:** You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
|
||||||
|
|
||||||
|
* Split the editor (`Cmd+\` on OSX or `Ctrl+\` on Windows and Linux)
|
||||||
|
* Toggle preview (`Shift+CMD+V` on OSX or `Shift+Ctrl+V` on Windows and Linux)
|
||||||
|
* Press `Ctrl+Space` (Windows, Linux) or `Cmd+Space` (OSX) to see a list of Markdown snippets
|
||||||
|
|
||||||
|
### For more information
|
||||||
|
|
||||||
|
* [Visual Studio Code's Markdown Support](http://code.visualstudio.com/docs/languages/markdown)
|
||||||
|
* [Markdown Syntax Reference](https://help.github.com/articles/markdown-basics/)
|
||||||
|
|
||||||
|
**Enjoy!**
|
|
@ -1,34 +1,51 @@
|
||||||
{
|
{
|
||||||
"name": "gitmode",
|
"name": "git",
|
||||||
"version": "0.1.0",
|
"displayName": "git",
|
||||||
"publisher": "vscode",
|
"description": "Git",
|
||||||
"engines": { "vscode": "*" },
|
"version": "0.0.1",
|
||||||
"contributes": {
|
"publisher": "joaomoreno",
|
||||||
"languages": [
|
"engines": {
|
||||||
{
|
"vscode": "^1.5.0"
|
||||||
"id": "git-commit",
|
},
|
||||||
"aliases": ["Git Commit Message", "git-commit"],
|
"categories": [
|
||||||
"filenames": ["COMMIT_EDITMSG", "MERGE_MSG"],
|
"Other"
|
||||||
"configuration": "./git-commit.language-configuration.json"
|
],
|
||||||
},
|
"activationEvents": [
|
||||||
{
|
"*"
|
||||||
"id": "git-rebase",
|
],
|
||||||
"aliases": ["Git Rebase Message", "git-rebase"],
|
"main": "./out/extension",
|
||||||
"filenames": ["git-rebase-todo"],
|
"contributes": {
|
||||||
"configuration": "./git-rebase.language-configuration.json"
|
"commands": [],
|
||||||
}
|
"languages": [
|
||||||
],
|
{
|
||||||
"grammars": [
|
"id": "git-commit",
|
||||||
{
|
"aliases": ["Git Commit Message", "git-commit"],
|
||||||
"language": "git-commit",
|
"filenames": ["COMMIT_EDITMSG", "MERGE_MSG"],
|
||||||
"scopeName": "text.git-commit",
|
"configuration": "./git-commit.language-configuration.json"
|
||||||
"path": "./syntaxes/git-commit.tmLanguage"
|
},
|
||||||
},
|
{
|
||||||
{
|
"id": "git-rebase",
|
||||||
"language": "git-rebase",
|
"aliases": ["Git Rebase Message", "git-rebase"],
|
||||||
"scopeName": "text.git-rebase",
|
"filenames": ["git-rebase-todo"],
|
||||||
"path": "./syntaxes/git-rebase.tmLanguage"
|
"configuration": "./git-rebase.language-configuration.json"
|
||||||
}
|
}
|
||||||
]
|
],
|
||||||
}
|
"grammars": [
|
||||||
|
{
|
||||||
|
"language": "git-commit",
|
||||||
|
"scopeName": "text.git-commit",
|
||||||
|
"path": "./syntaxes/git-commit.tmLanguage"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"language": "git-rebase",
|
||||||
|
"scopeName": "text.git-rebase",
|
||||||
|
"path": "./syntaxes/git-rebase.tmLanguage"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
},
|
||||||
|
"scripts": {
|
||||||
|
"vscode:prepublish": "tsc -p ./",
|
||||||
|
"compile": "tsc -watch -p ./",
|
||||||
|
"postinstall": "node ./node_modules/vscode/bin/install"
|
||||||
|
}
|
||||||
}
|
}
|
11
extensions/git/src/extension.ts
Normal file
11
extensions/git/src/extension.ts
Normal file
|
@ -0,0 +1,11 @@
|
||||||
|
/*---------------------------------------------------------------------------------------------
|
||||||
|
* Copyright (c) Microsoft Corporation. All rights reserved.
|
||||||
|
* Licensed under the MIT License. See License.txt in the project root for license information.
|
||||||
|
*--------------------------------------------------------------------------------------------*/
|
||||||
|
|
||||||
|
'use strict';
|
||||||
|
|
||||||
|
import * as vscode from 'vscode';
|
||||||
|
|
||||||
|
export function activate(context: vscode.ExtensionContext) { }
|
||||||
|
export function deactivate() { }
|
10
extensions/git/src/typings/ref.d.ts
vendored
Normal file
10
extensions/git/src/typings/ref.d.ts
vendored
Normal file
|
@ -0,0 +1,10 @@
|
||||||
|
/*---------------------------------------------------------------------------------------------
|
||||||
|
* Copyright (c) Microsoft Corporation. All rights reserved.
|
||||||
|
* Licensed under the MIT License. See License.txt in the project root for license information.
|
||||||
|
*--------------------------------------------------------------------------------------------*/
|
||||||
|
|
||||||
|
/// <reference path='../../../../src/vs/vscode.d.ts'/>
|
||||||
|
/// <reference path='../../../../src/typings/mocha.d.ts'/>
|
||||||
|
/// <reference path='../../../../extensions/declares.d.ts'/>
|
||||||
|
/// <reference path='../../../../extensions/node.d.ts'/>
|
||||||
|
/// <reference path='../../../../extensions/lib.core.d.ts'/>
|
18
extensions/git/test/extension.test.ts
Normal file
18
extensions/git/test/extension.test.ts
Normal file
|
@ -0,0 +1,18 @@
|
||||||
|
/*---------------------------------------------------------------------------------------------
|
||||||
|
* Copyright (c) Microsoft Corporation. All rights reserved.
|
||||||
|
* Licensed under the MIT License. See License.txt in the project root for license information.
|
||||||
|
*--------------------------------------------------------------------------------------------*/
|
||||||
|
|
||||||
|
// import * as assert from 'assert';
|
||||||
|
// import * as vscode from 'vscode';
|
||||||
|
// import * as myExtension from '../src/extension';
|
||||||
|
|
||||||
|
// Defines a Mocha test suite to group tests of similar kind together
|
||||||
|
// suite("Extension Tests", () => {
|
||||||
|
|
||||||
|
// // Defines a Mocha unit test
|
||||||
|
// test("Something 1", () => {
|
||||||
|
// assert.equal(-1, [1, 2, 3].indexOf(5));
|
||||||
|
// assert.equal(-1, [1, 2, 3].indexOf(0));
|
||||||
|
// });
|
||||||
|
// });
|
13
extensions/git/test/index.ts
Normal file
13
extensions/git/test/index.ts
Normal file
|
@ -0,0 +1,13 @@
|
||||||
|
/*---------------------------------------------------------------------------------------------
|
||||||
|
* Copyright (c) Microsoft Corporation. All rights reserved.
|
||||||
|
* Licensed under the MIT License. See License.txt in the project root for license information.
|
||||||
|
*--------------------------------------------------------------------------------------------*/
|
||||||
|
|
||||||
|
const testRunner = require('vscode/lib/testrunner');
|
||||||
|
|
||||||
|
testRunner.configure({
|
||||||
|
ui: 'tdd',
|
||||||
|
useColors: true
|
||||||
|
});
|
||||||
|
|
||||||
|
module.exports = testRunner;
|
16
extensions/git/tsconfig.json
Normal file
16
extensions/git/tsconfig.json
Normal file
|
@ -0,0 +1,16 @@
|
||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"module": "commonjs",
|
||||||
|
"target": "es6",
|
||||||
|
"outDir": "out",
|
||||||
|
"lib": [
|
||||||
|
"es6"
|
||||||
|
],
|
||||||
|
"sourceMap": true,
|
||||||
|
"rootDir": "."
|
||||||
|
},
|
||||||
|
"exclude": [
|
||||||
|
"node_modules",
|
||||||
|
".vscode-test"
|
||||||
|
]
|
||||||
|
}
|
33
extensions/git/vsc-extension-quickstart.md
Normal file
33
extensions/git/vsc-extension-quickstart.md
Normal file
|
@ -0,0 +1,33 @@
|
||||||
|
# Welcome to your first VS Code Extension
|
||||||
|
|
||||||
|
## What's in the folder
|
||||||
|
* This folder contains all of the files necessary for your extension
|
||||||
|
* `package.json` - this is the manifest file in which you declare your extension and command.
|
||||||
|
The sample plugin registers a command and defines its title and command name. With this information
|
||||||
|
VS Code can show the command in the command palette. It doesn’t yet need to load the plugin.
|
||||||
|
* `src/extension.ts` - this is the main file where you will provide the implementation of your command.
|
||||||
|
The file exports one function, `activate`, which is called the very first time your extension is
|
||||||
|
activated (in this case by executing the command). Inside the `activate` function we call `registerCommand`.
|
||||||
|
We pass the function containing the implementation of the command as the second parameter to
|
||||||
|
`registerCommand`.
|
||||||
|
|
||||||
|
## Get up and running straight away
|
||||||
|
* press `F5` to open a new window with your extension loaded
|
||||||
|
* run your command from the command palette by pressing (`Ctrl+Shift+P` or `Cmd+Shift+P` on Mac) and typing `Hello World`
|
||||||
|
* set breakpoints in your code inside `src/extension.ts` to debug your extension
|
||||||
|
* find output from your extension in the debug console
|
||||||
|
|
||||||
|
## Make changes
|
||||||
|
* you can relaunch the extension from the debug toolbar after changing code in `src/extension.ts`
|
||||||
|
* you can also reload (`Ctrl+R` or `Cmd+R` on Mac) the VS Code window with your extension to load your changes
|
||||||
|
|
||||||
|
## Explore the API
|
||||||
|
* you can open the full set of our API when you open the file `node_modules/vscode/vscode.d.ts`
|
||||||
|
|
||||||
|
## Run tests
|
||||||
|
* open the debug viewlet (`Ctrl+Shift+D` or `Cmd+Shift+D` on Mac) and from the launch configuration dropdown pick `Launch Tests`
|
||||||
|
* press `F5` to run the tests in a new window with your extension loaded
|
||||||
|
* see the output of the test result in the debug console
|
||||||
|
* make changes to `test/extension.test.ts` or create new test files inside the `test` folder
|
||||||
|
* by convention, the test runner will only consider files matching the name pattern `**.test.ts`
|
||||||
|
* you can create folders inside the `test` folder to structure your tests any way you want
|
Loading…
Reference in a new issue