Merge branch 'release/v0.1.0'

Author: Suiram1701

API.Test/API.Test.csproj

@@ -0,0 +1,24 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>net6.0</TargetFramework>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <Nullable>enable</Nullable>
+
+    <IsPackable>false</IsPackable>
+    <IsTestProject>true</IsTestProject>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.5.0" />
+    <PackageReference Include="NUnit" Version="3.13.3" />
+    <PackageReference Include="NUnit3TestAdapter" Version="4.4.2" />
+    <PackageReference Include="NUnit.Analyzers" Version="3.6.1" />
+    <PackageReference Include="coverlet.collector" Version="3.2.0" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\WebUntisAPI.Client\WebUntisAPI.Client.csproj" />
+  </ItemGroup>
+
+</Project>

API.Test/AuthentificationTests.cs

@@ -0,0 +1,48 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using WebUntisAPI.Client;
+
+namespace API.Test;
+
+[Order(3)]
+[TestFixture]
+internal class AuthentificationTests
+{
+    public static WebUntisClient Client { get; set; } = new("WebUntisAPI_TEST", 1000);
+
+    static AuthentificationTests()
+    {
+        // Load a file where i saved login data
+        using StreamReader str = new("LoginData.txt");
+        s_Server = str.ReadLine();
+        s_LoginName = str.ReadLine();
+        s_UserName = str.ReadLine();
+        s_Password = str.ReadLine();
+    }
+
+    // Login data to test
+    public static string s_Server;
+    public static string s_LoginName;
+    public static string s_UserName;
+    public static string s_Password;
+
+    [Test]
+    public void Authentification()
+    {
+        try
+        {
+            using WebUntisClient client = new("WebUntisAPI_TEST");
+            client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+            client.LogoutAsync().Wait();
+        }
+        catch
+        {
+            Assert.Fail();
+            return;
+        }
+        Assert.Pass();
+    }
+}

API.Test/ExtensionsTests/ColorExtensionsTests.cs

@@ -0,0 +1,37 @@
+using System;
+using System.Collections.Generic;
+using System.Drawing;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using WebUntisAPI.Client.Extensions;
+
+namespace API.Test.ExtensionsTests;
+
+[TestFixture]
+internal class ColorExtensionsTests
+{
+    [Test]
+    public void ToHexColorFormat()
+    {
+        // Example 1
+        Color c1 = Color.FromArgb(200, 150, 255);
+        Assert.That(c1.ToHexColorFormat(), Is.EqualTo("C896FF"));
+
+        // Example 2
+        Color c2 = Color.FromArgb(10, 16, 0);
+        Assert.That(c2.ToHexColorFormat(), Is.EqualTo("0A1000"));
+    }
+
+    [Test]
+    public void FromHexColorFormat()
+    {
+        // Example 1
+        Color c1 = Color.FromArgb(200, 150, 255);
+        Assert.That(new Color().FromHexColorFormat("C896FF"), Is.EqualTo(c1));
+
+        // Example 2
+        Color c2 = Color.FromArgb(10, 16, 0);
+        Assert.That(new Color().FromHexColorFormat("0A1000"), Is.EqualTo(c2));
+    }
+}

API.Test/ExtensionsTests/DateTimeExtensionTests.cs

@@ -0,0 +1,55 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using WebUntisAPI.Client.Extensions;
+
+namespace API.Test.ExtensionsTests;
+
+[Order(1)]
+[TestFixture]
+internal class DateTimeExtensionTests
+{
+    [Order(1)]
+    [Test]
+    public static void ToWebUntisTimeFormatTest()
+    {
+        // Example 1 (True)
+        new DateTime(2023, 5, 31, 20, 0, 0).ToWebUntisTimeFormat(out string E1_Date, out string E1_Time);
+        string E1_Date_Res = "20230531";
+        string E1_Time_Res = "2000";
+        Assert.Multiple(() =>
+        {
+            Assert.That(E1_Date, Is.EqualTo(E1_Date_Res));
+            Assert.That(E1_Time, Is.EqualTo(E1_Time_Res));
+        });
+
+        // Example 2 (True)
+        new DateTime(2019, 12, 2, 7, 40, 0).ToWebUntisTimeFormat(out string E2_Date, out string E2_Time);
+        string E2_Date_Res = "20191202";
+        string E2_Time_Res = "740";
+        Assert.Multiple(() =>
+        {
+            Assert.That(E2_Date, Is.EqualTo(E2_Date_Res));
+            Assert.That(E2_Time, Is.EqualTo(E2_Time_Res));
+        });
+    }
+
+    [Order(2)]
+    [Test]
+    public static void FromWebUntisTimeFormatTest()
+    {
+        // Example 1
+        string E1_Date = "20230531";
+        string E1_Time = "2000";
+        DateTime? E1_DateTime = new DateTime().FromWebUntisTimeFormat(E1_Date, E1_Time);
+        Assert.That(new DateTime(2023, 5, 31, 20, 0, 0), Is.EqualTo(E1_DateTime));
+
+        // Example 2
+        string E2_Date = "20230601";
+        string E2_Time = "740";
+        DateTime? E2_DateTime = new DateTime().FromWebUntisTimeFormat(E2_Date, E2_Time);
+        Assert.That(new DateTime(2023, 6, 1, 7, 40, 0), Is.EqualTo(E2_DateTime));
+    }
+}

API.Test/SchoolSearchTests.cs

@@ -0,0 +1,51 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using WebUntisAPI.Client;
+using WebUntisAPI.Client.Exceptions;
+using WebUntisAPI.Client.Models;
+
+namespace API.Test;
+
+[Order(2)]
+[TestFixture]
+internal class SchoolSearchTests
+{
+    [Order(1)]
+    [Test]
+    public void NormalSearch()
+    {
+        Task<School[]> schools = SchoolSearch.SearchAsync("Marie-Curie");
+        schools.Wait();
+        if (schools.Result.Length > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Order(2)]
+    [Test]
+    public void ToManySchoolsFound()
+    {
+        Task<School[]> schools = SchoolSearch.SearchAsync("M");
+        schools.Wait();
+        if (schools.Result == null)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Order(3)]
+    [Test]
+    public void NoSchoolsFound()
+    {
+        Task<School[]> schools = SchoolSearch.SearchAsync("MMMMMMMMMMMMMMMMMMMMMMMMMMM");
+        schools.Wait();
+        if (schools.Result.Length == 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+}

API.Test/TeachingTests.cs

@@ -0,0 +1,79 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using WebUntisAPI.Client.Models;
+using static API.Test.AuthentificationTests;
+
+namespace API.Test;
+
+[Order(5)]
+[TestFixture]
+internal class TeachingTests
+{
+    [Test]
+    public void GetSubject()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<Subject[]> subjects = Client.GetAllSubjectsAsync();
+        subjects.Wait();
+        if (subjects.Result.Length > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetClass()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<Class[]> classes = Client.GetClassesAsync(new SchoolYear() { Id = 5});
+        classes.Wait();
+        if (classes.Result.Length > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetRoom()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<Room[]> rooms = Client.GetAllRoomsAsync();
+        rooms.Wait();
+        if (rooms.Result.Length > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetDepartment()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<Department[]> departments = Client.GetAllDepartmentsAsync();
+        departments.Wait();
+        if (departments.Result != null)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetLatestImportTime()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<DateTime> time = Client.GetLatestImportTimeAsync();
+        time.Wait();
+        if (time.Result <= DateTime.Now)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+}

API.Test/TimeTableTests.cs

@@ -0,0 +1,92 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using WebUntisAPI.Client.Models;
+using static API.Test.AuthentificationTests;
+
+namespace API.Test;
+
+[TestFixture]
+internal class TimeTableTests
+{
+    [Test]
+    public void GetStatusData()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<StatusData> status = Client.GetStatusDataAsync();
+        status.Wait();
+        if (status.Result != null)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetTimeGrid()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<Timegrid> timegrid = Client.GetTimegridAsync();
+        timegrid.Wait();
+        if (timegrid.Result.SchoolDayCount > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetSchoolYears()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<SchoolYear[]> schoolYears = Client.GetAllSchoolYearsAsync();
+        schoolYears.Wait();
+        if (schoolYears.Result.Length > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetCurrentSchoolYear()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<SchoolYear> schoolYear = Client.GetCurrentSchoolYearAsync();
+        schoolYear.Wait();
+        if (schoolYear.Result != null)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetHolidays()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<Holidays[]> holidays = Client.GetAllHolidaysAsync();
+        holidays.Wait();
+        if (holidays.Result.Length > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+
+    [Test]
+    public void GetTimetable()
+    {
+        Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
+
+        Task<Period[]> timetable = Client.GetTimetableForStudentAsync(Client.User as Student, new DateTime(2023, 05, 29), new DateTime(2023, 09, 2));
+        timetable.Wait();
+        if (timetable.Result.Length > 0)
+            Assert.Pass();
+        else
+            Assert.Fail();
+    }
+}