Metadata-Version: 2.1
Name: emanate
Version: 7.0.0
Summary: Symlink files from one directory to another, similary to Effuse and Stow.
Home-page: https://github.com/duckinator/emanate
Author: attr: emanate.__author__
Author-email: me@duckie.co
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.5
Description-Content-Type: text/markdown
Provides-Extra: linting
Requires-Dist: flake8 (~=3.5) ; extra == 'linting'
Requires-Dist: flake8-bugbear ; extra == 'linting'
Requires-Dist: flake8-commas ; extra == 'linting'
Requires-Dist: flake8-docstrings ; extra == 'linting'
Requires-Dist: pydocstyle (<4) ; extra == 'linting'
Requires-Dist: pylint ; extra == 'linting'
Provides-Extra: testing
Requires-Dist: pytest ; extra == 'testing'

# emanate [![Build Status][build-status-link]][build-status-img]

Symlink files from one directory into another directory.

Inspired by [effuse](https://github.com/programble/effuse) and
[stow](https://www.gnu.org/software/stow/manual/stow.html).

[build-status-link]: https://api.cirrus-ci.com/github/duckinator/emanate.svg
[build-status-img]: https://cirrus-ci.com/github/duckinator/emanate

## Installation

```
$ pip3 install emanate
```

Or find the [latest release](https://github.com/duckinator/emanate/releases)
and grab the `emanate-<version>.pyz` file. This should work as a
standalone executable. If it doesn't, try `python3 emanate-<version>.pyz`.

Emanate version numbers follow the [semantic versioning] convention.
A [PEP 440] version specification for [compatible releases], like `~= 6.0`,
is the recommended way to select appropriate versions.

[semantic versioning]: https://semver.org/
[PEP 440]: https://www.python.org/dev/peps/pep-0440/
[compatible releases]: https://www.python.org/dev/peps/pep-0440/#compatible-release


## Usage

```
~$ cat ~/.bashrc
cat: /home/pup/.bashrc: No such file or directory
~$ pip3 install emanate
~$ cd ~/dotfiles
~/dotfiles$ ls -al
drwxr-xr-x.  9 pup pup 4096 Jun  3 12:06 ./
drwx------. 74 pup pup 4096 Jun  3 12:06 ../
drwxr-xr-x.  2 pup pup 4096 Jun  3 11:59 bin/
drwxr-xr-x.  6 pup pup 4096 Jun  3 11:59 .config/
drwxr-xr-x.  8 pup pup 4096 Jun  3 12:10 .git/
-rw-r--r--.  1 pup pup  486 Jun  3 11:59 .bash_aliases
-rw-r--r--.  1 pup pup   78 Jun  3 11:59 .bash_env
-rw-r--r--.  1 pup pup 1987 Jun  3 11:59 .bashrc
-rw-r--r--.  1 pup pup  163 Jun  3 12:06 README.md
~/dotfiles$ cat .bashrc
# TODO: Write .bashrc.
~/dotfiles$ echo '{"ignore": ["README.md"]}' > emanate.json
~/dotfiles$ emanate
~/dotfiles$ cat ~/.bashrc
# TODO: Write .bashrc.
```

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/duckinator/emanate. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

## Code of Conduct

Everyone interacting in the emanate project’s codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/duckinator/emanate/blob/master/CODE_OF_CONDUCT.md).


