plugins/presence-nvim: init plugin (#285)

* presence-nvim: init plugin

Discord Rich Presence for Neovim

* Apply suggestions from code review

Co-authored-by: Gaétan Lepage <33058747+GaetanLepage@users.noreply.github.com>

* presence-nvim: fixes syntax error

* presence-nvim: updates some options to accept raw types

the options which were able to accept lua functions are now able to be assigned raw values

---------

Co-authored-by: Gaétan Lepage <33058747+GaetanLepage@users.noreply.github.com>
This commit is contained in:
Shayan Rashid 2023-03-24 08:20:10 -04:00 committed by GitHub
parent 5ae654b74d
commit 6d4c15385d
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 224 additions and 0 deletions

View file

@ -78,6 +78,7 @@
./utils/nvim-tree.nix ./utils/nvim-tree.nix
./utils/nvim-osc52.nix ./utils/nvim-osc52.nix
./utils/project-nvim.nix ./utils/project-nvim.nix
./utils/presence-nvim.nix
./utils/specs.nix ./utils/specs.nix
./utils/startify.nix ./utils/startify.nix
./utils/surround.nix ./utils/surround.nix

View file

@ -0,0 +1,186 @@
{
config,
pkgs,
lib,
...
}:
with lib; let
cfg = config.plugins.presence-nvim;
helpers = import ../helpers.nix {inherit lib;};
in {
options = {
plugins.presence-nvim =
helpers.extraOptionsOptions
// {
enable = mkEnableOption "Enable presence-nvim.";
package = helpers.mkPackageOption "presence-nvim" pkgs.vimPlugins.presence-nvim;
# General options.
autoUpdate = helpers.defaultNullOpts.mkBool true ''
Update activity based on autocmd events.
If `false`, map or manually execute
`:lua package.loaded.presence:update()`
'';
neovimImageText = helpers.defaultNullOpts.mkStr "The One True Text Editor" ''
Text displayed when hovered over the Neovim image.
'';
mainImage = helpers.defaultNullOpts.mkEnum ["neovim" "file"] "neovim" ''
Main image display.
'';
clientId = helpers.defaultNullOpts.mkStr "793271441293967371" ''
Use your own Discord application client id. (not recommended)
'';
logLevel = helpers.defaultNullOpts.mkEnum ["debug" "info" "warn" "error"] "null" ''
Log messages at or above this level.
'';
debounceTimeout = helpers.defaultNullOpts.mkInt 10 ''
Number of seconds to debounce events.
(or calls to `:lua package.loaded.presence:update(<filename>, true)`)
'';
enableLineNumber = helpers.defaultNullOpts.mkBool false ''
Displays the current line number instead of the current project.
'';
blacklist = helpers.defaultNullOpts.mkNullable (types.listOf types.str) "[]" ''
A list of strings or Lua patterns that disable Rich Presence if the
current file name, path, or workspace matches.
'';
buttons =
helpers.defaultNullOpts.mkNullable
(types.either helpers.rawType
(types.listOf (types.submodule {
options = {
label = helpers.mkNullOrOption types.str "";
url = helpers.mkNullOrOption types.str "";
};
})))
"[]"
''
Button configurations which will always appear in Rich Presence.
Can be a list of attribute sets, each with the following attributes:
`label`: The label of the button. e.g. `"GitHub Profile"`.
`url`: The URL the button leads to. e.g. `"https://github.com/<NAME>"`.
Can also be a lua function: `function(buffer: string, repo_url: string|nil): table)`
'';
fileAssets = helpers.mkNullOrOption (with types; attrsOf (listOf str)) ''
Custom file asset definitions keyed by file names and extensions.
List elements for each attribute (filetype):
`name`: The name of the asset shown as the title of the file in Discord.
`source`: The source of the asset, either an art asset key or the URL of an image asset.
Example:
```
{
# Use art assets uploaded in Discord application for the configured client id
js = [ "JavaScript" "javascript" ];
ts = [ "TypeScript" "typescript" ];
# Use image URLs
rs = [ "Rust" "https://www.rust-lang.org/logos/rust-logo-512x512.png" ];
go = [ "Go" "https://go.dev/blog/go-brand/Go-Logo/PNG/Go-Logo_Aqua.png" ];
};
```
'';
showTime = helpers.defaultNullOpts.mkBool true "Show the timer.";
# Rich presence text options.
editingText = helpers.defaultNullOpts.mkNullable (types.either types.str helpers.rawType) "Editing %s" ''
String rendered when an editable file is loaded in the buffer.
Can also be a lua function:
`function(filename: string): string`
'';
fileExplorerText = helpers.defaultNullOpts.mkNullable (types.either types.str helpers.rawType) "Browsing %s" ''
String rendered when browsing a file explorer.
Can also be a lua function:
`function(file_explorer_name: string): string`
'';
gitCommitText = helpers.defaultNullOpts.mkNullable (types.either types.str helpers.rawType) "Committing changes" ''
String rendered when committing changes in git.
Can also be a lua function:
`function(filename: string): string`
'';
pluginManagerText = helpers.defaultNullOpts.mkNullable (types.either types.str helpers.rawType) "Managing plugins" ''
String rendered when managing plugins.
Can also be a lua function:
`function(plugin_manager_name: string): string`
'';
readingText = helpers.defaultNullOpts.mkNullable (types.either types.str helpers.rawType) "Reading %s" ''
String rendered when a read-only/unmodifiable file is loaded into the buffer.
Can also be a lua function:
`function(filename: string): string`
'';
workspaceText = helpers.defaultNullOpts.mkNullable (types.either types.str helpers.rawType) "Working on %s" ''
String rendered when in a git repository.
Can also be a lua function:
`function(project_name: string|nil, filename: string): string`
'';
lineNumberText = helpers.defaultNullOpts.mkNullable (types.either types.str helpers.rawType) "Line %s out of %s" ''
String rendered when `enableLineNumber` is set to `true` to display the current line number.
Can also be a lua function:
`function(line_number: number, line_count: number): string`
'';
};
};
config = let
setupOptions =
{
# General options.
auto_update = cfg.autoUpdate;
neovim_image_text = cfg.neovimImageText;
main_image = cfg.mainImage;
client_id = cfg.clientId;
log_level = cfg.logLevel;
debounce_timeout = cfg.debounceTimeout;
enable_line_number = cfg.enableLineNumber;
blacklist = cfg.blacklist;
file_assets = cfg.fileAssets;
show_time = cfg.showTime;
buttons = cfg.buttons;
# Rich presence text options.
editing_text = cfg.editingText;
file_explorer_text = cfg.fileExplorerText;
git_commit_text = cfg.gitCommitText;
plugin_manager_text = cfg.pluginManagerText;
reading_text = cfg.readingText;
workspace_text = cfg.workspaceText;
line_number_text = cfg.lineNumberText;
}
// cfg.extraOptions;
in
mkIf cfg.enable {
extraPlugins = [cfg.package];
extraConfigLua = ''
require("presence").setup${helpers.toLuaObject setupOptions}
'';
};
}

View file

@ -0,0 +1,37 @@
{
empty = {
plugins.presence-nvim.enable = true;
};
defaults = {
plugins.presence-nvim = {
enable = true;
# General options.
autoUpdate = true;
neovimImageText = "The One True Text Editor";
mainImage = "neovim";
clientId = "793271441293967371";
logLevel = null;
debounceTimeout = 10;
enableLineNumber = false;
blacklist = [];
fileAssets = null;
showTime = true;
buttons = [];
# Rich presence text options.
editingText = "Editing %s";
fileExplorerText = "Browsing %s";
gitCommitText = "Committing changes";
pluginManagerText = "Managing plugins";
readingText = "Reading %s";
workspaceText = "Working on %s";
lineNumberText = "Line %s out of %s";
};
};
}