# Code Search

> Learn how to use Code Search to find and track code across your development workspace

## Introduction

Code Search is a feature in the Development workspace that helps data builders search through their codebase efficiently. Whether you're trying to discover existing code patterns, track data lineage, or perform refactoring tasks, Code Search provides the tools you need.

## Use Cases

- **Code Discovery:** 
    * Search by description, label, and other criteria
    * Filter result by type or other properties
- **Data Lineage Tracing:** Find every file where a dataset, model, metric,... is referred to
- **Refactoring:** Replace search results with another piece of code

## Full Code Search Tutorial

<figure class='video-container'>
  <iframe width="100%" src="https://www.youtube.com/embed/JCciDgPe6Hs?si=C64veCpeklrf4l1Q" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
</figure>

<!-- 
## Key Features

### Basic Search
- Search for any string of code across your entire codebase
- Results show file locations and line numbers where matches are found
- Preview of the matching code with surrounding context
- Real-time search results as you type

### Advanced Search with Filters
Code Search supports advanced filtering syntax to help you narrow down results:
- Filter by file type
- Filter by directory
- Filter by specific patterns
- Case-sensitive/insensitive search options

### Code Replace
The Code Replace functionality enables you to:
- Perform bulk replacements across multiple files
- Preview changes before applying them
- Track replacement history
- Safely refactor code with confidence 
-->

## Using Code Search

### Basic Search

1. Navigate to the Development workspace
2. Click on the Code Search icon or use the keyboard shortcut
3. Enter your search term
4. Results will appear in real-time, showing:
   - File name
   - Line numbers
   - Code context
   - Matching highlights

### Advanced Search Syntax
Use these filters to refine your search:

   - **```type:model + {keyword}```**: Search for keyword only in model.aml files (same for dataset, dashboard)
   - **```type:metric + {keyword}```**: Search for metrics where metric name contains keyword (same for dimension, measure)
   - **```datasource:{keyword}```**: Search files where ```data_source_name``` attribute contains keyword
   - **```owner:{keyword}```**: Search files where ```owner``` attribute contains keyword

### Performing Code Replace

1. Enter your search term
2. Click on the "Replace" option
3. Enter the replacement text
4. Preview the changes
5. Apply the replacement

<!-- 
## Best Practices

1. **Start Broad, Then Refine**
   - Begin with basic searches
   - Use filters to narrow results
   - Combine multiple filters for precision

2. **Preview Before Replace**
   - Always review the preview when using Code Replace
   - Check for unintended matches
   - Verify the context of each change

3. **Use Advanced Filters**
   - Leverage file type filters for specific searches
   - Combine path filters to focus on relevant directories
   - Use case sensitivity when needed 
-->

## Tips and Tricks

- When in Development, use keyboard shortcuts `Ctrl/Cmd + Shift + F` to quickly navigate to the Code Search tab
- You can combine several filters while searching.

<!-- 
## Limitations

- Filtering out / Exclusion
- Performance considerations for large codebases 
-->