Add method to get classes for a school year

Author: Suiram1701

API.Test/ExtensionsTests/DateTimeExtensionTests.cs

@@ -17,7 +17,7 @@ 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 = "2023-05-31";
+        string E1_Date_Res = "20230531";
         string E1_Time_Res = "2000";
         Assert.Multiple(() =>
         {
@@ -27,7 +27,7 @@ public static void ToWebUntisTimeFormatTest()
 
         // Example 2 (True)
         new DateTime(2019, 12, 2, 7, 40, 0).ToWebUntisTimeFormat(out string E2_Date, out string E2_Time);
-        string E2_Date_Res = "2019-12-02";
+        string E2_Date_Res = "20191202";
         string E2_Time_Res = "740";
         Assert.Multiple(() =>
         {
@@ -41,13 +41,13 @@ public static void ToWebUntisTimeFormatTest()
     public static void FromWebUntisTimeFormatTest()
     {
         // Example 1
-        string E1_Date = "2023-05-31";
+        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 = "2023-06-01";
+        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/TeachingTests.cs

@@ -30,7 +30,7 @@ public void GetClass()
     {
         Client.LoginAsync(s_Server, s_LoginName, s_UserName, s_Password).Wait();
 
-        Task<Class[]> classes = Client.GetAllClassesAsync();
+        Task<Class[]> classes = Client.GetClassesAsync(new SchoolYear() { Id = 5});
         classes.Wait();
         if (classes.Result.Length > 0)
             Assert.Pass();

WebUntisAPI.Client/Models/SchoolYearModel.cs

@@ -0,0 +1,15 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace WebUntisAPI.Client.Models
+{
+    internal struct SchoolYearModel
+    {
+        [JsonProperty("id")]
+        public int Id { get; set; }
+    }
+}

WebUntisAPI.Client/WebUntisClient.Teaching.cs

@@ -32,23 +32,38 @@ public async Task<Subject[]> GetAllSubjectsAsync(string id = "getSubjects", Canc
         }
 
         /// <summary>
-        /// Get all classes on the school
+        /// Get all classes on the school from the current school year
         /// </summary>
         /// <param name="id">Identifier of the request</param>
         /// <param name="ct">Cancellation token</param>
-        /// <returns>All classes on the school</returns>
+        /// <returns>All classes on the school from current school year</returns>
         /// <exception cref="ObjectDisposedException">Thrown when the instance was disposed</exception>
         /// <exception cref="UnauthorizedAccessException">Thrown when you're not logged in</exception>
         /// <exception cref="HttpRequestException">Thrown when an error happend while the hppt request</exception>
         /// <exception cref="WebUntisException">Thrown when the WebUntis API returned an error</exception>
         public async Task<Class[]> GetAllClassesAsync(string id = "getClasses", CancellationToken ct = default)
         {
-            //TODO: School year overload
-
             List<Class> classes = await MakeRequestAsync<object, List<Class>>(id, "getKlassen", new object(), ct);
             return classes.ToArray();
         }
 
+        /// <summary>
+        /// Get all classes on the school from the selected school year
+        /// </summary>
+        /// <param name="id">Identifier of the request</param>
+        /// <param name="ct">Cancellation token</param>
+        /// <param name="schoolYear">The school year from the classes</param>
+        /// <returns>All classes on the school for the school year</returns>
+        /// <exception cref="ObjectDisposedException">Thrown when the instance was disposed</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when you're not logged in</exception>
+        /// <exception cref="HttpRequestException">Thrown when an error happend while the hppt request</exception>
+        /// <exception cref="WebUntisException">Thrown when the WebUntis API returned an error</exception>
+        public async Task<Class[]> GetClassesAsync(SchoolYear schoolYear, string id = "getClassesBySchoolYear", CancellationToken ct = default)
+        {
+            List<Class> classes = await MakeRequestAsync<SchoolYearModel, List<Class>>(id, "getKlassen", new SchoolYearModel() { Id = schoolYear.Id }, ct);
+            return classes.ToArray();
+        }
+
         /// <summary>
         /// Get all rooms on the school
         /// </summary>