File: README.md

package info (click to toggle)
eshell-prompt-extras 1.1-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 1,192 kB
  • sloc: lisp: 483; makefile: 2
file content (86 lines) | stat: -rw-r--r-- 2,262 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
eshell-prompt-extras
====================

Display extra information and color for your eshell prompt.

Introduction
------------
This library display remote user, remote host, python virtual
environment info, git branch, git dirty info and git unpushed number
for eshell prompt.

If you want to display the python virtual environment info, you
need to install `virtualenvwrapper`.

`pip install virtualenvwrapper`

And [virtualenvwrapper.el](https://github.com/porterjamesj/virtualenvwrapper.el)

Installation
------------
It is recommended installed by the ELPA package system.
You could install it by `M-x`: with
`package-install`: `eshell-prompt-extras`.

Usage
-----
before emacs24.4

    (eval-after-load 'esh-opt
      (progn
        (autoload 'epe-theme-lambda "eshell-prompt-extras")
        (setq eshell-highlight-prompt nil
              eshell-prompt-function 'epe-theme-lambda)))

If you want to display python virtual environment information.

    (eval-after-load 'esh-opt
      (progn
        (require 'virtualenvwrapper)
        (venv-initialize-eshell)
        (autoload 'epe-theme-lambda "eshell-prompt-extras")
        (setq eshell-highlight-prompt nil
              eshell-prompt-function 'epe-theme-lambda))))

after emacs24.4

    (with-eval-after-load "esh-opt"
      (autoload 'epe-theme-lambda "eshell-prompt-extras")
      (setq eshell-highlight-prompt nil
            eshell-prompt-function 'epe-theme-lambda))

If you want to display python virtual environment information:

    (with-eval-after-load "esh-opt"
      (require 'virtualenvwrapper)
      (venv-initialize-eshell)
      (autoload 'epe-theme-lambda "eshell-prompt-extras")
      (setq eshell-highlight-prompt nil
            eshell-prompt-function 'epe-theme-lambda))

Themes
------

    epe-theme-lambda
    epe-theme-dakrone
    epe-theme-multiline-with-status

Custom Variables
----------------

    epe-show-python-info (default t)
    epe-git-dirty-char (default *)
    epe-git-untracked-char (default ?)
    epe-git-detached-HEAD-char (default D:)
    epe-path-style: (options: fish, single or full. default fish)

Faces
-----

    epe-remote-face
    epe-venv-face
    epe-dir-face
    epe-git-face
    epe-symbol-face
    epe-sudo-symbol-face
    epe-status-face