You are viewing the documentation for the develop branch. The documentation for the release version is here .

Table of Contents

Hy layer

Table of ContentsClose

hy.png

1. Description

This layer adds support for the Hy language based on Python.

1.1. Features:

  • syntax-highlighting
  • Auto-completion
  • Code Navigation
  • Python test runners (see python layer)
  • Virtual Environment using pyvenv and pyenv
  • Org Babel support

2. Install

2.1. Layer

To use this configuration layer, add it to your ~/.spacemacs. You will need to add hy to the existing dotspacemacs-configuration-layers list in this file.

To install hy globally:

pip3 install hy

2.2. Auto-completion

hy-mode relies on jedhy for auto-completion.

jedhy can be installed with:

pip3 install jedhy

3. Key bindings

3.1. Debug

Key binding Description
SPC m d d insert pdb
SPC m d t insert pdb threaded

3.2. REPL

Start a Hy inferior REPL process with SPC m s i. If hy is available in system executable search paths, hy will be used to launch the shell. You may change your system executable search path by activating a virtual environment.

Send code to hy REPL commands:

Key binding Description
SPC m s b send buffer to the REPL
SPC m s B send buffer to the REPL and switch to it
SPC m s c send form containing current point to the REPL
SPC m s C send form containing current point to the REPL and switch to it
SPC m s i start and/or switch to REPL
SPC m s r send current region to the REPL
SPC m s R send current region to the REPL and switch to it
SPC m s s start and/or swithc to REPL

3.3. Tests

Key binding Description
SPC m t a launch all tests of the project
SPC m t A launch all tests of the project in debug mode
SPC m t m launch all tests of the current module
SPC m t M launch all tests of the current module in debug mode

3.4. Python environments

Key binding Description
SPC m v a activate a virtual environment in any directory
SPC m v d deactivate active virtual environment
SPC m v s set a pyenv environment with pyenv
SPC m v u unset a pyenv environment with pyenv
SPC m v w work on virtual environment in WORKON_HOME
SPC m v p a activate pipenv in current project
SPC m v p d deactivate pipenv in current project
SPC m v p i install module into pipenv environment
SPC m v p o open pipenv module in buffer
SPC m v p s launch pipenv shell in current project
SPC m v p u uninstall module from pipenv environment

Author: root

Created: 2021-09-29 Wed 20:45

Validate