#GUID

This plugin makes working with Globally Unique Identifiers easier in Neovim. Generated GUIDs conform to the RFC 4122 spec for pseudo-random identifiers.

#Configuration

The plugin is configured via the setup function. Options may be provided to change the default settings shown below.

require('guid').setup({
    default = 'd',
    styles = {
        n = '????????????????????????????????',
        d = '????????-????-????-????-????????????',
        b = '{????????-????-????-????-????????????}',
        p = '(????????-????-????-????-????????????)',
        x = '{0x????????,0x????,0x????,{0x??,0x??,0x??,0x??,0x??,0x??,0x??,0x??}}',
    },
})

#default

Specifies which format to use if one is not provided for GuidInsert, GuidAppend, and GuidFormat commands.

#styles

Specifies template map used for parsing and printing GUIDs. The question marks are placeholders for hexadecimal characters.

#Formatting

The format specifier syntax outlined by Guid.ToString is borrowed for the default GUID styles. The casing of the format specifier determines whether lowercase or uppercase will be used. You can modify these mappings and introduce new GUID styles as you see fit.

#Commands

Commands are not mapped by default; an example set of bindings is shown below:

vim.keymap.set({'x', 'o'}, 'ag', ':<c-u>GuidObject<cr>', {noremap = true, silent = true})

#GuidInsert [format]

Inserts a GUID at the cursor position using the optionally provided format.

#GuidAppend [format]

Appends a GUID at the cursor position using the optionally provided format.

#GuidFormat [format]

Formats the GUID at the cursor position using the optionally provided format.

#GuidSpin [range]

Regenerates the selected GUIDs while preserving their style. GUIDs are bucketed by their value, meaning that identical GUIDs will still have matching (but new) values after after this operation.

#GuidObject

Selects the GUID at the cursor position.