Skip to content

Latest commit

 

History

History
81 lines (59 loc) · 2.4 KB

README_DEVEL.org

File metadata and controls

81 lines (59 loc) · 2.4 KB

General

python-mode.el is composed from components-python-mode directory using `components2pythonmode’ shell-script

Get its source-files doing

git clone https://gitlab.com/python-mode-devs/components-python-mode

while master is at https://gitlab.com/python-mode-devs/python-mode.git

An effective way users may contribute is telling us how Python-mode is used and which command is missing still.

Several files in developing branch components-python-mode are generated by functions in devel/python-mode-utils.el It’s marked at the head of these files

Output buffers

There will be

  • one set internally to process, where the real work is done: py-buffer-name
  • a generic one, results may arrive finally, visible for user: py-output-buffer

Commands might set their output-buffers, ”Python Completions” for example.

Organizing source code to edit Python

Commands are grouped by action WRT Python forms

backward FORM / forward of FORM

forward FORM left corner

mark FORM

copy FORM

kill FORM

delete FORM

up Form

down form

Basically use ‘backward’ and ‘forward’ instead of beginning/end of ‘py-beginning-of-statement’ aliased ‘py-backward-statement’ etc. beginning/end of forms are reserved for booleans. A separating convention, intended to make sripting easier.

Organizing source code to run Python

A ‘py-python-’ form may have a ‘py-ipython’ sibling

Bugs, feature requests

Please use bug-tracker at https://gitlab.com/python-mode-devs/python-mode/issues

Testing

Tests in batch-mode are run via run-travis-ci.sh

However, there is no need to use batch-mode for a single test. Batch-mode has some quirks and bugs. Tests in test/py-ert-interactive-tests.el are expected to succeed when called interactively, not in batch-mode.

Start tests from emacs -Q All needed beside python-mode.el is test/setup-ert-tests.el and the file, which contains the test. Run the test M-x ert TESTNAME RET

Instruments it for the debugger with M-x edebug-defun RET after or inside the test . Use <space> to step.

Completion directory

contains some Pymacs related stuff There was a conflict when Pymacs was installed from source, therefor it’s not loaded by default

History

Remarks like lp:837065 refer to a former repository at https://launchpad.net/, https://bugs.launchpad.net/bugs/837065