Automatically synchronize content with upstream via magit
Important
Autosync-Magit is deprecated and I've moved development over to autosync-git, which I hope to eventually submit to MELPA, once I am done thoroughly testing it. You can continue to use Autosync-Magit if it works for you, however there won't be any update or fixes to this package from me.
Autosync-Magit provides a minor mode to automatically synchronize a local git repository branch with its upstream, using Magit. It is intended to be used exceptionally: when git is used solely to synchronize private content between devices or personal backups. With this use case, there is typically no need to create branches, and all changes can be pushed to the remote as soon as they are committed. The author created it to synchronize their personal notes between different devices.
Autosync-Magit should never be used for other use cases and especially not for team settings.
To configure a repository to automatically synchronize, turn on
autosync-magit-mode in a buffer, and set the package variables accordingly.
Settings can be made permanent by adding .dir-locals.el in repositories you
want to synchronize. Example:
((nil . ((autosync-magit-commit-message . "My commit message")
(autosync-magit-pull-timer . 300)
(mode . autosync-magit))))
The configuration above turns on the minor mode for any file visited in the
same directory as .dir-locals.el or in its sub-directories. The
autosync-magit-commit-message is used as the commit message for each
commit. The autosync-magit-pull-timer controls the period between
background pull attempts, in seconds. See the documentation of each variable
for more details.
This is a simple package, that lends much of its functionality to magit
that does most of the work asynchronously under the hood.
With straight.el and use-package.el, add this to your ~/.emacs.d/init.el:
(use-package autosync-magit
:straight (:host github
:repo "sbougerel/autosync-magit"
:files ("*.el")))
And restart Emacs. If you're using Doom Emacs, add this to your
~/.doom.d/packages.el:
(package! autosync-magit
:recipe (:host github
:repo "sbougerel/autosync-magit"
:files ("*.el")))
Then add the following to ~/.doom.d/config.el:
(use-package! autosync-magit)
Then run `doom sync' to install it.
0.5.0 - Fixed a bug, added several improvements.
Removed the installed find-file-hook, thereby fixing an issue with other repositories being synced when it is unwanted.
Removed the redundant variable autosync-magit-pull-when-visiting: pulling
now simply occurs whenever a file is visited and autosync-magit-mode is
active for the file. Keeping this variable has no effect.
Eliminated timers when more than one timer exists for the same repository.
Don't run hooks when the merge fails, and informs the user.
0.4.0 - Introduces a background timer for periodic pull.
This is superior to the previous pull-on-events model, which does not work
fast enough in a variety of use cases. Add
autosync-magit-pull-when-visiting and autosync-magit-pull-timer for
background periodic pull. Users are advised to switch from setting
autosync-magit-pull-interval to setting autosync-magit-pull-timer in
directory-local variables. Additionally, the deprecated variable
autosync-magit-dirs was removed. For users that wish to start
synchronisation as soon as Emacs starts, they may simply visit the directory
in a temporary buffer during initialisation.
0.3.0 - Merges are synchronous, all other operations are asynchronous.
This prevents possible concurrency issues with find-file-hook functions.
0.2.0 - Use per-directory local variables.
Deprecation of autosync-magit-dirs in favor of .dir-locals.el.
0.1.0 - initial release
Minimum interval between any pull attempts, in seconds.
autosync-magit pulls updates either via a timer or when visiting a
file if autosync-magit-mode is t for that buffer.
This variable sets the minimum interval between any two pull attempts,
it is always enforced. This is to ensure that
autosync-magit--pull-on-timer or autosync-magit--pull-when-visiting
will never run too close to one another.
Interval between background pull attempts, in seconds.
autosync-magit start pulling updates from remotes periodically via a
background timer as soon as a buffer with autosync-magit-mode visits a
file in a repository. This variable sets or updates the period of the
background timer.
It is recommended to use directory-local variables (in .dir-locals.el)
to set this variable value. autosync-magit keeps a single copy of
this value per repository. When autosync-magit-mode is turned on in a
buffer, the variable value is copied to the per-repository setting,
overriding any previous value.
Default duration in seconds that must elapse before the next push.
When you save a buffer, wait for autosync-magit-push-debounce to
elapse before pushing to the remote (again). This ensures that multiple
file saves in a short period of time do not result in multiple pushes.
It is recommended to use directory-local variables (in .dir-locals.el)
to set this variable value.
Commit message to use for each commit.
This variable is buffer-local. Since the variable is buffer-local, and
commits & pushes are triggered from write-file-functions, each file
can have its custom commit message. Caveat: when multiple file saves
occur within autosync-magit-push-debounce, the commit message is the
buffer-local value of the first file saved.
Hook run after a merge is completed.
Fetch and merge (if needed) the repository at PATH. This interactive function is not throttled, it is executed as soon as it called. Merges are synchronous, to minimize possible conflicts with files modified by Emacs in the repository.
Create a commit with MESSAGE and push the repository at PATH. This interactive function is not debounced, it is executed asynchronously, as soon as it called.