#region Copyright notice and license // Protocol Buffers - Google's data interchange format // Copyright 2015 Google Inc. All rights reserved. // https://developers.google.com/protocol-buffers/ // // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are // met: // // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above // copyright notice, this list of conditions and the following disclaimer // in the documentation and/or other materials provided with the // distribution. // * Neither the name of Google Inc. nor the names of its // contributors may be used to endorse or promote products derived from // this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. #endregion using NUnit.Framework; using System; using System.Buffers; using Google.Protobuf.Buffers; namespace Google.Protobuf { public static class MessageParsingHelpers { public static void AssertReadingMessage(MessageParser parser, byte[] bytes, Action assert) where T : IMessage { var parsedStream = parser.ParseFrom(bytes); // Load content as single segment var parsedBuffer = parser.ParseFrom(new ReadOnlySequence(bytes)); assert(parsedBuffer); // Load content as multiple segments parsedBuffer = parser.ParseFrom(ReadOnlySequenceFactory.CreateWithContent(bytes)); assert(parsedBuffer); assert(parsedStream); } public static void AssertReadingMessage(MessageParser parser, byte[] bytes, Action assert) { var parsedStream = parser.ParseFrom(bytes); // Load content as single segment var parsedBuffer = parser.ParseFrom(new ReadOnlySequence(bytes)); assert(parsedBuffer); // Load content as multiple segments parsedBuffer = parser.ParseFrom(ReadOnlySequenceFactory.CreateWithContent(bytes)); assert(parsedBuffer); assert(parsedStream); } public static void AssertReadingMessageThrows(MessageParser parser, byte[] bytes) where TMessage : IMessage where TException : Exception { Assert.Throws(() => parser.ParseFrom(bytes)); Assert.Throws(() => parser.ParseFrom(new ReadOnlySequence(bytes))); } public static void AssertRoundtrip(MessageParser parser, T message, Action additionalAssert = null) where T : IMessage { var bytes = message.ToByteArray(); // also serialize using IBufferWriter and check it leads to the same data var bufferWriter = new ArrayBufferWriter(); message.WriteTo(bufferWriter); Assert.AreEqual(bytes, bufferWriter.WrittenSpan.ToArray(), "Both serialization approaches need to result in the same data."); // Load content as single segment var parsedBuffer = parser.ParseFrom(new ReadOnlySequence(bytes)); Assert.AreEqual(message, parsedBuffer); additionalAssert?.Invoke(parsedBuffer); // Load content as multiple segments parsedBuffer = parser.ParseFrom(ReadOnlySequenceFactory.CreateWithContent(bytes)); Assert.AreEqual(message, parsedBuffer); additionalAssert?.Invoke(parsedBuffer); var parsedStream = parser.ParseFrom(bytes); Assert.AreEqual(message, parsedStream); additionalAssert?.Invoke(parsedStream); } public static void AssertWritingMessage(IMessage message) { // serialize using CodedOutputStream var bytes = message.ToByteArray(); int messageSize = message.CalculateSize(); Assert.AreEqual(message.CalculateSize(), bytes.Length); // serialize using IBufferWriter and check it leads to the same output var bufferWriter = new ArrayBufferWriter(); message.WriteTo(bufferWriter); Assert.AreEqual(bytes, bufferWriter.WrittenSpan.ToArray()); // serialize into a single span and check it leads to the same output var singleSpan = new Span(new byte[messageSize]); message.WriteTo(singleSpan); Assert.AreEqual(bytes, singleSpan.ToArray()); // test for different IBufferWriter.GetSpan() segment sizes for (int blockSize = 1; blockSize < 256; blockSize *= 2) { var segmentedBufferWriter = new ArrayBufferWriter(); segmentedBufferWriter.MaxGrowBy = blockSize; message.WriteTo(segmentedBufferWriter); Assert.AreEqual(bytes, segmentedBufferWriter.WrittenSpan.ToArray()); } // if the full message is small enough, try serializing directly into stack-allocated buffer if (bytes.Length <= 256) { Span stackAllocBuffer = stackalloc byte[bytes.Length]; message.WriteTo(stackAllocBuffer); Assert.AreEqual(bytes, stackAllocBuffer.ToArray()); } } } }