Simple demo, how accesses by classes that are annotated with @Allow c…

…an be ignored. Remove @Allow from Okay.java and the violation will be reported (likewise, add it to Bad.java and the test will pass). Note that annotations may not be @retention(SOURCE) to be picked up.

archunit-example/src/main/java/com/bar/Allow.java

@@ -0,0 +1,4 @@
+package com.bar;
+
+public @interface Allow {
+}

archunit-example/src/main/java/com/bar/evil/Evil.java

@@ -0,0 +1,4 @@
+package com.bar.evil;
+
+public class Evil {
+}

archunit-example/src/main/java/com/bar/some/Bad.java

@@ -0,0 +1,9 @@
+package com.bar.some;
+
+import com.bar.evil.Evil;
+
+public class Bad {
+    public Bad() {
+        new Evil();
+    }
+}

archunit-example/src/main/java/com/bar/some/Okay.java

@@ -0,0 +1,11 @@
+package com.bar.some;
+
+import com.bar.Allow;
+import com.bar.evil.Evil;
+
+@Allow
+public class Okay {
+    public Okay() {
+        new Evil();
+    }
+}

archunit-example/src/test/java/com/bar/IgnoreByAnnotationWorksTest.java

@@ -0,0 +1,18 @@
+package com.bar;
+
+import com.tngtech.archunit.junit.AnalyzeClasses;
+import com.tngtech.archunit.junit.ArchTest;
+import com.tngtech.archunit.junit.ArchUnitRunner;
+import com.tngtech.archunit.lang.ArchRule;
+import org.junit.runner.RunWith;
+
+import static com.tngtech.archunit.lang.syntax.ArchRuleDefinition.noClasses;
+
+@RunWith(ArchUnitRunner.class)
+@AnalyzeClasses(packages = "com.bar")
+public class IgnoreByAnnotationWorksTest {
+    @ArchTest
+    public static final ArchRule ignoring_classes_annotated_with_Allow =
+            noClasses().that().areNotAnnotatedWith(Allow.class)
+                    .should().accessClassesThat().resideInAPackage("com.bar.evil");
+}