chore: import upstream snapshot with attribution

2026-07-13 13:02:50 +08:00
commit 0fc60fdcb1
5008 changed files with 910633 additions and 0 deletions
@@ -0,0 +1,87 @@
+/*
+ * QUANTCONNECT.COM - Democratizing Finance, Empowering Individuals.
+ * Lean Algorithmic Trading Engine v2.0. Copyright 2014 QuantConnect Corporation.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+*/
+
+using System;
+using NUnit.Framework;
+using QuantConnect.Notifications;
+
+namespace QuantConnect.Tests.Common.Notifications
+{
+    [TestFixture, Parallelizable(ParallelScope.All)]
+    public class NotificationEmailTests
+    {
+        [Test]
+        public void Constructor_SetsNullData_ToEmptyString()
+        {
+            // empty string used as default following NotificationManager.Email's default value for data
+            var email = new NotificationEmail("e@d.com", "subject", "message", null);
+            Assert.AreEqual(string.Empty, email.Data);
+        }
+
+        [Test]
+        public void Constructor_SetsNullSubject_ToEmptyString()
+        {
+            // empty string used if subject is null
+            var email = new NotificationEmail("e@d.com", null, "message", "data");
+            Assert.AreEqual(string.Empty, email.Subject);
+        }
+
+        [Test]
+        public void Constructor_SetsNullMessage_ToEmptyString()
+        {
+            // empty string used if message is null
+            var email = new NotificationEmail("e@d.com", "subject", null, "data");
+            Assert.AreEqual(string.Empty, email.Message);
+        }
+
+        [Test]
+        [TestCase("js@contoso.中国", true)]
+        [TestCase("j@proseware.com9", true)]
+        [TestCase("js@proseware.com9", true)]
+        [TestCase("j_9@[129.126.118.1]", true)]
+        [TestCase("jones@ms1.proseware.com", true)]
+        [TestCase("david.jones@proseware.com", true)]
+        [TestCase("d.j@server1.proseware.com", true)]
+        [TestCase("js#internal@proseware.com", true)]
+        [TestCase("j.s@server1.proseware.com", true)]
+        [TestCase("\"j\\\"s\\\"\"@proseware.com", true)]
+
+        [TestCase("js*@proseware.com", false)]
+        [TestCase("js@proseware..com", false)]
+        [TestCase("j..s@proseware.com", false)]
+        [TestCase("j.@server1.proseware.com", false)]
+        public void Constructor_ThrowsArgumentException_WhenEmailAddressIsInvalid(string address, bool isValid)
+        {
+            // Test cases sourced via msdn:
+            // https://docs.microsoft.com/en-us/dotnet/standard/base-types/how-to-verify-that-strings-are-in-valid-email-format
+
+            TestDelegate ctor = () => new NotificationEmail(
+                address,
+                string.Empty,
+                string.Empty,
+                string.Empty
+            );
+
+            if (isValid)
+            {
+                Assert.DoesNotThrow(ctor);
+            }
+            else
+            {
+                Assert.Throws<ArgumentException>(ctor);
+            }
+        }
+    }
+}