Atlas includes extremely useful search capabilities accessible through the search view. This will search the contents of all files within the workspace. To open this view click this icon:
To perform a basic search, type the text you would like to search for in the search bar. Searching will automatically happen as you start typing and will display the results below the search bar.
Find and Replace
To search for text that you would like to replace across the whole workspace, click the expand button next to the search bar and enter the text you would like to replace, and the text you would like to replace it with. If you are satisfied with the potential results, click the Replace All button to the right of the replace text box. You will be asked to confirm the action, as it will potentially make many changes that are not easily undone.
To learn how to scope a replace action to a single file, see the Find and Replace section under the Editor section
By default, the search terms used are case-insensitive. If you would like to search in a case sensitive manner you can toggle case sensitivity by pressing this button.
By default, the search terms used will match any sequence of characters, regardless of word boundary. If you want to search for whole words specifically then you can toggle this by pressing this button.
Regular Expression Search
For more involved searching you can use regular expressions. For instance, if you wanted to find a phrase that started with the word teams and ended with the word league then you could accomplish this by putting the regular expression
in the search box and clicking this button.
Including Ignored Files
Atlas workspaces have the ability to connect to GIT source control projects. In a GIT project there can be files that are ignored by putting references to them in a file called .gitignore. This will tell the source control engine to not consider them when tracking files. If you want to search files that are in this ignored list, click on this button.
In searching you can limit the files you want to search in. This can be very helpful in particular when your models generate files themselves and/or you have a lot of models. Open up the details section by clicking on the ellipses below the search bar.
You will then see two input boxes for including and excluding files.
Files To Include
If you want work off of a specific list of files (a white list), you can list the files you want to include here. You can do this with a comma-delimited list of files (myFirstModel.py, mySecondModel.py) or by regular expression (*.py)
Files To Exclude
If you want to search all files except ones you specify (a black list), you can list the files you want to exclude here. You can do this with a comma-delimited list of files (myFirstModel.py, mySecondModel.py) or by regular expression (*.py)
If files have changed since your last search and you want to update the list of results, click this button to refresh your search.
To reset your search and try again, you can either remove your search term or click this button to clear your search.
Collapse All Results
Your search results are presented in a file tree, with the first level entries being the files themselves that have the results, and the sub-level entries being the individual search matches. Many times you will get many results in many files and you can automatically collapse all the files by pressing this button.
Dismiss Search Result
In cases where you have many search results and you need to hone in on one, or a few, it is useful to be able to dismiss individual results. You can accomplish this by putting your mouse over a top level result and clicking the X that appears on the right.