comparison rust/hg-core/src/revlog.rs @ 44143:7f86426fdd2c

rust-node: binary Node ID and conversion utilities The choice of type makes sure that a `Node` has the exact wanted size. We'll use a different type for prefixes. Added dependency: hexadecimal conversion relies on the `hex` crate. The fact that sooner or later Mercurial is going to need to change its hash sizes has been taken strongly in consideration: - the hash length is a constant, but that is not directly exposed to callers. Changing the value of that constant is the only thing to do to change the hash length (even in unit tests) - the code could be adapted to support several sizes of hashes, if that turned out to be useful. To that effect, only the size of a given `Node` is exposed in the public API. - callers not involved in initial computation, I/O and FFI are able to operate without a priori assumptions on the hash size. The traits `FromHex` and `ToHex` have not been directly implemented, so that the doc-comments explaining these restrictions would stay really visible in `cargo doc` Differential Revision: https://phab.mercurial-scm.org/D7788
author Georges Racinet <georges.racinet@octobus.net>
date Wed, 22 Jan 2020 16:37:05 +0100
parents 63db6657d280
children 3fb39dc2e356
comparison
equal deleted inserted replaced
44142:63db6657d280 44143:7f86426fdd2c
3 // 3 //
4 // This software may be used and distributed according to the terms of the 4 // This software may be used and distributed according to the terms of the
5 // GNU General Public License version 2 or any later version. 5 // GNU General Public License version 2 or any later version.
6 //! Mercurial concepts for handling revision history 6 //! Mercurial concepts for handling revision history
7 7
8 pub mod node;
8 pub mod nodemap; 9 pub mod nodemap;
10 pub use node::{Node, NodeError};
9 11
10 /// Mercurial revision numbers 12 /// Mercurial revision numbers
11 /// 13 ///
12 /// As noted in revlog.c, revision numbers are actually encoded in 14 /// As noted in revlog.c, revision numbers are actually encoded in
13 /// 4 bytes, and are liberally converted to ints, whence the i32 15 /// 4 bytes, and are liberally converted to ints, whence the i32