https://github.com/koehlma/pygtkspellcheck

A simple but quite powerful spellchecking library for GTK written in pure Python.
https://github.com/koehlma/pygtkspellcheck

Last synced: 3 months ago
JSON representation

A simple but quite powerful spellchecking library for GTK written in pure Python.

• Host: GitHub
• URL: https://github.com/koehlma/pygtkspellcheck
• Owner: koehlma
• License: gpl-3.0
• Created: 2011-09-04T00:20:36.000Z (almost 14 years ago)
• Default Branch: master
• Last Pushed: 2023-12-08T08:24:05.000Z (over 1 year ago)
• Last Synced: 2025-03-13T21:40:24.653Z (3 months ago)
• Language: Python
• Homepage:
• Size: 5.32 MB
• Stars: 24
• Watchers: 6
• Forks: 9
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG
  • License: LICENSE

Awesome Lists containing this project

README

        
# Python GTK Spellcheck

[![PyPi Project Page](https://img.shields.io/pypi/v/pygtkspellcheck.svg?&label=latest%20version)](https://pypi.python.org/pypi/pygtkspellcheck)

[![Documentation](https://readthedocs.org/projects/pygtkspellcheck/badge/?version=latest)](https://pygtkspellcheck.readthedocs.org/en/latest/)

Python GTK Spellcheck is a simple but quite powerful spellchecking library for GTK written in pure Python. It's spellchecking component is based on [Enchant](http://www.abisource.com/projects/enchant/) and it supports both GTK 3 and 4 via [PyGObject](https://live.gnome.org/PyGObject/).

**⚡️ News:** Thanks to [@cheywood](https://github.com/cheywood), Python GTK Spellcheck now supports GTK 4! 🎉

**🟢 Status:** This project is mature, actively maintained, and open to contributions and co-maintainership.

## ✨ Features

- **spellchecking** based on [Enchant](http://www.abisource.com/projects/enchant/) for `GtkTextView`

- support for word, line, and multiline **ignore regular expressions**

- support for both **GTK 3 and 4** via [PyGObject](https://live.gnome.org/PyGObject/) for Python 3

- configurable extra word characters such as `'`

- localized names of the available languages based on [ISO-Codes](http://pkg-isocodes.alioth.debian.org/)

- support for custom ignore tags and hot swap of `GtkTextBuffer`

- support for Hunspell (LibreOffice) and Aspell (GNU) dictionaries



  



## 🚀 Getting Started

Python GTK Spellcheck is available from the [Python Package Index](https://pypi.python.org/pypi/pygtkspellcheck):

```sh

pip install pygtkspellcheck

```

Depending on your distribution, you may also find Python GTK Spellcheck in your package manager.

For instance, on Debian you may want to install the [`python3-gtkspellcheck`](https://packages.debian.org/bullseye/python3-gtkspellcheck) package.

## 🥳 Showcase

Over time, several projects have used Python GTK Spellcheck or are still using it. Among those are:

- [Nested Editor](http://nestededitor.sourceforge.net/about.html): “Specialized editor for structured documents.”

- [Cherry Tree](http://www.giuspen.com/cherrytree/): “A hierarchical note taking application, […].”

- [Zim](http://zim-wiki.org/): “Zim is a graphical text editor used to maintain a collection of wiki pages.”

- [REMARKABLE](http://remarkableapp.github.io/): “The best markdown editor for Linux and Windows.”

- [RedNotebook](http://rednotebook.sourceforge.net/): “RedNotebook is a modern journal.”

- [Reportbug](https://packages.debian.org/stretch/reportbug): “Reports bugs in the Debian distribution.”

- [UberWriter](http://uberwriter.wolfvollprecht.de/): “UberWriter is a writing application for markdown.”

- [Gourmet](https://github.com/thinkle/gourmet): “Gourmet Recipe Manager is a manager, editor, and organizer for recipes.“

## 🔖 Versions

Version numbers follow [Semantic Versioning](http://semver.org/). However, the update from 3 to 4 pertains only API incompatible changes in `oxt_extract` and not the spellchecking component. The update from 4 to 5 removed support for Python 2, GTK 2, `pylocales`, and the `oxt_extract` API. Otherwise, the API is still compatible with version 3.

## 📚 Documentation

The documentation is available at [Read the Docs](http://pygtkspellcheck.readthedocs.org/).

## 🏗 Contributing

We welcome all kinds of contributions! ❤️

For minor changes and bug fixes feel free to simply open a pull request. For major changes impacting the overall design of Python GTK Spellcheck, please first [start a discussion](https://github.com/koehlma/pygtkspellcheck/discussions/new?category=ideas) outlining your idea.

By submitting a PR, you agree to license your contributions under “GPLv3 or later”.