nexoniarz/Finch
Watch
1
0
Fork
You've already forked Finch
 0
mirror of https://github.com/Nexoniarz/Finch.git synced 2026-11-03 08:54:25 +00:00
Code Issues Projects Releases Packages Wiki Activity
Finch/editors/kate
History
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Nexoniarz b872be3176 Finch 2.4.0: methods, maps, errors as values; str() of any value; macOS and ARM64 docs; Kate support 
- fn Struct.method(...) with self by reference, also on C structs
- map[K]V: insertion-ordered hash maps, literals, m[k] += 1, has/get/remove/keys/values
- -> T! / -> !, return error(...), or <value>, or { err }, try; fallible int/float/read_file/write_file/delete_file
- for i, x in list / for k, v in map
- print and str() share one text formatter
- LSP: method and map completion, method signatures; grammar and snippets for VS Code and Kate
- tests: 74 (methods, errors, maps + 11 failure cases); docs at all three levels, en and pl

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-09 01:11:12 +02:00
..
finch.xml Finch 2.4.0: methods, maps, errors as values; str() of any value; macOS and ARM64 docs; Kate support 2026-10-09 01:11:12 +02:00
install.sh CMake: enable C (Homebrew LLVM's config needs it); Kate: highlighting, language server setup, install script 2026-10-09 00:36:44 +02:00
lspclient.json CMake: enable C (Homebrew LLVM's config needs it); Kate: highlighting, language server setup, install script 2026-10-09 00:36:44 +02:00
README.md CMake: enable C (Homebrew LLVM's config needs it); Kate: highlighting, language server setup, install script 2026-10-09 00:36:44 +02:00

README.md

Finch in Kate

Syntax highlighting and the Finch language server for Kate (and KWrite / KDevelop, which share Kate's highlighting engine).

Install

editors/kate/install.sh

It copies finch.xml to ~/.local/share/org.kde.syntax-highlighting/syntax/ and adds a finch entry to ~/.config/kate/lspclient/settings.json (your other servers are kept). Then:

  1. Restart Kate.
  2. Settings → Configure Kate → Plugins: enable LSP Client (and Build & Run for the next part).
  3. Make sure finch is on your PATH (finch version in a terminal).

Open a .fch file: errors appear as you type, hovering shows types and docs, Ctrl+Space completes (fields and methods after .), Go to Definition and the Symbols outline work, and parameter hints pop up inside (…).

Running and building

Build & Run plugin → Add target set, then add targets with these commands (the working folder can be %d, the folder of the current file):

Target Command
Run finch run %f
Build finch build %f

Give one of them a shortcut in Settings → Configure Keyboard Shortcuts (search for "Build"). Finch's errors have the file:line:column: error: form, so Kate lists them and jumps to the line on click.

By hand

  • Highlighting: copy finch.xml into ~/.local/share/org.kde.syntax-highlighting/syntax/ (Windows: %LOCALAPPDATA%\org.kde.syntax-highlighting\syntax\).
  • Language server: Settings → Configure Kate → LSP Client → User Server Settings, and add the finch entry from lspclient.json inside "servers".