Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/anthraxx/arch-svn-package-to-git
https://github.com/anthraxx/arch-svn-package-to-git
Last synced: about 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/anthraxx/arch-svn-package-to-git
- Owner: anthraxx
- Created: 2016-11-26T21:41:00.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2023-05-19T12:02:25.000Z (over 1 year ago)
- Last Synced: 2024-05-10T00:05:19.925Z (8 months ago)
- Language: Python
- Size: 123 KB
- Stars: 9
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Arch Linux svn package to git converter
=======================================
Simple script that converts a git-svn checkout of a whole svn repository to
separated per package git repositories. Additionally it performs some garbage
collection and history/content rewrite.
### Requirements:
- Python 3.8
- git
- git-filter-repo
- bash
- findutils
- coreutils
- diffutils
- grep
### Rewrites:
- Replace author name and e-mail via `AUTHORS` file
- Strip git-svn related git-svn-id from commit messages
- Strip svn specific $Id$ property
- Filters unwanted artifacts like tarballs, logfiles etc
- Tag all repository releases
- Produce readable shortlog commit messages if possible
### GitSVN checkout:
The gitsvn checkout must be a bare clone that is setup as a mirror in order
to make single branch cloning work appropriately and be able to easily fetch
all branch related refs from the remote.
The clone command can be used for a fresh clone:
```
gitsvn-repo-helper clone community
```
Optionally a target directory can be specified:
```
gitsvn-repo-helper clone packages /tmp/bare-packages
```
Otherwise an existing clone needs to have to following git config:
```
[remote "origin"]
url = https://github.com/archlinux/svntogit-community
fetch = +refs/*:refs/*
mirror = true
```
The gitsvn-repo-helper can aid in setting the require config:
```
gitsvn-repo-helper configure repos/community
```
### Usage:
gitsvn2git INPUT_GIT TARGET_DIR [PACKAGE]...
### Arguments:
- `INPUT_GIT [DIRECTORY]`
**synopsis:** Set the input directory of the git-svn bare repository checkout
**required:** Yes
- `TARGET_DIR [DIRECTORY]`
**synopsis:** Set the target directory where the repositories will be created
**required:** Yes
- `PACKAGE [STRING]...`
**synopsis:** Set the packages that should be converted to separate git repositories. In case `--update` is the only passed value, fetch the `INPUT_GIT` repository and sequencially convert all updated packages.
**default:** All packages of the specified input repository
### Environment variables:
- `GITSVN2GIT_BREAKPOINT_ON_ERROR`
**synopsis:** If set, invoke an interactive source code debugger for investigation
- `GITSVN2GIT_DEBUG`
**synopsis:** If set, print debug messages during execution
- `GITSVN2GIT_PEDANTIC`
**synopsis:** If set, treat some warnings like missing release tags as errors. Useful in combination with `GITSVN2GIT_BREAKPOINT_ON_ERROR` for debugging.
- `GITSVN2GIT_WERROR`
**synopsis:** If set, treat all warnings as errors. Useful in combination with `GITSVN2GIT_BREAKPOINT_ON_ERROR` for debugging.
### Examples:
##### Whole repository:
gitsvn2git repos/community community-converted
##### Specific packages:
gitsvn2git repos/community community-converted capstone radare2
##### Parallelize:
parallel --bar gitsvn2git repos/community community-converted ::: repos/community/*
parallel --bar gitsvn2git repos/community community-converted ::: $(gitsvn-repo-helper list repos/community)
##### Fetch source repo and re-convert all updated packages:
gitsvn2git repos/community community-converted --update
gitsvn-repo-helper fetch --list repos/community | parallel --no-run-if-empty --bar gitsvn2git repos/community community-converted
##### List bare clone packages:
gitsvn-repo-helper list repos/community
##### List bare clone package changes since last fetch:
gitsvn-repo-helper since bec4565de repos/community
##### Fetch bare clone repo and print previous HEAD:
gitsvn-repo-helper fetch repos/community
##### Fetch bare clone repo and print changed packages:
gitsvn-repo-helper fetch --list repos/community
##### Fresh clone of the community repo:
gitsvn-repo-helper clone community
##### Clean up old converted packages that were removed from the repos:
gitsvn-repo-helper clean repos/packages/ repos/svntogit/community/ repos/svntogit/packages/