[#58] eacl: move package from neofs-api-go

Also, remove deprecated methods.

Signed-off-by: Evgenii Stratonikov <evgeniy@nspcc.ru>

eacl/filter.go

@@ -0,0 +1,176 @@
+package eacl
+
+import (
+	"fmt"
+	"strconv"
+
+	v2acl "github.com/nspcc-dev/neofs-api-go/v2/acl"
+)
+
+// Filter defines check conditions if request header is matched or not. Matched
+// header means that request should be processed according to EACL action.
+//
+// Filter is compatible with v2 acl.EACLRecord.Filter message.
+type Filter struct {
+	from    FilterHeaderType
+	matcher Match
+	key     filterKey
+	value   fmt.Stringer
+}
+
+type staticStringer string
+
+type u64Stringer uint64
+
+type filterKey struct {
+	typ filterKeyType
+
+	str string
+}
+
+// enumeration of reserved filter keys.
+type filterKeyType int
+
+const (
+	_ filterKeyType = iota
+	fKeyObjVersion
+	fKeyObjID
+	fKeyObjContainerID
+	fKeyObjOwnerID
+	fKeyObjCreationEpoch
+	fKeyObjPayloadLength
+	fKeyObjPayloadHash
+	fKeyObjType
+	fKeyObjHomomorphicHash
+)
+
+func (s staticStringer) String() string {
+	return string(s)
+}
+
+func (u u64Stringer) String() string {
+	return strconv.FormatUint(uint64(u), 10)
+}
+
+// Value returns filtered string value.
+func (f Filter) Value() string {
+	return f.value.String()
+}
+
+// Matcher returns filter Match type.
+func (f Filter) Matcher() Match {
+	return f.matcher
+}
+
+// Key returns key to the filtered header.
+func (f Filter) Key() string {
+	return f.key.String()
+}
+
+// From returns FilterHeaderType that defined which header will be filtered.
+func (f Filter) From() FilterHeaderType {
+	return f.from
+}
+
+// ToV2 converts Filter to v2 acl.EACLRecord.Filter message.
+//
+// Nil Filter converts to nil.
+func (f *Filter) ToV2() *v2acl.HeaderFilter {
+	if f == nil {
+		return nil
+	}
+
+	filter := new(v2acl.HeaderFilter)
+	filter.SetValue(f.value.String())
+	filter.SetKey(f.key.String())
+	filter.SetMatchType(f.matcher.ToV2())
+	filter.SetHeaderType(f.from.ToV2())
+
+	return filter
+}
+
+func (k filterKey) String() string {
+	switch k.typ {
+	default:
+		return k.str
+	case fKeyObjVersion:
+		return v2acl.FilterObjectVersion
+	case fKeyObjID:
+		return v2acl.FilterObjectID
+	case fKeyObjContainerID:
+		return v2acl.FilterObjectContainerID
+	case fKeyObjOwnerID:
+		return v2acl.FilterObjectOwnerID
+	case fKeyObjCreationEpoch:
+		return v2acl.FilterObjectCreationEpoch
+	case fKeyObjPayloadLength:
+		return v2acl.FilterObjectPayloadLength
+	case fKeyObjPayloadHash:
+		return v2acl.FilterObjectPayloadHash
+	case fKeyObjType:
+		return v2acl.FilterObjectType
+	case fKeyObjHomomorphicHash:
+		return v2acl.FilterObjectHomomorphicHash
+	}
+}
+
+// NewFilter creates, initializes and returns blank Filter instance.
+//
+// Defaults:
+//  - header type: HeaderTypeUnknown;
+//  - matcher: MatchUnknown;
+//  - key: "";
+//  - value: "".
+func NewFilter() *Filter {
+	return NewFilterFromV2(new(v2acl.HeaderFilter))
+}
+
+// NewFilterFromV2 converts v2 acl.EACLRecord.Filter message to Filter.
+func NewFilterFromV2(filter *v2acl.HeaderFilter) *Filter {
+	f := new(Filter)
+
+	if filter == nil {
+		return f
+	}
+
+	f.from = FilterHeaderTypeFromV2(filter.GetHeaderType())
+	f.matcher = MatchFromV2(filter.GetMatchType())
+	f.key.str = filter.GetKey()
+	f.value = staticStringer(filter.GetValue())
+
+	return f
+}
+
+// Marshal marshals Filter into a protobuf binary form.
+func (f *Filter) Marshal() ([]byte, error) {
+	return f.ToV2().StableMarshal(nil)
+}
+
+// Unmarshal unmarshals protobuf binary representation of Filter.
+func (f *Filter) Unmarshal(data []byte) error {
+	fV2 := new(v2acl.HeaderFilter)
+	if err := fV2.Unmarshal(data); err != nil {
+		return err
+	}
+
+	*f = *NewFilterFromV2(fV2)
+
+	return nil
+}
+
+// MarshalJSON encodes Filter to protobuf JSON format.
+func (f *Filter) MarshalJSON() ([]byte, error) {
+	return f.ToV2().MarshalJSON()
+}
+
+// UnmarshalJSON decodes Filter from protobuf JSON format.
+func (f *Filter) UnmarshalJSON(data []byte) error {
+	fV2 := new(v2acl.HeaderFilter)
+	if err := fV2.UnmarshalJSON(data); err != nil {
+		return err
+	}
+
+	*f = *NewFilterFromV2(fV2)
+
+	return nil
+}