A language-agnostic dependency manager using Git.
Project description
Getting Started
GitMan is a language-agnostic “dependency manager” using Git. It aims to serve as a submodules replacement and provides advanced options for managing versions of nested Git repositories.
Requirements
Python 3.5+
Git 1.8+ (with stored credentials)
Unix shell (or Cygwin/MinGW/etc. on Windows)
Installation
GitMan can be installed with pip:
$ pip install gitmanor directly from the source code:
$ git clone https://github.com/jacebrowning/gitman.git
$ cd gitman
$ python setup.py installSetup
Create a configuration file (gitman.yml or .gitman.yml) in the root of your working tree:
location: vendor
sources:
- name: framework
repo: https://github.com/kstenerud/iOS-Universal-Framework
rev: Mk5-end-of-life
- name: coverage
repo: https://github.com/jonreid/XcodeCoverage
rev: master
link: Tools/XcodeCoverageIgnore the dependency storage location:
$ echo vendor >> .gitignoreBasic Usage
See the available commands:
$ gitman --helpUpdating Dependencies
Get the latest versions of all dependencies:
$ gitman updatewhich will essentially:
create a working tree at root/location/name
fetch from repo and checkout the specified rev
symbolically link each location/name from root/link (if specified)
repeat for all nested working trees containing a configuration file
record the actual commit SHAs that were checked out (with --lock option)
where rev can be:
all or part of a commit SHA: 123def
a tag: v1.0
a branch: master
a rev-parse date: 'develop@{2015-06-18 10:30:59}'
Restoring Previous Versions
Display the specific revisions that are currently installed:
$ gitman listReinstall these specific versions at a later time:
$ gitman installDeleting Dependencies
Remove all installed dependencies:
$ gitman uninstallAdvanced Options
See the full documentation at git-dependency-manager.info.
Revision History
1.0 (2016/05/22)
Initial stable release.
0.11 (2016/05/10)
Removed dependency on sh to support Cygwin/MinGW/etc. on Windows.
Dropped Python 3.4 support for subprocess and *args improvements.
BREAKING: Renamed config file key dir to name.
0.10 (2016/04/14)
Added show command to display dependency and internal paths.
0.9 (2016/03/31)
Added edit command to launch the configuration file.
Depth now defaults to 5 to prevent infinite recursion.
Fixed handling of source lists containing different dependencies.
0.8.3 (2016/03/14)
Renamed to GitMan.
0.8.2 (2016/02/24)
Updated to YORM v0.6.
0.8.1 (2016/01/21)
Added an error message when attempting to lock invalid repositories.
0.8 (2016/01/13)
Switched to using repository mirrors to speed up cloning.
Disabled automatic fetching on install.
Added --fetch option on install to always fetch.
Now displaying git status output when there are changes.
0.7 (2015/12/22)
Fixed git remote rm command (@hdnivara).
Now applying the update dependency filter to locking as well.
Now only locking previous locked dependencies.
Added lock command to manually save all dependency versions.
Now requiring --lock option on update to explicitly lock dependencies.
0.6 (2015/11/13)
Added the ability to filter the dependency list on install and update.
Added --depth option to limit dependency traversal on install, update, and list.
0.5 (2015/10/20)
Added Git plugin support via: git deps.
Removed --no-clean option (now the default) on install and update.
Added --clean option to delete ignored files on install and update.
Switched to install rather than update of nested dependencies.
Added --all option on update to update all nested dependencies.
Disabled warnings when running install without locked sources.
Added --no-lock option to disable version recording.
0.4.2 (2015/10/18)
Fixed crash when running with some sources missing.
0.4.1 (2015/09/24)
Switched to cloning for initial working tree creation.
0.4 (2015/09/18)
Replaced install command with update.
Updated install command to use locked dependency versions.
Now sorting sources after a successful update.
Now requiring --force to uninstall with uncommitted changes.
Updated list command to show full shell commands.
0.3.1 (2015/09/09)
Ensures files are not needlessly reloaded with newer versions of YORM.
0.3 (2015/06/26)
Added --no-clean option to disable removing untracked files.
Added support for rev-parse dates as the dependency rev.
0.2.5 (2015/06/15)
Added --quiet option to hide warnings.
0.2.4 (2015/05/19)
Now hiding YORM logging bellow warnings.
0.2.3 (2015/05/17)
Upgraded to YORM v0.4.
0.2.2 (2015/05/04)
Specified YORM < v0.4.
0.2.1 (2015/03/12)
Added automatic remote branch tracking in dependencies.
Now requiring --force when there are untracked files.
0.2 (2015/03/10)
Added list command to display current URLs/SHAs.
0.1.4 (2014/02/27)
Fixed an outdated index when checking for changes.
0.1.3 (2014/02/27)
Fixed extra whitespace when logging shell output.
0.1.2 (2014/02/27)
Added --force argument to:
overwrite uncommitted changes
create symbolic links in place of directories
Added live shell command output with -vv argument.
0.1 (2014/02/24)
Initial release.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file GitMan-1.0.tar.gz.
File metadata
- Download URL: GitMan-1.0.tar.gz
- Upload date:
- Size: 32.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c427970642377215a97882b57e89416017d6a5b240a131d4a2eb3ee1bb093fdc |
|
| MD5 | 148ecabca9d507be57540b3abad6ad5e |
|
| BLAKE2b-256 | 6f4adc125bdcc36d98c734b85e725dbcda981878dba0a8d8a71b13fd7fc0c0f4 |
File details
Details for the file GitMan-1.0-py3-none-any.whl.
File metadata
- Download URL: GitMan-1.0-py3-none-any.whl
- Upload date:
- Size: 36.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 69a827bc7cce228b16fe7d942dbfb64f27e0d7e55e957982df74f3a9fc207872 |
|
| MD5 | e3782937ea7d3abc5af4edc98fd6b75f |
|
| BLAKE2b-256 | 55ae115928ce0ae768b68f3d76508070b23c6ed6ecc5a8ea8f4b723645e1a3ff |
