mirror of
https://codeberg.org/forgejo/forgejo
synced 2024-08-29 02:51:32 +02:00
* update github.com/blevesearch/bleve v2.0.2 -> v2.0.3 * github.com/denisenkom/go-mssqldb v0.9.0 -> v0.10.0 * github.com/editorconfig/editorconfig-core-go v2.4.1 -> v2.4.2 * github.com/go-chi/cors v1.1.1 -> v1.2.0 * github.com/go-git/go-billy v5.0.0 -> v5.1.0 * github.com/go-git/go-git v5.2.0 -> v5.3.0 * github.com/go-ldap/ldap v3.2.4 -> v3.3.0 * github.com/go-redis/redis v8.6.0 -> v8.8.2 * github.com/go-sql-driver/mysql v1.5.0 -> v1.6.0 * github.com/go-swagger/go-swagger v0.26.1 -> v0.27.0 * github.com/lib/pq v1.9.0 -> v1.10.1 * github.com/mattn/go-sqlite3 v1.14.6 -> v1.14.7 * github.com/go-testfixtures/testfixtures v3.5.0 -> v3.6.0 * github.com/issue9/identicon v1.0.1 -> v1.2.0 * github.com/klauspost/compress v1.11.8 -> v1.12.1 * github.com/mgechev/revive v1.0.3 -> v1.0.6 * github.com/microcosm-cc/bluemonday v1.0.7 -> v1.0.8 * github.com/niklasfasching/go-org v1.4.0 -> v1.5.0 * github.com/olivere/elastic v7.0.22 -> v7.0.24 * github.com/pelletier/go-toml v1.8.1 -> v1.9.0 * github.com/prometheus/client_golang v1.9.0 -> v1.10.0 * github.com/xanzy/go-gitlab v0.44.0 -> v0.48.0 * github.com/yuin/goldmark v1.3.3 -> v1.3.5 * github.com/6543/go-version v1.2.4 -> v1.3.1 * do github.com/lib/pq v1.10.0 -> v1.10.1 again ...
185 lines
4.8 KiB
Go
Vendored
185 lines
4.8 KiB
Go
Vendored
// Copyright (C) MongoDB, Inc. 2017-present.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License"); you may
|
|
// not use this file except in compliance with the License. You may obtain
|
|
// a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Based on gopkg.in/mgo.v2/bson by Gustavo Niemeyer
|
|
// See THIRD-PARTY-NOTICES for original license terms.
|
|
|
|
package primitive
|
|
|
|
import (
|
|
"bytes"
|
|
"crypto/rand"
|
|
"encoding/binary"
|
|
"encoding/hex"
|
|
"encoding/json"
|
|
"errors"
|
|
"fmt"
|
|
"io"
|
|
"sync/atomic"
|
|
"time"
|
|
)
|
|
|
|
// ErrInvalidHex indicates that a hex string cannot be converted to an ObjectID.
|
|
var ErrInvalidHex = errors.New("the provided hex string is not a valid ObjectID")
|
|
|
|
// ObjectID is the BSON ObjectID type.
|
|
type ObjectID [12]byte
|
|
|
|
// NilObjectID is the zero value for ObjectID.
|
|
var NilObjectID ObjectID
|
|
|
|
var objectIDCounter = readRandomUint32()
|
|
var processUnique = processUniqueBytes()
|
|
|
|
// NewObjectID generates a new ObjectID.
|
|
func NewObjectID() ObjectID {
|
|
return NewObjectIDFromTimestamp(time.Now())
|
|
}
|
|
|
|
// NewObjectIDFromTimestamp generates a new ObjectID based on the given time.
|
|
func NewObjectIDFromTimestamp(timestamp time.Time) ObjectID {
|
|
var b [12]byte
|
|
|
|
binary.BigEndian.PutUint32(b[0:4], uint32(timestamp.Unix()))
|
|
copy(b[4:9], processUnique[:])
|
|
putUint24(b[9:12], atomic.AddUint32(&objectIDCounter, 1))
|
|
|
|
return b
|
|
}
|
|
|
|
// Timestamp extracts the time part of the ObjectId.
|
|
func (id ObjectID) Timestamp() time.Time {
|
|
unixSecs := binary.BigEndian.Uint32(id[0:4])
|
|
return time.Unix(int64(unixSecs), 0).UTC()
|
|
}
|
|
|
|
// Hex returns the hex encoding of the ObjectID as a string.
|
|
func (id ObjectID) Hex() string {
|
|
return hex.EncodeToString(id[:])
|
|
}
|
|
|
|
func (id ObjectID) String() string {
|
|
return fmt.Sprintf("ObjectID(%q)", id.Hex())
|
|
}
|
|
|
|
// IsZero returns true if id is the empty ObjectID.
|
|
func (id ObjectID) IsZero() bool {
|
|
return bytes.Equal(id[:], NilObjectID[:])
|
|
}
|
|
|
|
// ObjectIDFromHex creates a new ObjectID from a hex string. It returns an error if the hex string is not a
|
|
// valid ObjectID.
|
|
func ObjectIDFromHex(s string) (ObjectID, error) {
|
|
b, err := hex.DecodeString(s)
|
|
if err != nil {
|
|
return NilObjectID, err
|
|
}
|
|
|
|
if len(b) != 12 {
|
|
return NilObjectID, ErrInvalidHex
|
|
}
|
|
|
|
var oid [12]byte
|
|
copy(oid[:], b[:])
|
|
|
|
return oid, nil
|
|
}
|
|
|
|
// IsValidObjectID returns true if the provided hex string represents a valid ObjectID and false if not.
|
|
func IsValidObjectID(s string) bool {
|
|
_, err := ObjectIDFromHex(s)
|
|
return err == nil
|
|
}
|
|
|
|
// MarshalJSON returns the ObjectID as a string
|
|
func (id ObjectID) MarshalJSON() ([]byte, error) {
|
|
return json.Marshal(id.Hex())
|
|
}
|
|
|
|
// UnmarshalJSON populates the byte slice with the ObjectID. If the byte slice is 24 bytes long, it
|
|
// will be populated with the hex representation of the ObjectID. If the byte slice is twelve bytes
|
|
// long, it will be populated with the BSON representation of the ObjectID. This method also accepts empty strings and
|
|
// decodes them as NilObjectID. For any other inputs, an error will be returned.
|
|
func (id *ObjectID) UnmarshalJSON(b []byte) error {
|
|
// Ignore "null" to keep parity with the standard library. Decoding a JSON null into a non-pointer ObjectID field
|
|
// will leave the field unchanged. For pointer values, encoding/json will set the pointer to nil and will not
|
|
// enter the UnmarshalJSON hook.
|
|
if string(b) == "null" {
|
|
return nil
|
|
}
|
|
|
|
var err error
|
|
switch len(b) {
|
|
case 12:
|
|
copy(id[:], b)
|
|
default:
|
|
// Extended JSON
|
|
var res interface{}
|
|
err := json.Unmarshal(b, &res)
|
|
if err != nil {
|
|
return err
|
|
}
|
|
str, ok := res.(string)
|
|
if !ok {
|
|
m, ok := res.(map[string]interface{})
|
|
if !ok {
|
|
return errors.New("not an extended JSON ObjectID")
|
|
}
|
|
oid, ok := m["$oid"]
|
|
if !ok {
|
|
return errors.New("not an extended JSON ObjectID")
|
|
}
|
|
str, ok = oid.(string)
|
|
if !ok {
|
|
return errors.New("not an extended JSON ObjectID")
|
|
}
|
|
}
|
|
|
|
// An empty string is not a valid ObjectID, but we treat it as a special value that decodes as NilObjectID.
|
|
if len(str) == 0 {
|
|
copy(id[:], NilObjectID[:])
|
|
return nil
|
|
}
|
|
|
|
if len(str) != 24 {
|
|
return fmt.Errorf("cannot unmarshal into an ObjectID, the length must be 24 but it is %d", len(str))
|
|
}
|
|
|
|
_, err = hex.Decode(id[:], []byte(str))
|
|
if err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
return err
|
|
}
|
|
|
|
func processUniqueBytes() [5]byte {
|
|
var b [5]byte
|
|
_, err := io.ReadFull(rand.Reader, b[:])
|
|
if err != nil {
|
|
panic(fmt.Errorf("cannot initialize objectid package with crypto.rand.Reader: %v", err))
|
|
}
|
|
|
|
return b
|
|
}
|
|
|
|
func readRandomUint32() uint32 {
|
|
var b [4]byte
|
|
_, err := io.ReadFull(rand.Reader, b[:])
|
|
if err != nil {
|
|
panic(fmt.Errorf("cannot initialize objectid package with crypto.rand.Reader: %v", err))
|
|
}
|
|
|
|
return (uint32(b[0]) << 0) | (uint32(b[1]) << 8) | (uint32(b[2]) << 16) | (uint32(b[3]) << 24)
|
|
}
|
|
|
|
func putUint24(b []byte, v uint32) {
|
|
b[0] = byte(v >> 16)
|
|
b[1] = byte(v >> 8)
|
|
b[2] = byte(v)
|
|
}
|