Skip to main content

Automagic ctrl+t filename completion to launch in your favorite editor

Project description

completeme

TL;DR

Linux:

  • $ sudo pip install completeme
  • $ echo “source `which setup_completeme_key_binding.sh`” >> ~/.bashrc
  • $ source ~/.bashrc

OS X:

  • $ sudo brew install bash # see note below about OS X and bash 4
  • $ sudo pip install completeme
  • $ echo “source `which setup_completeme_key_binding.sh`” >> ~/.profile
  • $ source ~/.profile

Windows:

Description

completeme is a python script to auto-complete filenames in a given directory, much like Github’s ‘t’ keyboard shortcut or Command-T in TextMate or SublimeText. When you’ve settled on the file you’d like to edit, press “Enter” to open it with whatever’s in your $EDITOR variable or press “Tab” to drop that filename at the end of your current command!

To change your search directory, simply prefix your query. That is, start your string with “../” to search your current working directory’s parent or “/tmp/” to search “/tmp/”. Note that the trailing slash is what triggers the directory change. If your current search directory is a git repository, this will respect your .gitignore.

Make sure to add “source `which setup_completeme_key_binding.sh`” to your .bashrc to enable Ctrl+t support!

Configuration

completeme comes with (wherever-pip-installs-the-completeme-python-package)/completeme.json, which you can use to, well, configure your completeme experience.

  • include_directories (default=true) indicates whether we should also display directories (not just files).
  • find_hidden_directories (default=false) indicates whether we should search inside dot directories (assuming we didn’t find a git repository). These are things like .config/, .vim/, etc.
  • find_hidden_files (default=false) indicates whether we should find files that start with a dot (assuming we didn’t find a git repository). These are things like .emacs, .xinitrc, .DS_Store, etc.

Known Issues

  • Mac OS X ships with bash 3.2, which doesn’t use the READLINE_LINE or READLINE_POINT variables. Unless you upgrade, you won’t be able to use the tab-functionality to drop the filename back into the prompt! Fortunately, brew install bash will give you a compatible version!

License

This software is licensed under the WtHYWv2 (Whatever the Hell You Want, v2). Please throw some credit around if it’s deserved.

Thanks

Thank you to all who have contributed ideas and feedback. Special thanks to those listed below!

Project details


Release history Release notifications

History Node

0.5.14

History Node

0.5.12

History Node

0.5.11

History Node

0.5.10

This version
History Node

0.5.9

History Node

0.5.8

History Node

0.5.7

History Node

0.5.6

History Node

0.5.5

History Node

0.5.4

History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.10

History Node

0.4.9

History Node

0.4.8

History Node

0.4.7

History Node

0.4.6

History Node

0.4.5

History Node

0.4.4

History Node

0.4.3

History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

History Node

0.3.8

History Node

0.3.7

History Node

0.3.6

History Node

0.3.5

History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.5

History Node

0.2.4

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.12

History Node

0.1.11

History Node

0.1.10

History Node

0.1.9

History Node

0.1.8

History Node

0.1.7

History Node

0.1.6

History Node

0.1.4

History Node

0.1.2

History Node

0.1.1

History Node

0.1.0

History Node

0.0.10

History Node

0.0.9

History Node

0.0.8

History Node

0.0.7

History Node

0.0.6

History Node

0.0.5

History Node

0.0.4

History Node

0.0.3

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
completeme-0.5.9.tar.gz (14.0 kB) Copy SHA256 hash SHA256 Source None Sep 2, 2013

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page