https://github.com/t4ccer/elrage

Emacs interface to rage
https://github.com/t4ccer/elrage

age agenix emacs rage

Last synced: 26 days ago
JSON representation

Emacs interface to rage

• Host: GitHub
• URL: https://github.com/t4ccer/elrage
• Owner: t4ccer
• License: gpl-3.0
• Created: 2024-09-06T04:40:37.000Z (2 months ago)
• Default Branch: master
• Last Pushed: 2024-09-07T22:54:47.000Z (2 months ago)
• Last Synced: 2024-09-30T08:05:07.810Z (about 1 month ago)
• Topics: age, agenix, emacs, rage
• Language: Rust
• Homepage:
• Size: 43 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.org
  • License: LICENSE

Awesome Lists containing this project

README

        
* =elrage=

*Experimental* Emacs interface to Rust implementation of =age= ([[https://github.com/str4d/rage][rage]]) with support for passphrase input callbacks. It requires Emacs compiled with support for [[https://www.gnu.org/software/emacs/manual/html_node/elisp/Dynamic-Modules.html][dynamic modules]].

** Installation

*** With Nix

#+begin_src console

$ mkdir -p ~/.emacs.d/dynamic-modules # or any path other you want

$ nix build -L github:t4ccer/elrage#elrage

$ nix-store --realise ./result --add-root ~/.emacs.d/dynamic-modules/elrage.root

$ ln -s ~/.emacs.d/dynamic-modules/{elrage.root/lib/,}elrage.so -f

#+end_src

*** With Cargo

#+begin_src console

$ git clone https://github.com/t4ccer/elrage

$ cd elrage

$ mkdir -p ~/.emacs.d/dynamic-modules # or any path other you want

$ cargo build --release

$ cp ./target/release/libelrage.so ~/.emacs.d/dynamic-modules/elrage.so

#+end_src

Note that this is not recommended on NixOS for long-term use (but perfect for development) as runtime dependencies of elrage.so file such as glibc may get garbage collected.

*** Common

#+begin_src elisp

(add-to-list 'load-path "~/.emacs.d/dynamic-modules")

(require 'elrage)

#+end_src

** Usage

*** [[https://github.com/t4ccer/agenix.el/][agenix.el]] integration

Functions exposed by this package have signatures that match those of =agenix-age-decrypt-function= and =agenix-age-encrypt-function= variables. This enables support for SSH keys with passphrases and does not require =age= executable in runtime.

#+begin_src elisp

;; Install agenix.el and elrage

(setq agenix-age-decrypt-function 'elrage-decrypt-file-interactive)

(setq agenix-age-encrypt-function 'elrage-encrypt-file)

#+end_src

** License

Copyright (C) 2024 Tomasz Maciosowski (t4ccer)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.