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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
Guidelines for Code Modification
================================
Coding Style
------------
* Use syntax compatible with Python `2.6+` and `3.1+`.
* Use docstrings with `pydoc` in mind
* Follow the PEP8 style guide: https://www.python.org/dev/peps/pep-0008/
* Always run `make test` before submitting a new PR. `pylint`, `flake8`,
`pytest`, `doctest` and `shellcheck` need to be installed. (If you don't
change any shell scripts you can run `make test_py` and you don't need the
`shellcheck` dependency but it's an awesome tool, so check it out : )
* When breaking backward compatibility with old configuration files or plugins,
please include a temporary workaround code that provides a compatibility
layer and mark it with a comment that includes the word `COMPAT`. For
examples, grep the code for the word `COMPAT`. :)
Patches
-------
Send patches, created with `git format-patch`, to the email address
ranger-users@nongnu.org
or open a pull request on GitHub.
Please use PGP-encryption for security-relevant patches or messages. PGP key
IDs are shared along with releases on https://ranger.github.io and can be
attempted in reverse chronological order in case a maintainer is unresponsive.
Version Numbering
-----------------
Three numbers, `A.B.C`, where
* `A` changes on a rewrite
* `B` changes when major configuration incompatibilities occur
* `C` changes with each release
Starting Points
---------------
Good places to read about ranger internals are:
* `ranger/core/actions.py`
* `ranger/container/fsobject.py`
About the UI:
* `ranger/gui/widgets/browsercolumn.py`
* `ranger/gui/widgets/view_miller.py`
* `ranger/gui/ui.py`
Common Changes
==============
Adding options
--------------
* Add a default value in `rc.conf`, along with a comment that describes the option.
* Add the option to the `ALLOWED_SETTINGS` dictionary in the file
`ranger/container/settings.py` in alphabetical order.
* Add an entry in the man page by editing `doc/ranger.pod`, then rebuild the man
page by running `make man` in the ranger root directory
The setting is now accessible with `self.settings.my_option`, assuming self is a
subclass of `ranger.core.shared.SettingsAware`.
Adding colorschemes
-------------------
* Copy `ranger/colorschemes/default.py` to `ranger/colorschemes/myscheme.py`
and modify it according to your needs. Alternatively, create a subclass of
`ranger.colorschemes.default.Default` and override the `use` method, as it is
done in the `Jungle` colorscheme.
* Add this line to your `~/.config/ranger/rc.conf`:
`set colorscheme myscheme`
Change which programs start which file types
--------------------------------------------
Edit the configuration file `~/.config/ranger/rifle.conf`. The default one can
be obtained by running `ranger --copy-config rifle`.
Change which file extensions have which mime type
-------------------------------------------------
Modify `ranger/data/mime.types`. You may also add your own entries to `~/.mime.types`
Change which files are previewed in the auto preview
----------------------------------------------------
In `ranger/container/file.py`, change the constant `PREVIEW_BLACKLIST`
|