- Adds support for element groups.

Structurizr.Core.Tests/Model/GroupableElementTests.cs

@@ -0,0 +1,51 @@
+using Xunit;
+
+namespace Structurizr.Core.Tests
+{
+
+    public class GroupableElementTests : AbstractTestBase
+    {
+
+        [Fact]
+        public void Test_getGroup_ReturnsNullByDefault()
+        {
+            Person element = Model.AddPerson("Person");
+            Assert.Null(element.Group);
+        }
+
+        [Fact]
+        public void Test_setGroup()
+        {
+            Person element = Model.AddPerson("Person");
+            element.Group = "Group";
+            Assert.Equal("Group", element.Group);
+        }
+
+        [Fact]
+        public void Test_setGroup_TrimsWhiteSpace()
+        {
+            Person element = Model.AddPerson("Person");
+            element.Group = " Group ";
+            Assert.Equal("Group", element.Group);
+        }
+
+        [Fact]
+        public void Test_setGroup_HandlesEmptyAndNullValues()
+        {
+            Person element = Model.AddPerson("Person");
+            element.Group = "Group";
+
+            element.Group = null;
+            Assert.Null(element.Group);
+
+            element.Group = "Group";
+            element.Group = "";
+            Assert.Null(element.Group);
+
+            element.Group = "Group";
+            element.Group = " ";
+            Assert.Null(element.Group);
+        }
+
+    }
+}

Structurizr.Core/Model/GroupableElement.cs

@@ -0,0 +1,42 @@
+using System;
+using System.Runtime.Serialization;
+
+namespace Structurizr
+{
+
+    public abstract class GroupableElement : Element
+    {
+
+        private string _group;
+
+        /// <summary>
+        /// The name of the group in which this element should be included in.
+        /// </summary>
+        [DataMember(Name = "group", EmitDefaultValue = false)]
+        public string Group
+        {
+            get
+            {
+                return _group;
+            }
+
+            set
+            {
+                if (value == null)
+                {
+                    _group = null;
+                }
+                else {
+                    _group = value.Trim();
+
+                    if (String.IsNullOrEmpty(_group))
+                    {
+                        _group = null;
+                    }
+                }
+            }
+        }
+
+    }
+
+}

Structurizr.Core/Model/StaticStructureElement.cs

@@ -5,7 +5,7 @@
     /// This is the superclass for model elements that describe the static structure
     /// of a software system, namely Person, SoftwareSystem, Container and Component.
     /// </summary>
-    public abstract class StaticStructureElement : Element
+    public abstract class StaticStructureElement : GroupableElement
     {
 
         /// <summary>

docs/changelog.md

@@ -3,6 +3,7 @@
 ## 1.0.0 (unreleased)
 
 - Improved the support for creating [implied relationships](docs/implied-relationships.md).
+- Adds support for element groups.
 ## 0.9.7 (29th June 2020)
 
 - Added an ExternalSoftwareSystemBoundariesVisible property to ContainerView, to set whether software system boundaries should be visible for "external" containers (those outside the software system in scope).