https://github.com/dotmpe/user-conf
Seed for user dotfile repository.
https://github.com/dotmpe/user-conf
Last synced: 5 days ago
JSON representation
Seed for user dotfile repository.
- Host: GitHub
- URL: https://github.com/dotmpe/user-conf
- Owner: dotmpe
- Created: 2016-03-17T18:33:54.000Z (about 10 years ago)
- Default Branch: r0.2
- Last Pushed: 2025-02-21T22:01:01.000Z (over 1 year ago)
- Last Synced: 2025-02-21T23:19:00.849Z (over 1 year ago)
- Language: Shell
- Size: 844 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: ReadMe.rst
- Changelog: ChangeLog.rst
Awesome Lists containing this project
README
.. include:: .default.rst
User-Config
===========
:Created: 2015-10-03
:Updated: 2021-01-23
:Version: 0.2.0
:Project:
.. image:: https://secure.travis-ci.org/dotmpe/user-conf.png
:target: https://travis-ci.org/dotmpe/user-conf
:alt: Build
.. image:: https://badge.fury.io/gh/dotmpe%2Fuser-conf.png
:target: http://badge.fury.io/gh/dotmpe%2Fuser-conf
:alt: GIT
Scripts and config directives for a dotfile repository.
.. figure:: doc/screen-shot.png
Intro
-----
It was time to expand a little on my existing dotfile repo setup.
There's probably many out there. But this was not about example dotfiles,
but a way to deal with copies and checkouts spread over different hosts.
Simplicity meant using GIT, and a Bourne shell as the only requirements.
BATS is optional for testing the core libraries.
To provision or configure a host the script takes one config file as input.
Install
-------
::
# something to put in your shell profile script
export UCONF=$HOME/.conf
git clone --origin tpl git@github.com:dotmpe/user-conf.git $UCONF
Guide
-----
Each host::
cd $UCONF; ./script/user-conf/init.sh
Add file copies using script::
cd /etc/acme
$UCONF/script/user-conf/add.sh gizmo.conf
Or edit ``$UCONF/install/$hostname.conf`` by hand to create symlinks,
and to supply other directives.
To run the directives::
$UCONF/script/user-conf/update.sh
Or to dry-run::
$UCONF/script/user-conf/stat.sh
See Manual_ and Specification_ for user documentation.
Bugs
----
While not experimental code, this a heavy work-in-progress at the moment.
This document should be updated to reflect the current version but will be lagging a bit until I catch up.
Versions
--------
Expect a long way to go to any definite 1.0 version, if any.
Development release listing in ``ChangeLog.rst``.
.. _Specification: doc/Specification.rst
.. _Manual: doc/Manual.rst