Git Product home page Git Product logo

swim's Introduction

swim logo

switch vimrc files instantly


Demo

demo fig


Why

Trying out and switching vimrc's shouldn't be hard. It shouldn't require several mv's combined with a wget. Most importantly, it shouldn't stop you from always having the perfect vim configuration so you can be efficient.

swim add vimrc's directly from the internet

or locally and alias your vimrc's with names that are easy to remember. Swim entirely replaces the need for per-directory vimrc's, headers, and external vimrc configs.

Install

Backup your files before swimming

curl -s https://raw.githubusercontent.com/dawsonbotsford/swim/master/install | bash

Examples

  swim add ~/dotfiles/myVimrc favorite    #Add new swim alias
  swim ls                                 #Show available swim aliases
  swim add https://raw.githubusercontent.com/dawsonbotsford/swim/master/exampleVimrcs/vimrcWikia.vim example
  swim with favorite         #Set alias favorite as primary .vimrc
  swim with main             #Set alias main as primary .vimrc

Update

swim update       #Update to the newest version of swim

Available Commands

swim add <URLToRaw or pathToFile>  <alias>   #Add a swim alias
swim with <alias>                            #Change active vimrc file
swim ls                                      #List aliased vimrc files
swim active                                  #Show currently aliased vimrc
swim vim <alias>                             #Edit the vimrc stored at alias

swim mv <alias1> <alias2>                    #Rename alias (like Linux mv)
swim rm <alias>                              #Delete an alias entirely
swim update                                  #Download newest version
swim version                                 #Print version
swim help                                    #Print this message

FAQ

  • Where does swim store my vimrc files?
    • swim stores your vimrc files in ~/.swim. You can edit the vimrc files with swim vim <alias> or edit them manually from their file location.

  • Can I set a custom executable location?
  • Yes, the default install location of the swim executable is /usr/local/bin, but if you would like a custom location, simply set the environmental variable named usrDir.
  • Example: export usrDir="/usr/sbin" (That only needs to be set for when you perform the swim install. So no need to set this in your bashrc or zshrc)

  • Does swim support emacs?
    • No, but pull requests are always welcome :)

  • Can I call swim within vim?
    • It may be possible to hack together a several command :! solution at the moment, but there is not a supported method.

Requirements

  • node.js and npm (to auto-install chalk-cli)

Changelog

  • 0.4.0: Custom executable install location
  • 0.3.2-prelaunch: Prelaunch Beta Testing

swim's People

Contributors

dawsbot avatar kawakami-o3-2nd avatar

Watchers

James Cloos 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.