forgejo/routers/api/v1/utils/utils.go

// Copyright 2017 The Gitea Authors. All rights reserved.
// Use of this source code is governed by a MIT-style
// license that can be found in the LICENSE file.

package utils

import (
	"net/url"
	"strings"
	"time"

	"code.gitea.io/gitea/models"
	"code.gitea.io/gitea/modules/context"
	"code.gitea.io/gitea/modules/convert"
)

// GetQueryBeforeSince return parsed time (unix format) from URL query's before and since
func GetQueryBeforeSince(ctx *context.APIContext) (before, since int64, err error) {
	qCreatedBefore, err := prepareQueryArg(ctx, "before")
	if err != nil {
		return 0, 0, err
	}

	qCreatedSince, err := prepareQueryArg(ctx, "since")
	if err != nil {
		return 0, 0, err
	}

	before, err = parseTime(qCreatedBefore)
	if err != nil {
		return 0, 0, err
	}

	since, err = parseTime(qCreatedSince)
	if err != nil {
		return 0, 0, err
	}
	return before, since, nil
}

// parseTime parse time and return unix timestamp
func parseTime(value string) (int64, error) {
	if len(value) != 0 {
		t, err := time.Parse(time.RFC3339, value)
		if err != nil {
			return 0, err
		}
		if !t.IsZero() {
			return t.Unix(), nil
		}
	}
	return 0, nil
}

// prepareQueryArg unescape and trim a query arg
func prepareQueryArg(ctx *context.APIContext, name string) (value string, err error) {
	value, err = url.PathUnescape(ctx.Query(name))
	value = strings.Trim(value, " ")
	return
}

// GetListOptions returns list options using the page and limit parameters
func GetListOptions(ctx *context.APIContext) models.ListOptions {
	return models.ListOptions{
		Page:     ctx.QueryInt("page"),
		PageSize: convert.ToCorrectPageSize(ctx.QueryInt("limit")),
	}
}

// PaginateUserSlice cut a slice of Users as per pagination options
// TODO: make it generic
func PaginateUserSlice(items []*models.User, page, pageSize int) []*models.User {
	if page != 0 {
		page--
	}

	if page*pageSize >= len(items) {
		return items[len(items):]
	}

	items = items[page*pageSize:]

	if len(items) > pageSize {
		return items[:pageSize]
	}
	return items
}