https://github.com/bbatsov/persp-projectile

Projectile integration for perspective.el
https://github.com/bbatsov/persp-projectile

Last synced: 13 days ago
JSON representation

Projectile integration for perspective.el

• Host: GitHub
• URL: https://github.com/bbatsov/persp-projectile
• Owner: bbatsov
• Created: 2015-12-20T12:29:40.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2021-06-18T07:13:42.000Z (over 3 years ago)
• Last Synced: 2024-08-01T19:39:28.238Z (3 months ago)
• Language: Emacs Lisp
• Size: 382 KB
• Stars: 120
• Watchers: 7
• Forks: 15
• Open Issues: 4
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![License GPL 3][badge-license]](http://www.gnu.org/licenses/gpl-3.0.txt)

[![MELPA](http://melpa.org/packages/persp-projectile-badge.svg)](http://melpa.org/#/persp-projectile)

[![MELPA Stable](http://stable.melpa.org/packages/persp-projectile-badge.svg)](http://stable.melpa.org/#/persp-projectile)

## persp-projectile

[Perspective](https://github.com/nex3/perspective-el) is a minor mode

that provides the ability to manage different workspaces. If you need

to open many projects at the same time, perspective can help you keep

each project related buffers and windows setting separate from other

projects, similar to multiple spaces on MacOS, which allows you to

focus on the files of the current active project.

A picture says a thousand words. See below screenshot to get a concrete idea.

Only current project related files showing in minibuffer when I call

`ido-switch-buffer`, and an indicator in mode line tells me which

project that I'm in.

![Persp-Projectile Screenshot 1](screenshots/persp-projectile1.png)

When I switch to a different project, I get a clean 'perspective'.

![Persp-Projectile Screenshot 2](screenshots/persp-projectile2.png)

To integrate perspective with Projectile, first of all, you need to

install perspective. You can install it by:

```

M-x package-install

```

Alternatively, users of Debian 9 or later or Ubuntu 16.04 or later can

`apt-get install elpa-persp-projectile`.

Then type `perspective` in the minibuffer, as below:

```

Install package: perspective

```

Secondly, make sure `persp-projectile.el` is in your Emacs load path. Then require it in your init file.

```el

(persp-mode)

(require 'persp-projectile)

```

You're ready to go! Try the interactive command

`projectile-persp-switch-project`, or you may also bind it to some

handy keybinding.

```el

(define-key projectile-mode-map (kbd "s-s") 'projectile-persp-switch-project)

```

## Known issues

Check out the project's

[issue list](https://github.com/bbatsov/persp-projectile/issues?sort=created&direction=desc&state=open)

a list of unresolved issues. By the way - feel free to fix any of them

and send me a pull request. :-)

## Contributors

Here's a [list](https://github.com/bbatsov/persp-projectile/contributors) of all the people who have contributed to the

development of persp-projectile.

## License

Copyright © 2014-2021 Bozhidar Batsov and

[contributors](https://github.com/bbatsov/persp-projectile/contributors).

Distributed under the GNU General Public License, version 3

[badge-license]: https://img.shields.io/badge/license-GPL_3-green.svg