Mercurial > public > mercurial-scm > hg-stable
comparison mercurial/wireprototypes.py @ 39819:d059cb669632
wireprotov2: allow multiple fields to follow revision maps
The *data wire protocol commands emit a series of CBOR values.
Because revision/delta data may be large, their data is emitted
outside the map as a top-level bytestring value.
Before this commit, we'd emit a single optional bytestring
value after the revision descriptor map. This got the job done.
But it was limiting in that we could only send a single field.
And, it required the consumer to know that the presence of a
key in the map implied the existence of a following bytestring
value.
This commit changes the encoding strategy so top-level bytestring
values in the stream are explicitly denoted in a "fieldsfollowing"
key. This key contains an array defining what fields that follow
and the expected size of each field.
By defining things this way, we can easily send N bytestring
values without any ambiguity about their order. In addition,
clients only need to know how to parse ``fieldsfollowing`` to
know if extra values are present.
Because this breaks backwards compatibility, we've bumped the version
number of the wire protocol version 2 API endpoint.
Differential Revision: https://phab.mercurial-scm.org/D4620
author | Gregory Szorc <gregory.szorc@gmail.com> |
---|---|
date | Thu, 20 Sep 2018 12:57:23 -0700 |
parents | 07b58266bce3 |
children | ed919b90acda |
comparison
equal
deleted
inserted
replaced
39818:c30faea8d02d | 39819:d059cb669632 |
---|---|
20 | 20 |
21 # Names of the SSH protocol implementations. | 21 # Names of the SSH protocol implementations. |
22 SSHV1 = 'ssh-v1' | 22 SSHV1 = 'ssh-v1' |
23 # These are advertised over the wire. Increment the counters at the end | 23 # These are advertised over the wire. Increment the counters at the end |
24 # to reflect BC breakages. | 24 # to reflect BC breakages. |
25 SSHV2 = 'exp-ssh-v2-0001' | 25 SSHV2 = 'exp-ssh-v2-0002' |
26 HTTP_WIREPROTO_V2 = 'exp-http-v2-0001' | 26 HTTP_WIREPROTO_V2 = 'exp-http-v2-0002' |
27 | 27 |
28 # All available wire protocol transports. | 28 # All available wire protocol transports. |
29 TRANSPORTS = { | 29 TRANSPORTS = { |
30 SSHV1: { | 30 SSHV1: { |
31 'transport': 'ssh', | 31 'transport': 'ssh', |