andrewraycode / vim-project

lcd to the root of the project everytime you BufEnter a file inside a project.

News

• New feature project#utils#alternate. To alternate between file.ext and file_suffix.ext or fileSuffix.ext with the command :A
• Windows support added

Introduction

A Project is made of :

• One directory (the root of the project)
• One title (by default the last part of the the root of the project)
• One or more callbacks

Everytime you open a file nested in the root of the project

• the local current directory is changed to the root of the project
• the guitablabel is set to the title of the project
• the callbacks of the project are executed

Commands

There are four commands :

• Project It's used inside the .vimrc. The first parameter is the path to the project. The second parameter is optional and it is the title of the project and the default value of it is the last part of the name of the directory containing the project. If the path to the project is a relative path, it's combined with the starting path. The starting path is defined when you initialize the plugin :

set rtp+=~/.vim/bundle/vim-project/
" custom starting path
call project#rc("~/Code")
" default starting path (the home directory)
call project#rc()

• ProjectPath It's used inside the cmdline mode. The first parameter is the path without quotation. The second parameter is optional and it is the title of the project without quotation. If the path to the project is a relative path, it's combined with current working directory and not with the starting path.
• File It's used inside the .vimrc. The first parameter is the path to the file. The second parameter is the title of the file. This command doesn't change the local current directory.
• Callback It's used inside the .vimrc. The first parameter is the title of a project already defined with Project or File. The second parameter is the name a function or an array of function names. This function or these functions are callbacks and they are executed everytime a file nested in the root of the project is opened with one parameter that is the title of the project.
• Welcome It's the Startify equivalent. If you don't want Welcome to appear when you start vim:

" before call project#rc()
let g:project_enable_welcome = 0
" if you want the NERDTree integration.
let g:project_use_nerdtree = 1

set rtp+=~/.vim/bundle/vim-project/
call project#rc("~/Code")

Callbacks

The command Callback accepts a string (the name of the function). The function project#config#callback accepts string or dictionary. If it's a dictionary, the method invoke(title) is called on the dictionary.

" For more information on dictionary and prototype programming in vim :
:h self

The function project#utils#alternate can be used together with project#config#callback. It returns a dictionary. This dictionary has the method invoke(title) that creates <buffer> commands to switch to the alternate files like the plugin vim-rake.

" :A :AE :AS :AV :AT :AD :AR . They all accept the bang (!)
" Remembet that the title of the project is only the last dir of the path
Project  'nugg.ad/nuggad-compiler'

" project#utils#alternate returns a dictionary with a method ``invoke(title)``.
"
" everytime we open a file inside the project if the path starts with
" ``spec`` or ``src`` the commands :A are defined.
"
" +_spec means add _spec to the file
" -_spec means remove _spec to the file
call project#config#callback("nuggad-compiler", project#utils#alternate(
  \  [{'regex': '^src', 'string': 'spec', 'suffix': '+_spec'},
  \   {'regex': '^spec', 'string': 'src', 'suffix': '-_spec'}]
  \  ))

Install

If you use Vundle you can install this plugin using Vim command :BundleInstall amiorin/vim-project. Don't forget put a line Bundle 'amiorin/vim-project' in your .vimrc.

If you use Pathogen, you just execute following:

cd ~/.vim/bundle
git clone https://github.com/amiorin/vim-project.git

If you don't use either plugin management system, copy the plugin directory to your .vim directory.

*nix: $HOME/.vim Windows: $HOME/vimfiles

Configure

• Enable NERDTree integration.

  let g:project_use_nerdtree = 1

• Do not show the project browser as a buffer in the buffer list (uses nobuflisted)

  let g:project_unlisted_buffer = 1

• Disable the project browsing screen on starting Vim

  let g:project_enable_welcome = 0

• Do not change tab titles to project names

  let g:project_disable_tab_title = 1

sample .vimrc:

let g:project_use_nerdtree = 1
set rtp+=~/.vim/bundle/vim-project/
call project#rc("~/Code")

Project  'scratch'

Project  'dotfiles'
File     'dotfiles/vimrc'                       , 'vimrc'
File     'dotfiles/gvimrc'                      , 'gvimrc'
File     'dotfiles/zshrc'                       , 'zshrc'

Project  'gollum'
File     'gollum/Todo.md'                       , 'todo'
Callback 'gollum'                               , 'RemoveTextWidth'

function! RemoveTextWidth(...) abort
  setlocal textwidth=0
endfunction

Project  'octopress'
Project  'gsource'
Project  'markup'
Project  'glib'
Project  'reloadlive'
Project  'flashcards'
Project  'leitner'
Callback 'leitner'                              , ['AddSpecToPath', 'RemoveTextWidth']

function! AddSpecToPath(tile) abort
  setlocal path+=spec
endfunction

Project  '~/.vim/bundle/vim-fenced-code-blocks' , 'fenced'
Project  '~/.vim/bundle/vim-project'            , 'project'
Project  '~/.vim/bundle/vim-bookmarks'          , 'bookmarks'
Project  '~/.vim/bundle/ctrlp.vim'              , 'ctrlp'
Project  '~/.vim/bundle/ctrlp-z'                , 'ctrlp-z'
Project  '~/.vim/bundle/vim-eval'               , 'eval'

Interactive

From the cmdline mode.

ProjectPath uses the cwd and the arguments are not quoted.

:ProjectPath .
:ProjectPath /etc myconfig

Self-Promotion

Like this plugin?

• Star the repository on GitHub
• Follow me on
  • Twitter
  • GitHub
  • Blog