[#168] refs: Implement binary/JSON encoders/decoders on Signature

Signed-off-by: Leonard Lyubich <leonard@nspcc.ru>

pkg/signature.go

@@ -42,3 +42,35 @@ func (s *Signature) SetSign(v []byte) {
 func (s *Signature) ToV2() *refs.Signature {
 	return (*refs.Signature)(s)
 }
+
+// Marshal marshals Signature into a protobuf binary form.
+//
+// Buffer is allocated when the argument is empty.
+// Otherwise, the first buffer is used.
+func (s *Signature) Marshal(b ...[]byte) ([]byte, error) {
+	var buf []byte
+	if len(b) > 0 {
+		buf = b[0]
+	}
+
+	return (*refs.Signature)(s).
+		StableMarshal(buf)
+}
+
+// Unmarshal unmarshals protobuf binary representation of Signature.
+func (s *Signature) Unmarshal(data []byte) error {
+	return (*refs.Signature)(s).
+		Unmarshal(data)
+}
+
+// MarshalJSON encodes Signature to protobuf JSON format.
+func (s *Signature) MarshalJSON() ([]byte, error) {
+	return (*refs.Signature)(s).
+		MarshalJSON()
+}
+
+// UnmarshalJSON decodes Signature from protobuf JSON format.
+func (s *Signature) UnmarshalJSON(data []byte) error {
+	return (*refs.Signature)(s).
+		UnmarshalJSON(data)
+}

pkg/signature_test.go

@@ -0,0 +1,33 @@
+package pkg
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/require"
+)
+
+func TestSignatureEncoding(t *testing.T) {
+	s := NewSignature()
+	s.SetKey([]byte("key"))
+	s.SetSign([]byte("sign"))
+
+	t.Run("binary", func(t *testing.T) {
+		data, err := s.Marshal()
+		require.NoError(t, err)
+
+		s2 := NewSignature()
+		require.NoError(t, s2.Unmarshal(data))
+
+		require.Equal(t, s, s2)
+	})
+
+	t.Run("json", func(t *testing.T) {
+		data, err := s.MarshalJSON()
+		require.NoError(t, err)
+
+		s2 := NewSignature()
+		require.NoError(t, s2.UnmarshalJSON(data))
+
+		require.Equal(t, s, s2)
+	})
+}

v2/refs/json.go

@@ -104,3 +104,23 @@ func (v *Version) UnmarshalJSON(data []byte) error {
 
 	return nil
 }
+
+func (s *Signature) MarshalJSON() ([]byte, error) {
+	return protojson.MarshalOptions{
+		EmitUnpopulated: true,
+	}.Marshal(
+		SignatureToGRPCMessage(s),
+	)
+}
+
+func (s *Signature) UnmarshalJSON(data []byte) error {
+	msg := new(refs.Signature)
+
+	if err := protojson.Unmarshal(data, msg); err != nil {
+		return err
+	}
+
+	*s = *SignatureFromGRPCMessage(msg)
+
+	return nil
+}

v2/refs/json_test.go

@@ -69,3 +69,15 @@ func TestVersionSON(t *testing.T) {
 
 	require.Equal(t, v, v2)
 }
+
+func TestSignatureSON(t *testing.T) {
+	s := generateSignature("key", "sig")
+
+	data, err := s.MarshalJSON()
+	require.NoError(t, err)
+
+	s2 := new(refs.Signature)
+	require.NoError(t, s2.UnmarshalJSON(data))
+
+	require.Equal(t, s, s2)
+}

v2/refs/marshal.go

@@ -266,6 +266,17 @@ func (s *Signature) StableSize() (size int) {
 	return size
 }
 
+func (s *Signature) Unmarshal(data []byte) error {
+	m := new(refs.Signature)
+	if err := goproto.Unmarshal(data, m); err != nil {
+		return err
+	}
+
+	*s = *SignatureFromGRPCMessage(m)
+
+	return nil
+}
+
 func (v *Version) StableMarshal(buf []byte) ([]byte, error) {
 	if v == nil {
 		return []byte{}, nil

v2/refs/marshal_test.go

@@ -95,16 +95,14 @@ func TestChecksum_StableMarshal(t *testing.T) {
 
 func TestSignature_StableMarshal(t *testing.T) {
 	signatureFrom := generateSignature("Public Key", "Signature")
-	transport := new(grpc.Signature)
 
 	t.Run("non empty", func(t *testing.T) {
 		wire, err := signatureFrom.StableMarshal(nil)
 		require.NoError(t, err)
 
-		err = goproto.Unmarshal(wire, transport)
+		signatureTo := new(refs.Signature)
-		require.NoError(t, err)
+		require.NoError(t, signatureTo.Unmarshal(wire))
 
-		signatureTo := refs.SignatureFromGRPCMessage(transport)
 		require.Equal(t, signatureFrom, signatureTo)
 	})
 }