P4 Search

Overview

This project was created to automate the searching of files on Perforce Helix Core to easily locate existing Extron Python device drivers containing specific patterns. Due to lack of admin privileges on my work computer, I was unable to use the P4Python library, so instead I leveraged Python to send CLI grep commands to workaround this limitation. Although this is not the most ideal or efficient approach, it did at least provide a solution to my problem.

Description

An intuitive GUI-based Python application allowing a user to effortlessly search files on Perforce Helix Core utilizing specific search patterns.

Features

• Ability to search using literal text or regular expression patterns
• Option to select case sensitivity of search patterns
• Line number references to the original file
• User-friendly message boxes and tooltips to guide users step-by-step

Download latest released version here

Usage

Path field:

• Specifies the folder path to search.

Pattern field using literal text:

• Specifies the literal text to match.

Pattern field using regular expression:

• Specifies the regular expression to match.

Case Sensitive checkbox:

• Specifies the case sensitivity of search pattern.

Search button:

• Initiates the file search.
• The Enter key can also be used.

Status label:

• Shows the progress of the file search.
  • Idle means no file search is currently being performed.
  • In Progress means the file search is in progress.
  • Completed means the file search has completed successfully.

Version label:

• Shows the current version of the application.

Examples

Output example with matches found:

Output example with no matches found:

Error Messages

Missing path field:

• Indicates the Path field is empty.

Invalid path field:

• Indicates the Path field contains an invalid folder path.

Missing pattern field:

• Indicates the Pattern field is empty.

User not logged in:

• Indicates the user is not logged in.
• Open the Perforce Helix Visual Client (P4V) software to login and then select the Retry button.
• Selecting the Cancel button will close the error message.

User session expired:

• Indicates the current user session has expired.
• Open the Perforce Helix Visual Client (P4V) software to login and then select the Retry button.
• Selecting the Cancel button will close the error message.

No such client:

• Indicates the client (or user) lacks permission to access local files.
• Either create a new workspace and specify the correct client for 'Workspace name' field, or edit existing workspace.
  • Note: Editing an existing workspace may cause local workspace files to no longer be available.
• Selecting the Cancel button will close the error message.

Client root conflict:

• Indicates the Path field points to a different folder that isn't the client's root.
• Either create a new workspace and specify the desired folder path for 'Workspace root' field, or edit existing workspace.
  • Note: Editing an existing workspace may cause local workspace files to no longer be available.
• Selecting the Cancel button will close the error message.

Dependencies

• Python 3.6 or above
• PySimpleGUI 4.60.5
• Windows

License

Licensed under the MIT License