Femto v0.0.2

Femto is a tiny, nano-style terminal text editor written in pure Python. It ships with zero runtime dependencies on POSIX system (standard-library curses only) and automatically pulls windows-curses on Windows.

Femto supports multi-buffer editing, soft line wrapping, syntax highlighting, regex search & replace, mouse support, and is fully Unicode (CJK/Emoji) aware.

Install

# From PyPI (Recommended)
pipx install femto-editor
# or
pip install femto-editor

# From source
git clone https://github.com/codewithzaqar/femto.git
cd femto
pip install .

After installation, the femto command is available globally.

Usage

femto [file ...]        # open one or multiple files
femto --line-numbers a.py x.py
femto --tab-size 2 --regex x.py
femto --version

Keybindings

Configuration (~/.femtorc or ./.femtorc)

Femto is highly customizable via a simple key = value configuration file.

# Indentation
tab_size = 4

# Viewport
smooth_scroll_margin = 3
soft_wrap = true
show_line_numbers = false
syntax_highlight = true

# Search
ignore_case = false
regex_search = false

# Input & I/O
mouse = false
make_backup = false

Running the tests

Femto includes a comprehensive unittest regression suite that runs headlessely (no terminal required).

python -m unittest discover -s tests -v

Building a release

pip install build twine
python -m build          # creates dist/femto_editor-0.0.1-*.whl
python -m twine upload dist/* # publish to PyPI

License

MIT - see LICENSE.