Add get subjects method and their test

Author: Suiram1701

API.Test/AuthentificationTests.cs

@@ -11,6 +11,8 @@ namespace API.Test;
 [TestFixture]
 internal class AuthentificationTests
 {
+    public static WebUntisClient Client { get; set; } = new("WebUntisAPI_TEST");
+
     static AuthentificationTests()
     {
         // Load a file where i saved login data

API.Test/TeachingTests.cs

@@ -0,0 +1,27 @@
+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();
+    }
+}

API.Test/UserTest.cs

@@ -14,15 +14,6 @@ namespace API.Test;
 [TestFixture]
 internal class UserTest
 {
-    private static WebUntisClient Client { get; set; }
-
-    [Order(0)]
-    [SetUp]
-    public void Setup()
-    {
-        Client = new("WebUntisAPI_TEST");
-    }
-
     [Test]
     [Order(1)]
     public void GetStudents()

WebUntisAPI.Client/Models/Student.cs

@@ -12,7 +12,7 @@ namespace WebUntisAPI.Client.Models
     /// A student
     /// </summary>
     [DebuggerDisplay("Name = {ForeName} {LongName}")]
-    public sealed class Student : IUser
+    public class Student : IUser
     {
         /// <inheritdoc/>
         public int Id { get; set; }

WebUntisAPI.Client/Models/Subject.cs

@@ -0,0 +1,60 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Drawing;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace WebUntisAPI.Client.Models
+{
+    /// <summary>
+    /// A subject
+    /// </summary>
+    [DebuggerDisplay("Name = {LongName}")]
+    public struct Subject
+    {
+        /// <summary>
+        /// Id of the subject
+        /// </summary>
+        [JsonProperty("id")]
+        public int Id { get; set; }
+
+        /// <summary>
+        /// Internal name of the subject
+        /// </summary>
+        [JsonProperty("name")]
+        public string Name { get; set; }
+
+        /// <summary>
+        /// Full name of the subject
+        /// </summary>
+        [JsonProperty("longName")]
+        public string LongName { get; set; }
+
+        /// <summary>
+        /// Alternative name of the subject
+        /// </summary>
+        [JsonProperty("alternateName")]
+        public string AlternateName { get; set; }
+
+        /// <summary>
+        /// Is the subject active
+        /// </summary>
+        [JsonProperty("active")]
+        public bool Active { get; set; }
+
+        /// <summary>
+        /// Fore color of the subject
+        /// </summary>
+        [JsonProperty("foreColor")]
+        public Color ForeColor { get; set; }
+
+        /// <summary>
+        /// Back color of the subject
+        /// </summary>
+        [JsonProperty("backColor")]
+        public Color BackColor { get; set; }
+    }
+}

WebUntisAPI.Client/WebUntisAPI.Client.csproj

@@ -32,10 +32,6 @@
     </None>
   </ItemGroup>
 
-  <ItemGroup>
-    <Folder Include="Extensions\" />
-  </ItemGroup>
-
   <ItemGroup>
     <PackageReference Include="Newtonsoft.Json" Version="13.0.3" />
     <PackageReference Include="System.Net.Http" Version="4.3.4" />

WebUntisAPI.Client/WebUntisClient.Teaching.cs

@@ -0,0 +1,70 @@
+using Newtonsoft.Json;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Net.Http;
+using System.Net;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+using WebUntisAPI.Client.Models;
+using WebUntisAPI.Client.Converter;
+using WebUntisAPI.Client.Exceptions;
+
+namespace WebUntisAPI.Client
+{
+    public partial class WebUntisClient
+    {
+        /// <summary>
+        /// Get all subjects on the school
+        /// </summary>
+        /// <param name="id">Identifier for the request</param>
+        /// <param name="ct">Cancellation token</param>
+        /// <returns>All subjects</returns>
+        /// <exception cref="ObjectDisposedException">Thrown when the instance was disposed</exception>
+        /// <exception cref="UnauthorizedAccessException">Thrown when you aren't logged in</exception>
+        /// <exception cref="HttpRequestException">Thrown when an error happened while the http request</exception>
+        /// <exception cref="WebUntisException">Thrown when the WebUntis API returned an error</exception>
+        public async Task<Subject[]> GetAllSubjectsAsync(string id = "getSubjects", CancellationToken ct = default)
+        {
+            // Check for disposing
+            if (_disposedValue)
+                throw new ObjectDisposedException(GetType().FullName);
+
+            // Check if you logged in
+            if (!LoggedIn)
+                throw new UnauthorizedAccessException("You're not logged in");
+
+            // Make request
+            JSONRPCRequestModel<object> requestModel = new JSONRPCRequestModel<object>()
+            {
+                Id = id,
+                Method = "getSubjects",
+                Params = new object()
+            };
+            StringContent requestContent = new StringContent(JsonConvert.SerializeObject(requestModel), Encoding.UTF8, "application/json");
+
+            // Send request
+            HttpResponseMessage response = await _client.PostAsync(ServerUrl + "/WebUntis/jsonrpc.do", requestContent, ct);
+
+            // Check cancellation token
+            if (ct.IsCancellationRequested)
+                return null;
+
+            // Verify response
+            if (response.StatusCode != HttpStatusCode.OK)
+                throw new HttpRequestException($"There was an error while the http request (Code: {response.StatusCode}).");
+
+            JsonSerializerSettings settings = new JsonSerializerSettings();
+            settings.Converters.Add(new ColorJsonConverter());
+            JSONRPCResponeModel<List<Subject>> responseModel = JsonConvert.DeserializeObject<JSONRPCResponeModel<List<Subject>>>(await response.Content.ReadAsStringAsync(), settings);
+
+            // Check for WebUntis error
+            if (responseModel.Error != null)
+                throw responseModel.Error;
+
+            return responseModel.Result.ToArray();
+        }
+    }
+
+}

WebUntisAPI.Client/WebUntisClient.User.cs

@@ -27,12 +27,7 @@ public partial class WebUntisClient
         /// The user as that you currently logged in
         /// </summary>
         /// <remarks>
-        ///     <para>
-        ///     <see langword="null"/> when you're not logged in
-        ///     </para>
-        ///     <para>
-        ///     Don't change any value!
-        ///     </para>
+        /// <see langword="null"/> when you're not logged in
         /// </remarks>
         public IUser User => _user;
         private IUser _user = null;