Project

prj

0.0
Low commit activity in last 3 years
A long-lived project that still receives updates
Prj is an utility to quickly go to project directory using fuzzy matching
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 13.0
~> 3.4
~> 0.22
 Project Readme

Prj

Build Status Code Climate Gem Version

Cd to your project the right way!

Prj chooses a project directory based on fuzzy matching.

It finds a project directory (a directory with .git/ or other vcs directory inside) such that it's name contains supplied letters in given order. The search is scoped by projects root directory, which is specified in ~/.prj.yml config file (Default: ~/Projects). See Installation & Configuration section.

now even faster with C extension

Installation & Configuration:

  1. Install the gem:

    gem install prj

  2. Configure your shell:

  • (oh-my-zsh users) Put scripts/zsh/prj.plugin.zsh into ~/.oh-my-zsh/custom/plugins/prj/prj.plugin.zsh. Don't forget to enable the plugin in ~/.zshrc

  • (bash users) Add the following snippet to your .bash_profile:

    function p() {
        builtin cd "$(prj $1)"
    }
    
  1. Put a project root directory name into ~/.prj.yml, i.e:
    projects_root: ~/Projects
    case_sensitive: false                 # default: true
    search_nested_repositories: false     # default: false (slower if true)
    vcs_directories:                      # default: [.git]
      - .git
      - .svn
      - .hg
    

Usage:

With the following directory structure

~/
  Projects/
    my_super_project/
    rails/
    love_hate_unicorns/

You can reach ~/Projects/my_super_project with p msp