Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/redbluegames/unity-stylecop-ignoreutility
A Unity Editor tool used to force StyleCop to ignore specified scripts as it checks for style violations in our projects.
https://github.com/redbluegames/unity-stylecop-ignoreutility
Last synced: 3 months ago
JSON representation
A Unity Editor tool used to force StyleCop to ignore specified scripts as it checks for style violations in our projects.
- Host: GitHub
- URL: https://github.com/redbluegames/unity-stylecop-ignoreutility
- Owner: redbluegames
- License: mit
- Created: 2016-11-05T18:17:48.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-11-12T19:55:15.000Z (almost 5 years ago)
- Last Synced: 2024-07-14T14:32:26.775Z (4 months ago)
- Language: C#
- Homepage:
- Size: 62.5 KB
- Stars: 17
- Watchers: 6
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-unity-open-source-on-github - unity-stylecop-ignoreutility - StyleCop Ignore Utility (Static Code Analysis)
README
# Unity - StyleCop Ignore Utility
StyleCop Ignore Utility is a Unity Editor tool we use at [RedBlueGames](http://www.redbluegames.com) to ignore scripts when StyleCop checks for style violations in our projects. This comes in handy in two situations:
* Ignoring third-party Assets (none match our style exactly)
* Ignoring our own test and generated scripts
## What is StyleCop?
If you haven't heard of StyleCop I'd recommend a couple of our blog posts on the topic.
- Why We Adopted StyleCop
- How to Get StyleCop Installed for a Unity Project
## Installation
First you'll need to make sure you have StyleCop installed. See [How to Get StyleCop Installed for a Unity Project](https://blog.redbluegames.com/how-to-set-up-stylecop-in-unity-b3ca908211d9) for instructions.
- After installing StyleCop you'll need to download and install the latest .unitypackage release from this repository ([link](https://github.com/redbluegames/unity-stylecop-ignoreutility/releases/download/v1.0/StyleCopIgnoreUtility.unitypackage)).
- In _Unity Editor_ go to **Assets** -> **Import Package** -> **Custom Package...**
- Select the .unitypackage file you just downloaded
We generally install all of our plugins under their company folders. So our recommended directory structure for this plugin looks like this.
```
├── Assets
│ ├── RedBlueGames
│ │ ├── StyleCopIgnoreUtility
│ ├── Resources
│ │ ├── RedBlueGames
│ ├── StyleCop.Cache
├── Settings.StyleCop
```
## Using StyleCop Ignore Utility
Once you have finished StyleCop and the Ignore Utility installation, you should have a **Settings.StyleCop** file somewhere in your project, most likely at the root. You can now set up your ignore preferences through our utility.
1. In *Unity Editor* go to **Window** -> **StyleCop Ignore Utility** to open the utility.
1. Point the utility to your Settings.StyleCop file
[screenshot here]
1. Check any folders or files you'd like StyleCop to Ignore
1. Write your changes to the Settings.StyleCop file
That's it! You should now see StyleCop ignore
## How it Works
We leverage the parser settings to ignore files with given names. It uses regular expression rules to filter out files by name. When users select folders, you're actually just adding (or removing) every file in that folder from the list of values inserted into the Settings.StyleCop file.
Here's a diff of the file after adding the IngoredScriptWithErrors to our settings.
```diff
diff --git a/Settings.StyleCop b/Settings.StyleCop
index 0a67b66..a1bf1d8 100644
--- a/Settings.StyleCop
+++ b/Settings.StyleCop
@@ -95,7 +95,9 @@
-
+
+ [^a-z ]IgnoredScriptWithErrors.cs
+
```