https://github.com/xxh/xxh-plugin-prerun-dotfiles

Bring your dotfiles to the host during ssh session and place it into hermetic xxh environment.
https://github.com/xxh/xxh-plugin-prerun-dotfiles

dotfiles xxh xxh-plugin

Last synced: 3 months ago
JSON representation

Bring your dotfiles to the host during ssh session and place it into hermetic xxh environment.

• Host: GitHub
• URL: https://github.com/xxh/xxh-plugin-prerun-dotfiles
• Owner: xxh
• License: bsd-2-clause
• Created: 2020-04-19T12:43:23.000Z (almost 5 years ago)
• Default Branch: master
• Last Pushed: 2024-04-29T12:33:18.000Z (9 months ago)
• Last Synced: 2024-08-01T13:38:13.155Z (6 months ago)
• Topics: dotfiles, xxh, xxh-plugin
• Language: Shell
• Homepage:
• Size: 26.4 KB
• Stars: 33
• Watchers: 3
• Forks: 29
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
  

The dotfiles plugin is the start point to create something similar to dotfiles project for xxh.



  

If you like the idea of xxh click ⭐ on the repo and stay tuned.



Fork this repository and put your files to the `home` directory. The files will be copied to xxh home directory (default `/home/user/.xxh/`) before running shell. 

The [XDG](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html) directory `.config` 

will be copied to `$XDG_CONFIG_HOME` (default `/home/user/.xxh/.config`). Learn more about [home settings in docs](https://github.com/xxh/xxh/wiki#how-to-set-homeuser-as-home-on-host).

## Note!

The plugin copy files only once during first start. It copies the files from plugin home directory to the host xxh home directory 

as addition and without replacing. It means if you hadn't the directory it will appear. If you have directory with files 

but without the file from plugin home it just appears.

Be carefully if you are using [non-hermetic environment](https://github.com/xxh/xxh/wiki#how-to-set-homeuser-as-home-on-host) by using `+hhh '~' +hhx '~'` arguments.  

## Install

From xxh repo:

```bash

xxh +I xxh-plugin-prerun-dotfiles

# or from any Github repo: xxh +I https://github.com/xxh/xxh-plugin-prerun-dotfiles

```

Connect:

```

xxh yourhost +if

```

## Preinstall PyPi packages

Add PyPi packages to `pip-requirements.txt` and they will be in `$XXH_HOME/.local`. 

This is compatible with [xxh-shell-xonsh](https://github.com/xxh/xxh-shell-xonsh), [xxh-plugin-prerun-python](https://github.com/xxh/xxh-plugin-prerun-python) and `pip install --user`.