1.0.0 • Published 1 year ago

@osjwnpm/vel-expedita-quasi v1.0.0

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

@osjwnpm/vel-expedita-quasi

Common Data Representation serialization and deserialization library

npm version

Introduction

Common Data Representation (CDR) defines a serialization format for primitive types. When combined with an Interface Definition Language (IDL) it can be used to create complex types that can be serialized to disk, transmitted over the network, etc. while transparently handling endianness and alignment requirements. It's specified by https://www.omg.org/spec/DDSI-RTPS/2.3/PDF (chapter 10) and https://www.omg.org/cgi-bin/doc?formal/02-06-51.

XCDR implementation follows DDS-XTypes V1.3 specification.

CDR is found in OMG DDS (Data Distributed Service) implementations such as the Real-Time Publish Subscribe (RTPS) protocol. This is the wire protocol found in ROS2, and CDR is the default serialization format used in rosbag2.

Usage

import { CdrReader, CdrSizeCalculator, CdrWriter } from "@osjwnpm/vel-expedita-quasi";

const calc = new CdrSizeCalculator();
calc.int8();
calc.uint8();
calc.int16();
calc.uint16();
calc.int32();
calc.uint32();
calc.int64();
calc.uint64();
calc.float32();
calc.float64();
calc.string("abc".length);
calc.sequenceLength();
console.log(calc.size);

const writer = new CdrWriter();
writer.int8(-1);
writer.uint8(2);
writer.int16(-300);
writer.uint16(400);
writer.int32(-500_000);
writer.uint32(600_000);
writer.int64(-7_000_000_001n);
writer.uint64(8_000_000_003n);
writer.float32(-9.14);
writer.float64(1.7976931348623158e100);
writer.string("abc");
writer.sequenceLength(0);

const reader = new CdrReader(writer.data);
console.log(reader.int8());
console.log(reader.uint8());
console.log(reader.int16());
console.log(reader.uint16());
console.log(reader.int32());
console.log(reader.uint32());
console.log(reader.int64());
console.log(reader.uint64());
console.log(reader.float32());
console.log(reader.float64());
console.log(reader.string());
console.log(reader.sequenceLength());

Alternatives

jscdr - Does not support bigint, pre-allocated buffers, or buffer length calculations.

License

@osjwnpm/vel-expedita-quasi is licensed under the MIT License.

Releasing

  1. Run yarn version --[major|minor|patch] to bump version
  2. Run git push && git push --tags to push new tag
  3. GitHub Actions will take care of the rest

Stay in touch

Join our Slack channel to ask questions, share feedback, and stay up to date on what our team is working on.

deep-cloneeslintpluginlivefindpicomatchfastclonetoobjectcliterminaltraversepostcss-pluginencryptionarraybufferTypeBoxcreateJSON-Schemapreserve-symlinksdeepclonegetintrinsiccryptojavascriptoptioncss variableonceremovenamemoveES8rmdirmimetypeschinesecompile lessavamatchAllsetImmediatejasmineutilitysyntaxerrorhasOwnES7descriptorstoArrayvestreadableWeakSetstylecommandglaciereslint-plugineventsaccessibilityprotohasOwnPropertyless mixinses-abstractarraysstylesoffsetUint32ArraywhichurlperformancenpmtypeerrorObject.fromEntrieschaiUint8ArrayFloat64ArraysharedrmresolveFloat32ArrayartsearchbundlingArray.prototype.containsxtermfunctionsfindupdomminimalESroutingexecamazonmapES2022awesomesauceauthlockfilepatchECMAScript 2020ArrayBufferconcurrencyfast-deep-cloneautoprefixervaluemime-dbes7inputinternalfluxdeepbrowserlistreducerbusydebuggerES3Object.istakeroute53Symbol.toStringTagemrjsdiffstablesequenceregexglobsortedparserunicodeec2folderentrieslrutddECMAScript 2019invariantes2016Uint8ClampedArrayasciiCSSStyleDeclarationRFC-6455safesharedarraybufferPushforEachdependenciesUnderscorerequestECMAScript 7passwordtslibauthenticationfileutilitiesRxJScompareES2016dom-testing-libraryworkerECMAScript 2018nested cssrm -frmkdirpfindLastIndexiddotenvbddES2017loadbalancingdeep-copyxhrhas-ownzodecmascriptgroupiterationsettingssymlinklocationArray.prototype.includesi18nimmutablecollectionincludescall-bounddatastructuretypedmergemakeArray.prototype.findLastIndexargparselengthlastsymlinksbyteOffsetloggingcode pointssqsECMAScript 2017real-time__proto__serializefast-copy256lessbyteLengthcorsclassnameargsescapeBigUint64ArrayECMAScript 2021computed-typesCSSpropertydropcontainsestreewidthhookformstyled-componentsbrowserslistpolyfillsuperagentlistenersrequirethroatstateObject.assignoptimistparsepreprocessortapeparsingcodesconfigurableupObject.keyscoreeventDispatcher$.extendtextspeedObject.getPrototypeOfconcatajvindicatorchromiumidlejestdescriptordebugsnscloudformationstylesheetdateAsyncIteratorwritabletestnativereact-hook-formownmkdirses8cloneredux-toolkitpackageshelperstypeofhashfast-clonecommanderkeyRxIteratorgetoptcallbackflagkeystypescolumnprotocol-buffersfullwidthstatelesslesscsselmmimeArray.prototype.flattencallboundargvdataviewArrayformattingless compilercollection.es6toStringTagObject.valuestasksyntaxmapreduceTypedArrayawaitconnectinstallerString.prototype.triminferencefastcopyelbwhatwgmodulecolortoolkitECMAScript 6ES2023formassertionwatcherBigInt64ArrayObjectfile systemroutereactsimpledbnopergbfastifypathbluebirdWebSocketstoolswordwrapexpressebspiperegular expressionsES5classesiamdefinePropertyES2020typedarraysequalemojiES2018agentWeakMapArray.prototype.flatMapobjgradients css3Observablesstringifiereslintyupslicecheckconsumeextendloggers3touchpromisegetPrototypeOfcssnegativestyleguidevariables in cssdataclassnamesasyncmake diriteratorproxywatchingmodulesdirectorybundlerframeworkserializationelectronObject.definePropertypnpm9client
1.0.0

1 year ago