{"id":13845308,"url":"https://github.com/ynikitenko/yarsync","last_synced_at":"2025-03-17T14:18:12.936Z","repository":{"id":37608668,"uuid":"338397820","full_name":"ynikitenko/yarsync","owner":"ynikitenko","description":"Yet Another Rsync: a file synchronization and backup tool","archived":false,"fork":false,"pushed_at":"2025-02-05T12:06:40.000Z","size":497,"stargazers_count":38,"open_issues_count":7,"forks_count":4,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-03T03:24:14.645Z","etag":null,"topics":["administration-tools","backup","linux","mirroring","rsync-wrapper","synchronization","unix"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ynikitenko.png","metadata":{"files":{"readme":"README.rst","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-02-12T18:17:09.000Z","updated_at":"2025-02-11T05:59:35.000Z","dependencies_parsed_at":"2023-11-09T15:40:41.695Z","dependency_job_id":"863ba9e0-e987-47bb-ae09-158de9a3bd1f","html_url":"https://github.com/ynikitenko/yarsync","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ynikitenko%2Fyarsync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ynikitenko%2Fyarsync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ynikitenko%2Fyarsync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ynikitenko%2Fyarsync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ynikitenko","download_url":"https://codeload.github.com/ynikitenko/yarsync/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243763224,"owners_count":20344187,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["administration-tools","backup","linux","mirroring","rsync-wrapper","synchronization","unix"],"created_at":"2024-08-04T17:03:19.656Z","updated_at":"2025-03-17T14:18:12.927Z","avatar_url":"https://github.com/ynikitenko.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"=======\nYARsync\n=======\n\nYet Another Rsync is a file synchronization and backup tool.\nIt can be used to synchronize data between different hosts\nor locally (for example, to a backup drive).\nIt provides a familiar ``git`` command interface while working with files.\n\nYARsync is a Free Software project covered by the GNU General Public License version 3.\n\n-------------\nInstallation\n-------------\n``yarsync`` is packaged for Debian/Ubuntu.\n\nFor Arch Linux, install the ``yarsync`` package `from AUR \u003chttps://aur.archlinux.org/packages/yarsync\u003e`_.\nPackages for other distributions are welcome.\n\nFor an installation `from PyPI \u003chttps://pypi.org/project/yarsync/\u003e`_, run\n\n.. code-block:: console\n\n    pip3 install yarsync\n\nIf you don't want to have it installed system widely (e.g. for testing), you can also install ``yarsync`` in a venv\n\n.. code-block:: console\n\n    python3 -m venv ~/.venv/yarsync\n    source ~/.venv/yarsync/bin/activate\n    pip install yarsync\n\nFor macOS ventura installation, the built-in rsync in macOS is version 2.6.9, yarsync requires a new version of rsync, run\n\n.. code-block:: console\n\n    brew install rsync\n    pip3 install yarsync\n\nIf ``rsync: --outbuf=L: unknown option`` occurs, make sure that a new version of rsync has been installed.\n\nSince there is no general way to install a manual page for a Python package,\none has to do it manually. For example, run as a superuser:\n\n.. code-block:: console\n\n    wget https://github.com/ynikitenko/yarsync/raw/master/docs/yarsync.1\n    gzip yarsync.1\n    mv yarsync.1.gz /usr/share/man/man1/\n    mandb\n\nMake sure that the manual path for your system is correct.\nThe command ``mandb`` updates the index caches of manual pages.\n\nOne can also install the most recent program version\n`from GitHub \u003chttps://github.com/ynikitenko/yarsync\u003e`_.\nIt incorporates latest improvements,\nbut at the same time is less stable (new features can be changed or removed).\n\n.. code-block:: console\n\n    git clone https://github.com/ynikitenko/yarsync.git\n    pip3 install -e yarsync\n\nThis installs the ``yarsync`` executable to *~/.local/bin*,\nand does not require modifications of ``PYTHONPATH``.\nAfter that, one can pull the repository updates without reinstallation.\n\nTo **uninstall**, run\n\n.. code-block:: console\n\n    pip3 uninstall yarsync\n\nand remove the cloned repository.\n\n--------------------\nDesign and features\n--------------------\n\n``yarsync`` can be used to manage hierarchies of unchanging files,\nsuch as music, books, articles, photographs, etc.\nIts final goal is to have the same state of files across\ndifferent computers.\nIt also allows to store backup copies of data and easily copy, update or recover that.\n``yarsync`` is\n\ndistributed\n  There is no central host or repository for ``yarsync``.\n  If different replicas diverge,\n  the program assists the user to merge the repositories manually.\n\nefficient\n  The program is run only on user demand,\n  and does not consume system resources constantly.\n  Already transferred files will never be transmitted again.\n  This allows the user to rename or move files\n  or whole directories without any costs,\n  driving constant improvements on the repository.\n\nnon-intrusive\n  ``yarsync`` does nothing to user data.\n  It has no complicated packing or unpacking.\n  All user data and program configuration are stored as usual files in the file system.\n  If one decides to stop using ``yarsync``,\n  they can simply remove the configuration directory at any time.\n\nsimple\n  ``yarsync`` does not implement complicated file transfer algorithms,\n  but uses an existing, widely accepted and tested tool for that.\n  User configuration is stored in simple text files,\n  and repository snapshots are usual directories, which can be modified, copied\n  or browsed from a file manager.\n  All standard command line tools can be used in the repository,\n  to assist its recovery or to allow any non-standard operations\n  (for the users who understand what they do).\n  Read the ``yarsync`` documentation to understand its (simple) design.\n\nsafe\n  ``yarsync`` does its best to preserve user data.\n  It always allows one to see what will be done before any actual modifications\n  (*--dry-run*). It is its advantage compared to continous synchronization tools,\n  that may be dangerous if local repository gets corrupt (e.g. encrypted by a trojan).\n  Removed files are stored in older commits\n  (until the user explicitly removes those).\n\n..\n  If a file gets corrupt, it will not be transferred by default,\n  but when the user chooses to *pull --backup*, any diverged files will be visible\n  (with their different versions preserved).\n\n---------\nCommands\n---------\n\n::\n\n    checkout\n    clone\n    commit\n    diff\n    init\n    log\n    pull\n    push\n    remote\n    show\n    status\n\nSee ``yarsync --help`` for full command descriptions and options.\n\n----------------------------\nRequirements and limitations\n----------------------------\n``yarsync`` is a Python wrapper (available for ``Python\u003e=3.6``) around ``rsync``\nand requires a file system with **hard links**.\nSince these are very common tools,\nthis means that it can easily run on any UNIX-like system.\nMoreover, ``yarsync`` is not required to be installed on the remote host:\nit is sufficient for ``rsync`` to be installed there.\n\nIn particular, ``rsync`` can be found:\n\n* installed on most GNU/Linux distributions,\n* installed on `Mac OS \u003chttps://eshop.macsales.com/blog/45185-mac-101-learn-the-power-of-rsync-for-backup-remote-archive-systems/\u003e`_,\n* can be installed on `Windows \u003chttps://superuser.com/questions/300263/how-to-use-rsync-from-windows-pc-to-remote-linux-server\u003e`_.\n\n``yarsync`` runs successfully on Linux.\nPlease report to us if you have problems (or success) running it on your system.\n\n-------\nSafety\n-------\n``yarsync`` has been used by the author for several years without problems and is tested.\nHowever, any data synchronization may lead to data loss,\nand it is recommended to have several data copies\nand always do a *--dry-run* (*-n*) first before the actual transfer.\n\n-------------\nDocumentation\n-------------\n\nFor the complete documentation, read the installed\nor online `manual \u003chttps://yarsync.readthedocs.io/en/latest/yarsync.1.html\u003e`_.\n\nFor more in-depth topics or alternatives, see\n`details \u003chttps://yarsync.readthedocs.io/en/latest/details.html\u003e`_.\n\nOn the repository github, `release notes \u003chttps://github.com/ynikitenko/yarsync/blob/master/NEWS.rst\u003e`_ can be found.\nOn github pages there is the manual for `yarsync 0.1 \u003chttps://ynikitenko.github.io/yarsync/man\u003e`_.\n\nAn article in Russian that deals more with ``yarsync`` internals was posted\non `Habr \u003chttps://habr.com/ru/post/662163/\u003e`_.\n\n---------------------------------\nDevelopment / Contributing notes\n---------------------------------\n\nPlease use a virtualenv in order to avoid messing with your system while working on ``yarsync``.\n\n.. code-block:: console\n\n    python3 -m venv ~/.venv/yarsync_dev\n    source ~/.venv/yarsync_dev/bin/activate\n    pip install -r requirements.txt\n\nTo build and then install ``yarsync``, run the following commands.\n\n.. code-block:: console\n\n    pip install --upgrade build\n    python -m build\n    pip install ./dist/yarsync-0.2.1.tar.gz\n\nPlease make sure to run the tests and ensure you haven't broken anything before submitting a pull request.\n\n.. code-block:: console\n\n    pytest\n    # For a better verbose level\n    pytest -vvv\n\nYou can run tests on all supported python versions by simply running in your venv ``tox``.\nPlease make sure to have installed some supported python versions beforehand (At least two for tox to be useful).\n\n.. code-block:: console\n\n    tox\n\n------\nThanks\n------\n\nA good number of people have contributed to the improvement of this software.\nI'd like to thank\nNilson Silva for packaging ``yarsync`` for Debian,\nMikhail Zelenyy from MIPT NPM for the explanation of\nPython `entry points \u003chttps://npm.mipt.ru/youtrack/articles/GENERAL-A-87/\u003e`_,\nJason Ryan and Matthew T Hoare for the inspiration to create a package for Arch,\nScimmia for a comprehensive review and suggestions for my PKGBUILD,\nOpen Data Russia chat for discussions about backup safety,\nHabr users and editors, and, finally,\nto the creators and developers of ``git`` and ``rsync``.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fynikitenko%2Fyarsync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fynikitenko%2Fyarsync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fynikitenko%2Fyarsync/lists"}