Git Product home page Git Product logo

cloak.nvim's Introduction

Cloak.nvim

Cloak allows you to overlay *'s (or any other character) over defined patterns in defined files.

It also disables 'cmp' for the buffer(if it is installed).

Demo

Demo

Configuration

Here is the default configuration.

  • file_pattern can be a string or table of strings, they should be valid autocommand patterns.
  • cloak_pattern is a lua pattern ran over every line in the buffer, overlaying cloak_character over the match, excluding the first character.
  • replace is a pattern with wich to replace the matched cloak_pattern (see [https://www.lua.org/manual/5.1/manual.html#pdf-string.gsub]). If the replaced text is not long enough the rest gets filled up with the cloak_character. This is useful to only hide certain keys but still show the name.
require('cloak').setup({
  enabled = true,
  cloak_character = '*',
  -- The applied highlight group (colors) on the cloaking, see `:h highlight`.
  highlight_group = 'Comment',
  -- Applies the length of the replacement characters for all matched
  -- patterns, defaults to the length of the matched pattern.
  cloak_length = nil, -- Provide a number if you want to hide the true length of the value.
  -- Wether it should try every pattern to find the best fit or stop after the first.
  try_all_patterns = true,
  patterns = {
    {
      -- Match any file starting with '.env'.
      -- This can be a table to match multiple file patterns.
      file_pattern = '.env*',
      -- Match an equals sign and any character after it.
      -- This can also be a table of patterns to cloak,
      -- example: cloak_pattern = { ':.+', '-.+' } for yaml files.
      cloak_pattern = '=.+',
      -- A function, table or string to generate the replacement.
      -- The actual replacement will contain the 'cloak_character'
      -- where it doesn't cover the original text.
      -- If left emtpy the legacy behavior of keeping the first character is retained.
      replace = nil,
    },
  },
})

The cloak_pattern can also be a table of inner_patterns:

patterns = {
  file_pattern = '.env*',
  cloak_pattern = {
    '(a=).+',
    { '(b=).+' },
    { '(c=).+', replace = '[inner] %1' }
    -- The outer `replace` could also be specified here instead
  },
  replace = '[outer] %1',
}

This would result in a cloaking of text like this:

[outer] a=**
b***********
[inner] c=**

The original file was:

a=1234567890
b=1234567890
c=1234567890

Usage

The plugin automatically activates when a file matched by the patterns is opened.

You do have to call the setup() function.

:CloakDisable, :CloakEnable and :CloakToggle are also available to change cloaking state.

cloak.nvim's People

Contributors

laytan avatar jokesper avatar gordin avatar philippheuer avatar chalop avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.