Code Monkey home page Code Monkey logo

zeesh-man's Introduction

zeesh-man - Tiny, Simple ZSH Plugin Manager

Story behind zeesh-man:

Before, I have been manually managing Zsh plugins in my .zshrc file. Sourcing them and updating them occasionally was fairly easy for me because I had only 2 plugins. The burden was not much: making sure my plugins are sourced in my zshrc file correctly and updated regularly.

Recently, I wanted to add more plugins to my Zsh setup and I felt like it is time for a plugin manager. However, what I wanted was a very simple plugin manager with minimal overhead. Just downloading the plugin and sourcing it. As well as, allowing me to update it with a single command.

These needs created the zeesh-man

Therefore, zeesh-man is able to do 3 things:

  1. Download a plugin from GitHub
  2. Source a downloaded plugin
  3. Update all sourced plugins

Installation

Bootstrapping (Recommended)

If you want to automatically install and set up zeesh-man:

Copy this in to your .zshrc file:

# Install zeesh-man if not already installed.
zeesh_dir=${XDG_DATA_HOME:-"$HOME/.local/share"}/zeesh/zeesh-man
if [[ ! -f $zeesh_dir/zeesh.zsh ]]; then
  command git clone https://github.com/zahidkizmaz/zeesh-man.git "$zeesh_dir"
fi
source "$zeesh_dir/zeesh.zsh"

# Example plugin definitions:
zeesh_get "zsh-users/zsh-syntax-highlighting"
zeesh_get "zsh-users/zsh-autosuggestions"

Manual

Step 1

Clone the repository:

git clone https://github.com/zahidkizmaz/zeesh-man.git ${XDG_DATA_HOME:-"$HOME/.local/share"}/zeesh/zeesh-man

Step 2

Source zeesh-man in your .zshrc:

source ${XDG_DATA_HOME:-"$HOME/.local/share"}/zeesh/zeesh-man/zeesh.zsh

Installing plugins

In .zshrc file:

source $HOME/.zeesh-man/zeesh.zsh

# After sourcing the zeesh-man
zeesh_get "zsh-users/zsh-syntax-highlighting"
zeesh_get "zsh-users/zsh-autosuggestions"

Updating plugins

In your terminal run this command to update your plugins and zeesh-man:

zeesh-update

Configuring zeesh-man

  • Debug mode can be enabled by export ZEESH_DEBUG=1.
  • Dry run mode can be enabled by export ZEESH_DRY_RUN=1.

WARNING!

zeesh-man is at experimental state. Please use it at your own risk! Bug reports/fixes are highly appreciated.

zeesh-man's People

Contributors

zahidkizmaz avatar

Stargazers

 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.