git-source-track
================
This is a tool that makes it easier to track source code changes between two
repositories. This tool was originally developed for use by the RobotPy project,
and made it easier for me to maintain a python port of various Java libraries.
This tool assumes there is an 'original' git repository, and a 'destination' git
repository that is being validated. There is assumed a one to one relationship
between various original and destination files. This tool provides quick and
easy shortcuts to allow you to record metadata in the destination files that
allow you to track changes in the source files:
* Record which file it comes from
* Mark the latest manually verified revision in the destination
* Allow viewing the latest modifications to the source file (if any)
* Update the revision metadata in the destination file
Install
-------
::
pip install git-source-track
Configuration
-------------
Create a file called '.gittrack' in the root of the destination git repository
that has the following ini-style format::
[git-source-track]
# Original files
upstream_root = ../path/to/files
# Commit in original repository
upstream_commit = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# Files that are being validated
validation_root = path/to_files
# (optional) Commits to exclude from git log output
exclude_commits_file = foo/exclude_commits.txt
# (optional) Specify location to place validation line (first or last)
default_location = first
# (optional) Primary branch of upstream repository
upstream_branch = main
Now you can issue git commands and magic will happen!
Usage
-----
See the help command for more information.
::
$ git source-track help
Known issues
------------
* Tool mostly tested using Python 3, but should work on Python 2
* Probably won't work on Windows, due to the use of the 'sh' package and because
there are dependencies on unix-style tools
* May work in Windows 10 posix environment
* Assumes destination files are python files
* Emits python style comments on destination files
Pull requests are welcome to fix any of these problems. :)
Author
------
Dustin Spicuzza (dustin@virtualroadside.com)
Raw data
{
"_id": null,
"home_page": "https://github.com/virtuald/git-source-track",
"name": "git-source-track",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Dustin Spicuzza",
"author_email": "dustin@virtualroadside.com",
"download_url": "https://files.pythonhosted.org/packages/f3/14/bb100fee38c2eb2fe716eb2bb641779ee3a77ef76f1a485d73b1aa7a038a/git_source_track-0.4.1.tar.gz",
"platform": null,
"description": "git-source-track\n================\n\nThis is a tool that makes it easier to track source code changes between two\nrepositories. This tool was originally developed for use by the RobotPy project,\nand made it easier for me to maintain a python port of various Java libraries.\n\nThis tool assumes there is an 'original' git repository, and a 'destination' git\nrepository that is being validated. There is assumed a one to one relationship\nbetween various original and destination files. This tool provides quick and\neasy shortcuts to allow you to record metadata in the destination files that\nallow you to track changes in the source files:\n\n* Record which file it comes from\n* Mark the latest manually verified revision in the destination\n* Allow viewing the latest modifications to the source file (if any)\n* Update the revision metadata in the destination file\n\nInstall\n-------\n\n::\n\n pip install git-source-track\n\nConfiguration\n-------------\n\nCreate a file called '.gittrack' in the root of the destination git repository\nthat has the following ini-style format::\n \n [git-source-track]\n \n # Original files\n upstream_root = ../path/to/files\n \n # Commit in original repository\n upstream_commit = xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\n \n # Files that are being validated \n validation_root = path/to_files\n \n # (optional) Commits to exclude from git log output\n exclude_commits_file = foo/exclude_commits.txt\n\n # (optional) Specify location to place validation line (first or last)\n default_location = first\n\n # (optional) Primary branch of upstream repository\n upstream_branch = main\n\nNow you can issue git commands and magic will happen!\n\nUsage\n-----\n\nSee the help command for more information.\n\n::\n \n $ git source-track help\n\nKnown issues\n------------\n\n* Tool mostly tested using Python 3, but should work on Python 2\n* Probably won't work on Windows, due to the use of the 'sh' package and because\n there are dependencies on unix-style tools\n * May work in Windows 10 posix environment\n* Assumes destination files are python files\n* Emits python style comments on destination files\n\nPull requests are welcome to fix any of these problems. :)\n\nAuthor\n------\n\nDustin Spicuzza (dustin@virtualroadside.com)\n\n",
"bugtrack_url": null,
"license": "Apache 2.0",
"summary": "Track changes between two git repositories",
"version": "0.4.1",
"project_urls": {
"Homepage": "https://github.com/virtuald/git-source-track"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "09063909d5d532c1aebcdb378be1b3d5ad396868627b3f141af53c9255c74300",
"md5": "3b78daeea26289eb6470c283465d16ad",
"sha256": "572caaa35ce5d1567d9edcec1d7aa82d322c4dbb5b619fb4aa7f7ec82cea0952"
},
"downloads": -1,
"filename": "git_source_track-0.4.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "3b78daeea26289eb6470c283465d16ad",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 15386,
"upload_time": "2024-10-01T16:11:44",
"upload_time_iso_8601": "2024-10-01T16:11:44.919590Z",
"url": "https://files.pythonhosted.org/packages/09/06/3909d5d532c1aebcdb378be1b3d5ad396868627b3f141af53c9255c74300/git_source_track-0.4.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f314bb100fee38c2eb2fe716eb2bb641779ee3a77ef76f1a485d73b1aa7a038a",
"md5": "efebc27919ff0e190328be73b71d2aa1",
"sha256": "9c65c5307bae6c742d107ce4331221fad78058011db38961df2e47d87502b587"
},
"downloads": -1,
"filename": "git_source_track-0.4.1.tar.gz",
"has_sig": false,
"md5_digest": "efebc27919ff0e190328be73b71d2aa1",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 15297,
"upload_time": "2024-10-01T16:11:46",
"upload_time_iso_8601": "2024-10-01T16:11:46.335384Z",
"url": "https://files.pythonhosted.org/packages/f3/14/bb100fee38c2eb2fe716eb2bb641779ee3a77ef76f1a485d73b1aa7a038a/git_source_track-0.4.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-01 16:11:46",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "virtuald",
"github_project": "git-source-track",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "git-source-track"
}
JSON
