Added: downloading and returning wikipedia articles

api/httpio/httperror.go

@@ -0,0 +1,24 @@
+package httpio
+
+import (
+	"encoding/json"
+	"net/http"
+)
+
+type HTTPError struct {
+	StatusCode int    `json:"-"`
+	ErrorCode  string `json:"error-code"`
+	Message    string `json:"message"`
+}
+
+func (h HTTPError) Raise(w http.ResponseWriter) {
+	jsonBytes, _ := json.Marshal(h)
+
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(h.StatusCode)
+	w.Write(jsonBytes)
+}
+
+func RaiseOnlyStatusCode(w http.ResponseWriter, code int) {
+	http.Error(w, "", code)
+}

api/httpio/request.go

@@ -0,0 +1,38 @@
+package httpio
+
+import (
+	"encoding/json"
+	"errors"
+	"io"
+	"log"
+	"net/http"
+)
+
+type IRequestIO interface {
+	// Validates the received request.
+	Validate() *HTTPError
+}
+
+// Parses request body into the provided struct.
+// Throws an error if the body could not be parsed.
+func ParseRequestBody[T IRequestIO](r *http.Request) (*T, error) {
+	requestBytes, err := io.ReadAll(r.Body)
+	if err != nil {
+		log.Println(err.Error())
+		return nil, err
+	}
+
+	if !json.Valid(requestBytes) {
+		return nil, errors.New("invalid JSON format")
+	}
+
+	var req T
+	err = json.Unmarshal(requestBytes, &req)
+	if err != nil {
+		log.Println(err.Error())
+		return nil, err
+	}
+
+	return &req, nil
+
+}

api/httpio/response.go

@@ -0,0 +1,21 @@
+package httpio
+
+import (
+	"encoding/json"
+	"net/http"
+)
+
+type ResponseIO map[string]any
+
+func (r ResponseIO) Return(w http.ResponseWriter, statusCode int) error {
+	jsonBytes, err := json.Marshal(r)
+	if err != nil {
+		return err
+	}
+
+	w.Header().Set("Content-Type", "application/json")
+	w.WriteHeader(statusCode)
+	w.Write(jsonBytes)
+
+	return nil
+}

api/httpio/urlquery.go

@@ -0,0 +1,86 @@
+package httpio
+
+import (
+	"encoding/json"
+	"errors"
+	"net/http"
+	"strconv"
+)
+
+type URLQueryValueType interface {
+	string | int | float32 | float64 | bool
+}
+
+type iURLQueryKeyType interface {
+	GetKey() string
+}
+
+type URLQueryKeyType[T URLQueryValueType] struct {
+	Key string
+	_   T
+}
+
+func (u URLQueryKeyType[T]) GetKey() string { return u.Key }
+
+func URLQueryKey[T URLQueryValueType](key string) iURLQueryKeyType {
+	return URLQueryKeyType[T]{
+		Key: key,
+	}
+}
+
+func ParseURLQuery[T IRequestIO](r *http.Request, keys ...iURLQueryKeyType) (*T, error) {
+	query := make(map[string]any, len(keys))
+
+	for _, key := range keys {
+		queryValue := r.URL.Query().Get(key.GetKey())
+
+		if queryValue == "" {
+			continue
+		}
+
+		switch key.(type) {
+		case URLQueryKeyType[string]:
+			query[key.GetKey()] = queryValue
+		case URLQueryKeyType[int]:
+			x, err := strconv.Atoi(queryValue)
+			if err != nil {
+				return nil, err
+			}
+
+			query[key.GetKey()] = x
+		case URLQueryKeyType[float32]:
+			x, err := strconv.ParseFloat(queryValue, 32)
+			if err != nil {
+				return nil, err
+			}
+
+			query[key.GetKey()] = x
+		case URLQueryKeyType[float64]:
+			x, err := strconv.ParseFloat(queryValue, 64)
+			if err != nil {
+				return nil, err
+			}
+
+			query[key.GetKey()] = x
+		case URLQueryKeyType[bool]:
+			x, err := strconv.ParseBool(queryValue)
+			if err != nil {
+				return nil, err
+			}
+
+			query[key.GetKey()] = x
+		default:
+			return nil, errors.New("unsupported URL query key type")
+		}
+	}
+
+	queryBytes, _ := json.Marshal(query)
+
+	var req T
+	err := json.Unmarshal(queryBytes, &req)
+	if err != nil {
+		return nil, err
+	}
+
+	return &req, nil
+}