.mudignore
file.
To use mudignore, create a text file in the root folder of a workspace and set the name to .mudignore
. The extension for the file is .mudignore
and the name is empty.
If there is no .mudignore
file, we will return to the default list of files to ignore.
By default, here is what we ignore:
Patterns in mudignore
Each line is a rule Blank Line matches nothing Comments must start with # Quote any rules that would include spaces“folder name/file name.txt”
!
includes what should be excluded. If there is a rule *.txt
, !item.txt
will include any .txt files with the name “item”.
/
is a separator for directories.
Leading separators like /item
searches for “item” from the root folder. The results include both files and folders.
Separators after a term like item/
searches for a folder “item”.
Build a folder path with separators like /folder1/folder2/file
.
*
matches every character except /
.
?
matches one character except /
.
Range notation [a-zA-Z]
will match one of the characters in a name.
/**
matches everything inside a folder like folder/**
.
**/
matches zero or more directories. a/**/b
matches a/b
, a/x/b
, a/x/y/b
and so on.
Additional *
are considered regular asterisks and will match according to the previous rules.
Pushing and pulling mudignore
.mudignore
works exactly like other files when you push or pull changes. It has it’s own version history, so all version actions are available to you.
FAQ
What happens to ignored files once they are in the cloud?
What happens to ignored files once they are in the cloud?
Nothing, they will still stay in the cloud, but when they are pulled down, they will not be managed by mudstack.
What happens to files that get ignored locally?
What happens to files that get ignored locally?
For files that didn’t exist before a rule was set, the file will not appear in the search, nor will it be stored in mudstack db.For files that were watched by mudstack before being ignored, they will be flagged as ignored in the mudstack db. Your data will still be stored locally if you undo this action. Note that they may appear as missing after updating the mudignore file. You may disable sync or send the file/folder to the trash to resolve the missing item.
What happens to files that are not ignored locally?
What happens to files that are not ignored locally?
They will be watched by mudstack and added to your local mudstack db. Any files that existed before the initial ignore will have their metadata restored.
What are the differences between mudignore and gitignore?
What are the differences between mudignore and gitignore?
- There may only be one mudignore file placed at the root of a workspace.
- The
.mudstack
folder will always be ignored, regardless of whether you remove this rule from your.mudignore
file. - When an ignore rule is defined as a folder (ending in /), then the regex should allow paths that do not end in a slash (e.g. a file)