     1
     2
     3
     4
     5
     6
     7
     8
     9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    36
    37
    38
    39
    40
    41
    42
    43
    44
    45
    46
    47
    48
    49
    50
    51
    52
    53
    54
    55
    56
    57
    58
    59
    60
    61
    62
    63
    64
    65
    66
    67
    68
    69
    70
    71
    72
    73
    74
    75
    76

    // Copyright 2015-2017 Parity Technologies (UK) Ltd.
    // This file is part of Parity.

    // Parity is free software: you can redistribute it and/or modify
    // it under the terms of the GNU General Public License as published by
    // the Free Software Foundation, either version 3 of the License, or
    // (at your option) any later version.

    // Parity is distributed in the hope that it will be useful,
    // but WITHOUT ANY WARRANTY; without even the implied warranty of
    // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    // GNU General Public License for more details.

    // You should have received a copy of the GNU General Public License
    // along with Parity.  If not, see <http://www.gnu.org/licenses/>.

    //! Diff misc.

    use common::*;
    use rlp::{Stream, RlpStream};
    use target_info::Target;

    include!(concat!(env!("OUT_DIR"), "/version.rs"));
    include!(concat!(env!("OUT_DIR"), "/rustc_version.rs"));

    #[cfg(feature = "final")]
    const THIS_TRACK: &'static str = "nightly";
    // ^^^ should be reset to "stable" or "beta" according to the release branch.

    #[cfg(not(feature = "final"))]
    const THIS_TRACK: &'static str = "unstable";
    // ^^^ This gets used when we're not building a final release; should stay as "unstable".

    /// Boolean type for clean/dirty status.
    #[derive(PartialEq, Eq, Clone, Copy, Debug)]
    pub enum Filth {
    	/// Data has not been changed.
    	Clean,
    	/// Data has been changed.
    	Dirty,
    }

    /// Get the platform identifier.
    pub fn platform() -> String {
    	let env = Target::env();
    	let env_dash = if env.is_empty() { "" } else { "-" };
    	format!("{}-{}{}{}", Target::arch(), Target::os(), env_dash, env)
    }

    /// Get the standard version string for this software.
    pub fn version() -> String {
    	let sha3 = short_sha();
    	let sha3_dash = if sha3.is_empty() { "" } else { "-" };
    	let commit_date = commit_date().replace("-", "");
    	let date_dash = if commit_date.is_empty() { "" } else { "-" };
    	format!("Parity/v{}-{}{}{}{}{}/{}/rustc{}", env!("CARGO_PKG_VERSION"), THIS_TRACK, sha3_dash, sha3, date_dash, commit_date, platform(), rustc_version())
    }

    /// Get the standard version data for this software.
    pub fn version_data() -> Bytes {
    	let mut s = RlpStream::new_list(4);
    	let v =
    		(u32::from_str(env!("CARGO_PKG_VERSION_MAJOR")).expect("Environment variables are known to be valid; qed") << 16) +
    		(u32::from_str(env!("CARGO_PKG_VERSION_MINOR")).expect("Environment variables are known to be valid; qed") << 8) +
    		u32::from_str(env!("CARGO_PKG_VERSION_PATCH")).expect("Environment variables are known to be valid; qed");
    	s.append(&v);
    	s.append(&"Parity");
    	s.append(&rustc_version());
    	s.append(&&Target::os()[0..2]);
    	s.out()
    }

    /// Provide raw information on the package.
    pub fn raw_package_info() -> (&'static str, &'static str, &'static str) {
    	(THIS_TRACK, env!["CARGO_PKG_VERSION"], sha())
    }

# Help

## Keyboard Shortcuts

?
  Show this help dialog
S
  Focus the search field
⇤
  Move up in search results
⇥
  Move down in search results
⏎
  Go to active search result
+
  Collapse/expand all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)