Manual

Introduction

The first thing to know of pygrep is the screen distribution. There is a window with a text box and two buttons over some tabs. When you want, you can write some thing in the box and click on "Search", "Search Again" or type Intro to perform a search. In this case, the "Tab Search" will be shown automatically.

Now, I am going to describe each tab.

Search Tab

You can see two tables: upper one has the list of matching files, with the number of matchs in each file. Lower, you will see the matching lines in the file which was selected on the upper table.

If you double-click on a file, this will open; if you do it on the line of a file, it will open too, selecting the file line directly.

You can choose between the pygrep search engine or grep one.

Directories Tab

There are two tabs for configuration: directories and options. I split them to avoid too many data in the same window.

There are 3 tables:

• Upper one: Directories in which you want to search. Be careful: Pygrep will launch a thread for each entry, so it is not recomended to add more than 3 or 4 directories or the search will be slower.
• Low left table: files to include. You can use special characters, such as "*" or "?" to search "anything" or "any character" respectively. I'm afraid all the path is checked; because of this, I recommend to add an asterisk "*" at the begining of all the entries. Maybe this will be fixed in next releases. Pygrep will search only in these files. If this table is empty, Pygrep will search in all the files.
• Low right table: Directories and files to exclude. It is useful to optimize the searchs.

Options Tab

Here is where searchs are configured. If you want to ignore the case, search as a regular expresion or search for whole words. You can ignore too big files too.

The most complicated part can be "Command to execute". Here I left some help: you must insert the command to execute where a file/line is selected at "Search Tab". Change the command line to configure your favourite editor. Some examples are shown. Some codes will be translated, as it is explained in the right column.

History Tab

Each search made in a session will add a line in this table. It is true there are autocompletion in search box, but it is possible that you do not remember the beginning of the wanted pattern.

This window offers you the possibility to save some entries to later use. You only have to check the check button at the left, so that, when you will re-open Pygrep, you will have that entry saved.