[[PageOutline(2-5,Contents,pullout)]]

= Full text search in multiple repositories 

== Description

This plugin implements full text search on source code across multiple repositories in Trac 0.12+. It is derived from the RepoSearchPlugin.

Key features:
 1. It works on multiple repositories, and any repository type supported by Trac.
 1. Pluggable search backends.
 1. Default search backend caches source text in the Trac database.

Usage note: to search for a string containing double quotes, enclose the whole string in single quotes, for example `'draft="true"'`.

== Bugs/Feature Requests

Existing bugs and feature requests for MultiRepoSearchPlugin are 
[report:9?COMPONENT=MultiRepoSearchPlugin here].

If you have any issues, create a 
[/newticket?component=MultiRepoSearchPlugin new ticket].

[[TicketQuery(component=MultiRepoSearchPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [https://github.com/trac-hacks/trac-MultiRepoSearchPlugin/tags here].

== Source

You can clone MultiRepoSearchPlugin from [git://github.com/trac-hacks/trac-MultiRepoSearchPlugin.git here] using Git, or [https://github.com/trac-hacks/trac-MultiRepoSearchPlugin browse the source] with Github.

== Installation

To install:

{{{#!sh
pip install -r requirements.txt
python setup.py develop
}}}

Alternatively, to install using easy_install on Ubuntu 11.10 Server:

{{{#!sh
sudo easy_install https://trac-hacks.org/svn/tracsqlhelperscript/0.12/
sudo easy_install https://github.com/trac-hacks/trac-MultiRepoSearchPlugin/tarball/0.2.1
}}}

Add to your `conf/trac.ini` file:
{{{#!ini
[components]
multireposearch.* = enabled
}}}

Upgrade your Trac environment:
{{{#!sh
trac-admin path/to/env upgrade
}}}

Prepare all available repositories with an initial indexing:
{{{#!sh
trac-admin path/to/env multireposearch reindex_all
}}}

Users with `REPO_SEARCH` and/or `TRAC_ADMIN` permissions will now be able to perform text searches of repository contents through the Trac search UI.

== Configuration

As long as you have your Trac post-commit or post-receive hooks properly configured, the source will remain up-to-date.

Otherwise, to manually reindex a single repository, you can run:
{{{#!sh
trac-admin path/to/env multireposearch reindex repo-name
}}}

Where repo-name is the name assigned to your repository in Trac.

== Author/Contributors

'''Author:''' [wiki:ejucovy] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''