You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
neovim-remote/INSTALLATION.md

49 lines
1.3 KiB
Markdown

# Installation
## The normal way
$ pip3 install neovim-remote
On most systems this will install to `/usr/local/bin`, which is usually in $PATH
already. You're done.
If you get a _permission denied_ error, e.g. because it tried to install to
`/usr/bin`, **do not** use `sudo` to force it!
Use this instead:
$ pip3 install --user neovim-remote
This will install to `~/.local/bin` (Linux) or `~/Library/Python/3.x/bin`
(macOS) which needs to be added to $PATH.
This will give you the correct location:
$ python3 -c 'import site; print(site.USER_BASE)'
If `nvr` is not in your path and you installed Python with `asdf`, you might need
to reshim:
$ pip3 install neovim-remote
$ asdf reshim python
## From repo
If you want to test your own changes, it makes sense to put your local repo into
_develop mode_. That way your Python environment will use the repo directly and
you don't have to reinstall the package after each change:
$ git clone https://github.com/mhinz/neovim-remote
$ cd neovim-remote
$ pip3 install -e .
Now, `pip3 list` will show the path to the local repo after the package version.
## From zip
Download the [zipped
sources](https://github.com/mhinz/neovim-remote/archive/master.zip) and install
install them with either `pip3 install master.zip` or by running `python3
setup.py install` in the unzipped directory.