Pijul for VS Code
** Experimental ! **
Pijul is a distributed version control system that is easy to learn and use. This experimental beta-version extension provides access from VS Code to the essential features of Pijul:
- Add, Reset, or Record one, some, or all of the files in the Pijul Repository.
- Decorations in the file tree indicating the current state of each file.
- VS Code comparison integration for diffing working files with their last recorded versions.
- Basic views for the change log and the channels.
Other operations need to be done using Pijul’s command line interface in a terminal.
Installation
This extension is available in VS Code marketplace. It requires Pijul.
To install Pijul,:
- Install pijul (Tested with 1.0.0-beta.9)
- Make sure that pijul is in the PATH:
pijul --version - Create an identity:
pijul identity new
To activate Pijul version control in a folder, run pijul init in the folder.
Feedback on this extension is welcome on Zulip.
Contributing
Pijul for VS Code welcomes all contributions. Areas of development include:
- make all Pijul commands available from VS Code
- properly handle move and deletion of files
- show diff for past changes
To set-up your environment for the development of a VS Code Extension:
- Install Node, e.g., using nvm:
nvm install node
- Install dependencies
npm install -gD yo generator-code yarn webpack webpack-cli ts-loader
npm install --global @vscode/vsce
yarn
- clone this repository:
pijul clone https://nest.pijul.com/pcarbonn/pijul-vscode
cd pijul-vscode
- Add the following hook to your Pijul config file for linting:
[hooks]
record = ["yarn run lint"]
- create a channel for your changes (not
main)
pijul fork <your name>
- test and build this extension, as in this example.
To submit your change:
-
create an account on The Nest
-
send me a message to request access to my repository in this discussion
-
create an SSH key if you don’t have one yet, and note where it is stored (e.g.
~/.ssh/id_rsa.pub) -
copy your public SSH key to The Nest (possibly use
cat ~/.ssh/id_rsa.pubto view it) -
push your change:
pijul push pcarbonn@ssh.pijul.com:pcarbonn/pijul-vscode -
alert me of your submission in this discussion