toda's Introduction

Toda

Toda (תודה) gives you the power to safely deploy files using symlinks on any operating system with Python installed.

Toda requires only core Python, supporting versions 3.4+ and 2.7. Toda has multi-platform support for POSIX-compliant systems, Linux (Debian, Ubuntu, etc), Windows, macOS and BSDs in that order of priority.

Catch22: Toda requires admin rights on Windows. See #8

`toda`

usage: toda [-h] [-n] [-m MANIFEST] [-f] [-v]
                   [{install,purge,inspect}] [section [section ...]]

creates symlinks described by a manifest

positional arguments:
  {install,purge,inspect}
  section               manifest target

optional arguments:
  -h, --help            show this help message and exit
  -n, --dry-run         nop out all syscalls, verbose
  -m MANIFEST, --manifest MANIFEST
                        path to custom manifest file
  -f, --force           allow clobbering files in target paths
  -v, --verbose

`MANIFEST` file syntax

~/bin/destination_link: ./section/source_file
- destination-to-source mapping, with the two arguments delimited by a colon
$ bin
- defines the bin section
/bin/sh: @delete deletes /bin/sh
@include: bin default
- includes bin and default
- in each run of manifest.py includes are resolved recursively so that they are only processed once

Why did you roll your own dotfiles management script?

See the wiki

toda's People

Contributors

Stargazers

Watchers

toda's Issues

basic tests

tox test harness for py27,py34,py36

troll hack: Symfest must start with a vi modeline

so if its missing the modeline, it adds it

`@include` order hard to predict in complicated manifests

@include resolves recursively, but order is hard to grok in complicated manifests

this makes overriding one with another hard.

either: overriding within the same manifest in nested sections must be verboten; preflight panic
or: new destination macro, @force is an include you run in order, and ordering must matter, so refactor to use ordered sets for everything (for this i would use an ordered dict because builtin); and you must record @force sections recursively (implement using a queue because python recursion depth limit trash) to prevent a cycle

@force sounds like a lot of work for little. it sounds like poor design. maybe it is.

using different sections that can be manually constructed to cause a force is cooler.

pypi

tests in travis

Windows 10: symlinks without admin privileges

This feature to symlink without admin rights was introduced in Windows 10 API in build 14972, though supported earlier in NTFS. Haven't been able to get it to work right.
https://blogs.windows.com/windowsdeveloper/2016/12/02/symlinks-windows-10/

AC: