ThinkingSphinx::Ports

Automatically assign Sphinx ports to multiple apps using Thinking Sphinx on the one machine. This is useful if you have many apps on your development machine that use Sphinx and Thinking Sphinx, and you don't want to worry about making sure the port you've assigned for it isn't being used elsewhere.

This library is aimed development and test environments - each app and environment gets a unique port, to avoid any conflicts.

Installation

Add this line to your application's Gemfile:

gem 'thinking-sphinx-ports', '~> 0.1.2', :groups => [:development, :test]

This gem is not meant for use in production environments. Indeed, it may override your environment-specific settings, so make sure you be specific in the environments it should be loaded within.

Usage

Beyond adding it to your Gemfile, there's nothing else you need to do for Rails applications. Thinking Sphinx will automatically be assigned a unique port based on its environment and path.

If you have Sphinx daemons running on your machine already, stopping those daemons and then running rake ts:configure ts:start is recommended - this will have the daemon using their newly assigned port.

If you want to use this gem with non-Rails apps, then you'll want something along the lines of this code to run while you're app is booting up:

# for non-Rails apps only
ThinkingSphinx::Ports.call [Dir.pwd, ENV['RACK_ENV']]

Modify those variables as you wish - the important part is that overall argument for ThinkingSphinx::Ports.call be unique for the given app and environment.

For the extra curious, the path/environment and port pairings are saved to ~/.thinking_sphinx_ports.yml.

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/pat/thinking-sphinx-ports. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Licence

Copyright (c) 2016, ThinkingSphinx::Ports is developed and maintained by Pat Allan, and is released under the open MIT Licence.