Keep your repositories up-to-date all the time.
Project description
# Fork Syncer – Fsyncer
[![Build Status](https://travis-ci.org/Skarlso/fsyncer.svg?branch=master)](https://travis-ci.org/Skarlso/fsyncer)
This is a small python application to keep all your remote forks up-to-date.
# Usage
## Installing
`bash pip install fsyncer `
## Running
From a cron job for example which runs every day / week / month…
`bash export FSYNC_GITHUB_TOKEN=<github_token_with_repo_access_scope> fsyncer `
## Filter Repositories
It’s possible to provide a list of repositories that Fsyncer should deal with. In that case, the list of forks will be filtered down to the provided list. That files location is ~/.config/fsyncer/.repo_list.
Example:
` my_awesome_repo my_other_awesome_repo and_sync_this_one `
In this case if there are other repositories for that user, they will all be ignored and only these three will be synced.
# Requirements
Fsynver runs git in the background on the given environment. If the installed git can push to a repository then so can Fsyncer. Hence the requirement is only to have a valid git client with properly set up credentials.
fsyncer also requires a token to be present on the current machine to gather data, like remote forks and username.
This environment property is FSYNC_GITHUB_TOKEN.
# Restrictions
Only forks can be updated which can be fast forwarded for now. Fsyncer will not try to do git magic or trying to resolve merge conflicts. If the push doesn’t work, it will skip that repository and move on to the next one.
# Future
Future plans include:
Creating a cron job with an optional parameter for the current user
Documentation
Support other VCSs
# Contributions
Are always welcomed.
Project details
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
Hashes for fsyncer-1.0.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a5c5f6b8b92292861a93473cb74b824800b7f51f78ac176e95a8628f7efdbcd6 |
|
MD5 | 7aa548bedec4b1fa6752ca76de6d0691 |
|
BLAKE2b-256 | 75a2f9571d59f5636cd37bbef1ebe84987eb5fc59244ead916aff743117cd194 |