From ea00d06fc614c632a4c7250ef0c769705ed8c1c3 Mon Sep 17 00:00:00 2001 From: Robin Krahl Date: Tue, 22 May 2018 09:11:27 +0000 Subject: Add an example for setting the current time The example uses the chrono crate and can therefore not be executed, but at least it shows how to set the Nitrokey device to the current time. --- src/device.rs | 22 +++++++++++++++++++++- src/otp.rs | 14 +++++++++++--- 2 files changed, 32 insertions(+), 4 deletions(-) (limited to 'src') diff --git a/src/device.rs b/src/device.rs index 6c1a957..ce45a50 100644 --- a/src/device.rs +++ b/src/device.rs @@ -99,13 +99,33 @@ pub trait Device { /// /// The time is used for TOTP generation (see [`get_totp_code`][]). /// + /// # Example + /// + /// ```ignore + /// extern crate chrono; + /// + /// use chrono::Utc; + /// use nitrokey::Device; + /// # use nitrokey::CommandError; + /// + /// # fn try_main() -> Result<(), CommandError> { + /// let device = nitrokey::connect()?; + /// let time = Utc::now().timestamp(); + /// if time < 0 { + /// println!("Timestamps before 1970-01-01 are not supported!"); + /// } else { + /// device.set_time(time as u64); + /// } + /// # Ok(()) + /// # } + /// ``` + /// /// # Errors /// /// - [`Timestamp`][] if the time could not be set /// /// [`get_totp_code`]: trait.ProvideOtp.html#method.get_totp_code /// [`Timestamp`]: enum.CommandError.html#variant.Timestamp - // TODO: example fn set_time(&self, time: u64) -> CommandStatus { unsafe { CommandStatus::from(nitrokey_sys::NK_totp_set_time(time)) } } diff --git a/src/otp.rs b/src/otp.rs index c951d5f..0451c5f 100644 --- a/src/otp.rs +++ b/src/otp.rs @@ -256,14 +256,22 @@ pub trait GenerateOtp { /// /// # Example /// - /// ```no_run + /// ```ignore + /// extern crate chrono; + /// /// use nitrokey::GenerateOtp; /// # use nitrokey::CommandError; /// /// # fn try_main() -> Result<(), CommandError> { /// let device = nitrokey::connect()?; - /// let code = device.get_totp_code(1)?; - /// println!("Generated TOTP code on slot 1: {:?}", code); + /// let time = Utc::now().timestamp(); + /// if time < 0 { + /// println!("Timestamps before 1970-01-01 are not supported!"); + /// } else { + /// device.set_time(time as u64); + /// let code = device.get_totp_code(1)?; + /// println!("Generated TOTP code on slot 1: {:?}", code); + /// } /// # Ok(()) /// # } /// ``` -- cgit v1.2.1