Finds files related to the current file based on user-defined configuration rules.
- Adds a
Show Related Files command (findrelated.show) with a shortcut of alt+r to show a quick pick menu of files related to the active file
Basic support for the following languages/frameworks is built-in:
- minified CSS/JS files
- C, C++, C#
- ASP.NET
- ASP.NET MVC
- Aurelia
- Delphi
- Elixir
- Phoenix framework
- XAML
Please open new Github issues with any rules you'd like included in the built-in ruleset.
Screenshot
Example ruleset
[
{
"name": "minified",
"rules": [
{
"pattern": "(.*?)(\\.min)?\\.(js|css)(?:\\.map)?$",
"locators": ["{$1.$3,$1.min.$3,$1.$3.map,$1.min.$3.map}"]
}
]
}
]
pattern - specifies a regex pattern to which this rule applies; Capture groups can be used as replacements in the locators
locators - specifies the list of glob pattern locators that will be used to search for related files; $[0-9] can be use as replacement tokens from the capture groups in the pattern
Extension Settings
| Name |
Description |
findrelated.rulesets |
Defines rulesets that can be used find related files; Will be merged with findrelated.workspaceRulesets and built-in rulesets |
findrelated.workspaceRulesets |
Defines workspace-specific rulesets that can be used find related files; Will be merged with findrelated.rulesets and built-in rulesets |
findrelated.applyRulesets |
Specifies the rulesets to use to find related files |
findrelated.applyWorkspaceRules |
Specifies the workspace-specific rulesets to use to find related files |
findrelated.autoOpen |
Specifies whether to automatically open the related file if there is only 1 result |
findrelated.autoPreview |
Specifies whether to automatically preview related files upon selection |
findrelated.ignoreExcludes |
Specifies whether to ignore file excludes when searching for related files |
findrelated.openPreview |
Specifies whether or not to open the related file in a preview tab |
findrelated.openSideBySide |
Specifies whether to open the related file to the side |
findrelated.outputLevel |
Specifies how much (if any) output will be sent to the FindRelated output channel |
Extension API
Find Related Files exports an API that can be used to expand its capabilities.
Example
let findRelated = extensions.getExtension('amodio.find-related');
let api = findRelated.exports;
let subscription1 = api.registerRuleset('static-rule', [
{
pattern: /* string -- regex pattern here */,
locators: [/* string -- glob patterns here */]
}
]);
let subscription2 = api.registerRuleset('dynamic-rule', [
{
match: (fileName: string) => /* matching logic here -- return a boolean */,
provideRelated: (fileName: string, document: TextDocument, rootPath: string) => {
return Promise.resolve([/* related uris here */]);
}
}
]);
// To remove a registered ruleset, just dispose its subscription
subscription1.dispose();
subscription2.dispose();
Contributors 🙏❤
A big thanks to the people that have contributed to this project:
