https://github.com/jdalrymple/node-hg-plus
A node js client for Mercurial
https://github.com/jdalrymple/node-hg-plus
gitify hg mercurial node-hg nodejs
Last synced: 8 months ago
JSON representation
A node js client for Mercurial
- Host: GitHub
- URL: https://github.com/jdalrymple/node-hg-plus
- Owner: jdalrymple
- License: other
- Created: 2016-12-26T19:54:15.000Z (about 9 years ago)
- Default Branch: master
- Last Pushed: 2023-01-12T08:22:35.000Z (almost 3 years ago)
- Last Synced: 2025-05-07T23:04:14.194Z (8 months ago)
- Topics: gitify, hg, mercurial, node-hg, nodejs
- Language: JavaScript
- Homepage:
- Size: 8.46 MB
- Stars: 2
- Watchers: 1
- Forks: 4
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
[](https://coveralls.io/github/jdalrymple/node-hg-plus?branch=master) [](https://travis-ci.org/jdalrymple/node-hg-plus) [](https://david-dm.org/jdalrymple/node-test#info=dependencies) [](https://david-dm.org/jdalrymple/node-test#info=devDependencies)[](https://codeclimate.com/github/jdalrymple/node-hg-plus)[](https://opensource.org/licenses/MIT) [](https://greenkeeper.io/)
# node-hg-plus
A node js client for [Mercurial](http://mercurial.selenic.com). Supports both Async/Await/Promises and Standard callbacks.
Supported node version => 7.6.0
# Table of Contents
* [Install](#install)
* [Usage](#usage)
* [Docs](#docs)
* [Hg](https://github.com/jdalrymple/node-hg-plus/blob/master/docs/hg.md)
* [HgRepo](https://github.com/jdalrymple/node-hg-plus/blob/master/docs/hgrepo.md)
* [License](#licence)
* [Changelog](#changelog)
# Install
```bash
# Install from npm
npm install -S hg-plus
```
To use the gitify function, you must also have python2.7.x, git as well as the shipped gitifyhg python addon installed.
To install the addon simply run:
```bash
cd node_modules/hg-plus/utils/gitifyhg/
python2.7 setup.py install
```
Note this feature currently has mixed results on windows. Working on fixing that functionality for the next release.
# Usage
### Basic
```javascript
// Initialize with default python path ('python')
const Hg = require('hg-plus')();
// Clone a repo using only the url string
let repo = await Hg.clone('http://hostname.com/my/repository/url')
await repo.add()
await repo.commit('my example commit')
await repo.push({ password: 'myPassword', username: 'username' })
```
### Create and push a repository
```javascript
const Hg = require('hg-plus')();
let to = {
url: 'http://hostname.com/my/repository/url',
username: 'me@host.com',
password: 'secret'
}
let repo = await Hg.create(to);
await repo.push()
```
### Cloning from multiple repositories into a new one
```javascript
const Hg = require('hg-plus')();
let to = {
url: 'http://hostname.com/my/repository/url'
}
let from = [
'http://hostname.com/my/repository/url1',
'http://hostname.com/my/repository/url2',
'http://hostname.com/my/repository/url3'
]
let repo = await Hg.clone(from, to);
await repo.commit('I just created a repository from three other repositories!')
await repo.push({
username: 'me@host.com',
password: 'secret'
})
```
### Hg to Git conversion caveats
This functionality is still in development. There are a few issues that arise if for example, there are conflicting branches during
the clean processing. Before merging repositories, ensure that the branch names(besides default) do not conflict. If it errors out for you, try running the conversion without the clean option.
# Tests
Ensure to install the gitifyhg library as outlined at the beginning of this README then
make sure to change the global variable in tests/HgRepo called pythonPath to be a valid
path to your python2.7.x installation. Then run:
```javascript
npm test
```
# LICENSE
[MIT](http://opensource.org/licenses/MIT), No Attribution Required, Copyright 2016 Justin Dalrymple
# Changelog
[1.2.3](https://github.com/jdalrymple/node-hg-plus/tags/1.2.3) (2018-4-29)
------------------
- Updating library dependencies
[1.2.2](https://github.com/jdalrymple/node-hg-plus/df3359e8c5a42ae0e80c042a6b342949e831367a) (2017-10-29)
------------------
- Added Checkout alias for hg update
- Added branch specification for hg update
- Updating library dependencies
[1.2.1](https://github.com/jdalrymple/node-hg-plus/93c85be35072e774cf9f8ffa4b2c9caeac8bca76) (2017-10-29)
------------------
- Updating error messages for the creation of hg repositories
- Updating Hg.getRepo to return the correct remote url in the HgRepo instance
- Added HgRepo.paths()
[1.2.0](https://github.com/jdalrymple/node-hg-plus/4a7dbff90189e015a1b35e3f53e63c4ce799c12d) (2017-10-03)
------------------
- Adding Hg.Indentify from [kfirprods](https://github.com/kfirprods)'s [pull request](https://github.com/jdalrymple/node-hg-plus/pull/6)
- Updated docs
[1.1.0](https://github.com/jdalrymple/node-hg-plus/840b1b4f25591c1191b70397067d007e9367e87c) (2017-08-29)
------------------
- Renamed the Hg.gitify function `gitRepoPath` parameter to be just `path`
- Made HgRepo objects gitify function take in an object with a output path, `path`, a remoteURL option, an option to track
all of the git branches after the conversion, and an option to clean the git branch names during conversion
- Major updates the the gitifyhg library
[1.0.2](https://github.com/jdalrymple/node-hg-plus/ebecd5632bc762530b4bd796090ab4ed09c6cc56) (2017-07-30)
------------------
- Adding Hg.getRepo, which allows users to get an HgRepo instance from a existing mercurial repository. [Merge pull request #5 from 52linyuepeng/master](https://github.com/jdalrymple/node-hg-plus/26eaecf4e231a55c1fe1d4634fad3d255d79e1fc)
[1.0.1](https://github.com/jdalrymple/node-hg-plus/commit/510e70a4fff5bec35e2489c5228748e330559c87) (2017-07-26)
------------------
- Removed the .hgtags and hg folders from the gitified repo
- Rename .hgignore to be .gitignore and removing 'syntax*' line from the .gitignore file
[1.0.0](https://github.com/jdalrymple/node-hg-plus/commit/5d54b5e8871c13427f8bf2faaa296576952809c4) (2017-07-25)
------------------
- Cleaned up old promise logic and replaced with async/await
- Removed useless rest param arguments from many of the Hg functions for clarity
- Added Object input to the Hg.Clone function (See API Docs above)
- Cleaned up folder structure
- Fixed the setting of the default url if none is passed in by the user
- Fixed cloning from urls instead of local paths
- Added various callback tests to ensure the callback backwards compatibility is maintained
- Added default state tests for the HgRepo Object
- Removed old dependencies now that Promises are more widely supported
- Standardized the callback support to return in the form callback(error, results) always
NOTE: Upgrading from 0.8.0 to 1.0 will break your project. Ensure to add the function call to your require statement - require('hg-plus')()