| Name | easy-mirrors JSON |
| Version |
0.3.2
JSON |
| download |
| home_page | None |
| Summary | Simplest way to backup and restore git repositories |
| upload_time | 2025-11-05 19:50:44 |
| maintainer | None |
| docs_url | None |
| author | Vladislav Punko |
| requires_python | <4.0,>=3.10 |
| license | MIT |
| keywords |
automation
git
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# easy-mirrors
Simplest way to back up and restore git repositories.
## Installation
Ensure that [git](https://git-scm.com/) is installed on your system.
Use the package manager [pip](https://pip.pypa.io/en/stable/) to install `easy-mirrors` along with its command-line interface by running:
```bash
python3 -m pip install --user easy-mirrors
```
## Basic usage
This program enables you to mirror your git repositories to a backup destination.
> **Warning:**
> Ensure that git is correctly configured and that you have access to the repositories you intend to mirror before starting.
> This guarantees a smooth backup process and safeguards your valuable data.
Create a configuration file named `easy_mirrors.ini` in your home directory containing the following content:
```ini
[easy_mirrors]
path = /tmp/repositories
repositories =
https://github.com/vladpunko/easy-mirrors.git
```
Use the following commands to mirror and restore your repository:
```bash
# Step -- 1.
easy-mirrors --period 30 # make mirrors every 30 minutes
# Step -- 2.
cd /tmp/repositories/easy-mirrors.git
# Step -- 3.
git push --mirror https://github.com/vladpunko/easy-mirrors.git
```
## Contributing
Pull requests are welcome.
Please open an issue first to discuss what should be changed.
Please make sure to update tests as appropriate.
```bash
# Step -- 1.
python3 -m venv .venv && source ./.venv/bin/activate && pip install pre-commit tox
# Step -- 2.
pre-commit install --config .githooks.yml
# Step -- 3.
tox && tox -e lint
```
## License
[MIT](https://choosealicense.com/licenses/mit/)
Raw data
{
"_id": null,
"home_page": null,
"name": "easy-mirrors",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.10",
"maintainer_email": null,
"keywords": "automation, git",
"author": "Vladislav Punko",
"author_email": "iam.vlad.punko@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/cb/92/af0ba56a43cdcc325d035fca90eb640a8473c04b3f406fd2c01efdfd19f7/easy_mirrors-0.3.2.tar.gz",
"platform": null,
"description": "# easy-mirrors\n\n\n\n\nSimplest way to back up and restore git repositories.\n\n## Installation\n\nEnsure that [git](https://git-scm.com/) is installed on your system.\n\nUse the package manager [pip](https://pip.pypa.io/en/stable/) to install `easy-mirrors` along with its command-line interface by running:\n\n```bash\npython3 -m pip install --user easy-mirrors\n```\n\n## Basic usage\n\nThis program enables you to mirror your git repositories to a backup destination.\n\n> **Warning:**\n> Ensure that git is correctly configured and that you have access to the repositories you intend to mirror before starting.\n> This guarantees a smooth backup process and safeguards your valuable data.\n\nCreate a configuration file named `easy_mirrors.ini` in your home directory containing the following content:\n\n```ini\n[easy_mirrors]\npath = /tmp/repositories\nrepositories =\n https://github.com/vladpunko/easy-mirrors.git\n```\n\nUse the following commands to mirror and restore your repository:\n\n```bash\n# Step -- 1.\neasy-mirrors --period 30 # make mirrors every 30 minutes\n\n# Step -- 2.\ncd /tmp/repositories/easy-mirrors.git\n\n# Step -- 3.\ngit push --mirror https://github.com/vladpunko/easy-mirrors.git\n```\n\n## Contributing\n\nPull requests are welcome.\nPlease open an issue first to discuss what should be changed.\n\nPlease make sure to update tests as appropriate.\n\n```bash\n# Step -- 1.\npython3 -m venv .venv && source ./.venv/bin/activate && pip install pre-commit tox\n\n# Step -- 2.\npre-commit install --config .githooks.yml\n\n# Step -- 3.\ntox && tox -e lint\n```\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Simplest way to backup and restore git repositories",
"version": "0.3.2",
"project_urls": {
"Issue tracker": "https://github.com/vladpunko/easy-mirrors/issues",
"Source code": "https://github.com/vladpunko/easy-mirrors"
},
"split_keywords": [
"automation",
" git"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "074d5504f4171e4e85b2e00184f8a31d7ba81b8a497d2df88c45e59be00c1334",
"md5": "9879715b72027a39401d8e7b7eeb30df",
"sha256": "7ab73aa3a3ff4795e67c9a0016df6e0c116c928ee79bf71b09f3db8c04a558f8"
},
"downloads": -1,
"filename": "easy_mirrors-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "9879715b72027a39401d8e7b7eeb30df",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.10",
"size": 12864,
"upload_time": "2025-11-05T19:50:43",
"upload_time_iso_8601": "2025-11-05T19:50:43.483595Z",
"url": "https://files.pythonhosted.org/packages/07/4d/5504f4171e4e85b2e00184f8a31d7ba81b8a497d2df88c45e59be00c1334/easy_mirrors-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "cb92af0ba56a43cdcc325d035fca90eb640a8473c04b3f406fd2c01efdfd19f7",
"md5": "97730ed25478ec15694894119e792de5",
"sha256": "7f7530c5d130334cee361e9ea8ed41957d5e2cc7cc887ccd7c8a612981cf5677"
},
"downloads": -1,
"filename": "easy_mirrors-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "97730ed25478ec15694894119e792de5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.10",
"size": 10168,
"upload_time": "2025-11-05T19:50:44",
"upload_time_iso_8601": "2025-11-05T19:50:44.352392Z",
"url": "https://files.pythonhosted.org/packages/cb/92/af0ba56a43cdcc325d035fca90eb640a8473c04b3f406fd2c01efdfd19f7/easy_mirrors-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-11-05 19:50:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "vladpunko",
"github_project": "easy-mirrors",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "easy-mirrors"
}
