saymrwulf/curve25519-dalek-source
1
0
Fork 0
mirror of https://github.com/saymrwulf/curve25519-dalek-source.git synced 2026-09-06 20:41:14 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Make all the doctests actually run.

Browse source
This commit is contained in:
Isis Lovecruft 2017-03-14 21:50:17 +00:00
parent 5a30f4eb0f
commit d00c3f9f3c
Failed to extract signature
2 changed files with 61 additions and 16 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
src/ed25519.rs
View file

@ -301,16 +301,16 @@ impl Keypair {
/// ///
/// ``` /// ```
/// extern crate rand; /// extern crate rand;
/// extern crate ed25519;
/// extern crate sha2; /// extern crate sha2;
/// extern crate ed25519_dalek;
/// ///
/// # fn main() { /// # fn main() {
/// ///
/// use rand::Rng; /// use rand::Rng;
/// use rand::OsRng; /// use rand::OsRng;
/// use sha2::Sha512; /// use sha2::Sha512;
/// use ed25519::Keypair; /// use ed25519_dalek::Keypair;
/// use ed25519::Signature; /// use ed25519_dalek::Signature;
/// ///
/// let mut cspring: OsRng = OsRng::new().unwrap(); /// let mut cspring: OsRng = OsRng::new().unwrap();
/// let keypair: Keypair = Keypair::generate::<Sha512>(&mut cspring); /// let keypair: Keypair = Keypair::generate::<Sha512>(&mut cspring);

71
src/lib.rs
View file

@ -14,49 +14,94 @@
//! //!
//! Creating an ed25519 signature on a message is simple. //! Creating an ed25519 signature on a message is simple.
//! //!
//! First, we need to generate a `Keypair`, which includes both public //! First, we need to generate a `Keypair`, which includes both public and
//! and secret halves of an asymmetric key. To do so, we need a //! secret halves of an asymmetric key. To do so, we need a cryptographically
//! cryptographically secure random number generator (CSPRING). For //! secure pseudorandom number generator (CSPRING), and a hash function which
//! this example, we'll use the operating system's builtin PRNG to //! has 512 bits of output. For this example, we'll use the operating
//! generate a keypair: //! system's builtin PRNG and SHA-512 to generate a keypair:
//! //!
//! ```ignore //! ```
//! extern crate rand; //! extern crate rand;
//! extern crate ed25519; //! extern crate sha2;
//! extern crate ed25519_dalek;
//! //!
//! # fn main() {
//! use rand::Rng; //! use rand::Rng;
//! use rand::OsRng; //! use rand::OsRng;
//! use ed25519::Keypair; //! use sha2::Sha512;
//! use ed25519::Signature; //! use ed25519_dalek::Keypair;
//! use ed25519_dalek::Signature;
//! //!
//! let mut cspring: OsRng = OsRng::new().unwrap(); //! let mut cspring: OsRng = OsRng::new().unwrap();
//! let keypair: Keypair = Keypair::generate(&mut cspring); //! let keypair: Keypair = Keypair::generate::<Sha512>(&mut cspring);
//! # }
//! ``` //! ```
//! //!
//! We can now use this `keypair` to sign a message: //! We can now use this `keypair` to sign a message:
//! //!
//! ```ignore //! ```
//! # extern crate rand;
//! # extern crate sha2;
//! # extern crate ed25519_dalek;
//! # fn main() {
//! # use rand::Rng;
//! # use rand::OsRng;
//! # use sha2::Sha512;
//! # use ed25519_dalek::Keypair;
//! # use ed25519_dalek::Signature;
//! # let mut cspring: OsRng = OsRng::new().unwrap();
//! # let keypair: Keypair = Keypair::generate::<Sha512>(&mut cspring);
//! let message: &[u8] = "This is a test of the tsunami alert system.".as_bytes(); //! let message: &[u8] = "This is a test of the tsunami alert system.".as_bytes();
//! let signature: Signature = keypair.sign(message); //! let signature: Signature = keypair.sign(message);
//! # }
//! ``` //! ```
//! //!
//! As well as to verify that this is, indeed, a valid signature on //! As well as to verify that this is, indeed, a valid signature on
//! that `message`: //! that `message`:
//! //!
//! ```ignore //! ```
//! # extern crate rand;
//! # extern crate sha2;
//! # extern crate ed25519_dalek;
//! # fn main() {
//! # use rand::Rng;
//! # use rand::OsRng;
//! # use sha2::Sha512;
//! # use ed25519_dalek::Keypair;
//! # use ed25519_dalek::Signature;
//! # let mut cspring: OsRng = OsRng::new().unwrap();
//! # let keypair: Keypair = Keypair::generate::<Sha512>(&mut cspring);
//! # let message: &[u8] = "This is a test of the tsunami alert system.".as_bytes();
//! # let signature: Signature = keypair.sign(message);
//! let verified: bool = keypair.verify(message, &signature); //! let verified: bool = keypair.verify(message, &signature);
//! //!
//! assert!(verified); //! assert!(verified);
//! # }
//! ``` //! ```
//! //!
//! Anyone else, given the `public` half of the `keypair` can also easily //! Anyone else, given the `public` half of the `keypair` can also easily
//! verify this signature: //! verify this signature:
//! //!
//! ```ignore //! ```
//! # extern crate rand;
//! # extern crate sha2;
//! # extern crate ed25519_dalek;
//! # fn main() {
//! # use rand::Rng;
//! # use rand::OsRng;
//! # use sha2::Sha512;
//! # use ed25519_dalek::Keypair;
//! # use ed25519_dalek::Signature;
//! use ed25519_dalek::PublicKey;
//! # let mut cspring: OsRng = OsRng::new().unwrap();
//! # let keypair: Keypair = Keypair::generate::<Sha512>(&mut cspring);
//! # let message: &[u8] = "This is a test of the tsunami alert system.".as_bytes();
//! # let signature: Signature = keypair.sign(message);
//! let public_key: PublicKey = keypair.public; //! let public_key: PublicKey = keypair.public;
//! let verified: bool = public_key.verify(message, &signature); //! let verified: bool = public_key.verify(message, &signature);
//! //!
//! assert!(verified); //! assert!(verified);
//! # }
//! ``` //! ```
#![no_std] #![no_std]