https://github.com/tatsh/baldwin
Simple tracking of your home directory with easy-to-read diffs.
https://github.com/tatsh/baldwin
command-line file-management git version-control
Last synced: 4 months ago
JSON representation
Simple tracking of your home directory with easy-to-read diffs.
- Host: GitHub
- URL: https://github.com/tatsh/baldwin
- Owner: Tatsh
- License: mit
- Created: 2024-11-29T01:21:44.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2026-03-03T00:11:12.000Z (4 months ago)
- Last Synced: 2026-03-03T03:29:09.595Z (4 months ago)
- Topics: command-line, file-management, git, version-control
- Language: Python
- Homepage: https://tatsh.github.io/baldwin/
- Size: 5.03 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
- Citation: CITATION.cff
- Codeowners: CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
README
# Baldwin
[](https://www.python.org/)
[](https://pypi.org/project/baldwin/)
[](https://github.com/Tatsh/baldwin/tags)
[](https://github.com/Tatsh/baldwin/blob/master/LICENSE.txt)
[](https://github.com/Tatsh/baldwin/compare/v0.0.10...master)
[](https://github.com/Tatsh/baldwin/actions/workflows/codeql.yml)
[](https://github.com/Tatsh/baldwin/actions/workflows/qa.yml)
[](https://github.com/Tatsh/baldwin/actions/workflows/tests.yml)
[](https://coveralls.io/github/Tatsh/baldwin?branch=master)
[](https://github.com/dependabot)
[](https://baldwin.readthedocs.org/?badge=latest)
[](https://mypy-lang.org/)
[](https://pre-commit.com/)
[](https://python-poetry.org)
[](https://www.pydocstyle.org/)
[](https://docs.pytest.org)
[](https://github.com/astral-sh/ruff)
[](https://pepy.tech/project/baldwin)
[](https://github.com/Tatsh/baldwin/stargazers)
[](https://prettier.io/)
[](https://bsky.app/profile/Tatsh.bsky.social)
[](https://buymeacoffee.com/Tatsh)
[](irc://irc.libera.chat/Tatsh)
[](https://hostux.social/@Tatsh)
[](https://www.patreon.com/Tatsh2)
This is a conversion of my simple scripts to version my home directory with very specific excludes
and formatting every file upon commit so that readable diffs can be generated.
## Installation
### Pip
```shell
pip install baldwin
```
## Usage
```plain
$ bw -h
Usage: bw [OPTIONS] COMMAND [ARGS]...
Manage a home directory with Git.
Options:
-d, --debug Enable debug logging.
-h, --help Show this message and exit.
Commands:
auto-commit
format
git
info
init
install-units
```
In addition to the `bw` command, `hgit` is a shortcut for `bw git`.
### Start a new repository
```shell
bw init
```
Find out where the Git directory is by running `bw info`. This can be done even if `init` has not
been run.
### Automation
#### systemd
```shell
bw install-units
```
This will install a timer that will automatically make a new commit every 6 hours. It does not push.
Keep in mind that systemd units require a full path to the executable, so you must keep the unit
up-to-date if you move where you install this package. Simply run `bw install-units` again.
Note that user systemd units only run while logged in.
To disable and remove the units, use the following commands:
```shell
systemctl disable --now home-vcs.timer
rm ~/.config/systemd/user/home-vcs.*
```
### Pushing
To push, use either of the following:
- `bw git push`
- `hgit push`
The above also demonstrates that `bw git`/`hgit` are just frontends to `git` with the correct
environment applied.
## Formatting
If Prettier is installed, it will be used to format files. The configuration used comes with this
package. Having consistent formatting allows for nice diffs to be generated.
If you have initialised a repository without having `prettier` or `jq` in `PATH`, you need to run the
following commands to enable readable diffs:
```shell
hgit config diff.json.textconv 'jq -MS .'
hgit config diff.json.cachetextconv true
hgit config diff.yaml.textconv 'prettier --no-editorconfig --parser yaml'
hgit config diff.yaml.cachetextconv true
```
If you have the XML plugin installed:
```shell
hgit config diff.xml.textconv 'prettier --no-editorconfig --parser xml --xml-whitespace-sensitivity ignore'
hgit config diff.xml.cachetextconv true
```
## Binary files
Any file that is untracked and detected to be binary will not be added. Use `hgit add` to add a
binary file manually.
## Other details
Default `.gitignore` and `.gitattributes` files are installed on initialisation. They are never
modified by this tool. Please customise as necessary.