chore(release): v0.3.0
This commit is contained in:
parent
c858a1b161
commit
f5cea73f80
|
@ -9,6 +9,11 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
|
||||||
|
|
||||||
## [Unreleased]
|
## [Unreleased]
|
||||||
|
|
||||||
|
## [0.3.0] - 2022-06-23
|
||||||
|
- updated dependencies
|
||||||
|
### Features
|
||||||
|
- **jwt**: pub use type `TokenData`
|
||||||
|
|
||||||
## [0.2.1] - 2022-06-18
|
## [0.2.1] - 2022-06-18
|
||||||
### Added
|
### Added
|
||||||
- [Examples](https://github.com/MedzikUser/rust-crypto-utils/tree/v0.2.1/examples)
|
- [Examples](https://github.com/MedzikUser/rust-crypto-utils/tree/v0.2.1/examples)
|
||||||
|
@ -24,7 +29,8 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
|
||||||
- Sha1, Sha256, Sha512 hasher
|
- Sha1, Sha256, Sha512 hasher
|
||||||
|
|
||||||
<!-- next-url -->
|
<!-- next-url -->
|
||||||
[Unreleased]: https://github.com/MedzikUser/imgurs/compare/v0.2.1...HEAD
|
[Unreleased]: https://github.com/MedzikUser/imgurs/compare/v0.3.0...HEAD
|
||||||
|
[0.3.0]: https://github.com/MedzikUser/imgurs/commits/v0.3.0
|
||||||
[0.2.1]: https://github.com/MedzikUser/imgurs/commits/v0.2.1
|
[0.2.1]: https://github.com/MedzikUser/imgurs/commits/v0.2.1
|
||||||
[0.2.0]: https://github.com/MedzikUser/imgurs/commits/v0.2.0
|
[0.2.0]: https://github.com/MedzikUser/imgurs/commits/v0.2.0
|
||||||
[0.1.0]: https://github.com/MedzikUser/imgurs/commits/v0.1.0
|
[0.1.0]: https://github.com/MedzikUser/imgurs/commits/v0.1.0
|
||||||
|
|
|
@ -81,7 +81,7 @@ dependencies = [
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "crypto-utils"
|
name = "crypto-utils"
|
||||||
version = "0.2.1"
|
version = "0.3.0"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"anyhow",
|
"anyhow",
|
||||||
"chrono",
|
"chrono",
|
||||||
|
@ -224,18 +224,18 @@ dependencies = [
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "proc-macro2"
|
name = "proc-macro2"
|
||||||
version = "1.0.39"
|
version = "1.0.40"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "c54b25569025b7fc9651de43004ae593a75ad88543b17178aa5e1b9c4f15f56f"
|
checksum = "dd96a1e8ed2596c337f8eae5f24924ec83f5ad5ab21ea8e455d3566c69fbcaf7"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"unicode-ident",
|
"unicode-ident",
|
||||||
]
|
]
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "quote"
|
name = "quote"
|
||||||
version = "1.0.18"
|
version = "1.0.20"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "a1feb54ed693b93a84e14094943b84b7c4eae204c512b7ccb95ab0c66d278ad1"
|
checksum = "3bcdf212e9776fbcb2d23ab029360416bb1706b1aea2d1a5ba002727cbcab804"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"proc-macro2",
|
"proc-macro2",
|
||||||
]
|
]
|
||||||
|
@ -323,7 +323,7 @@ dependencies = [
|
||||||
"num-bigint",
|
"num-bigint",
|
||||||
"num-traits",
|
"num-traits",
|
||||||
"thiserror",
|
"thiserror",
|
||||||
"time 0.3.9",
|
"time 0.3.11",
|
||||||
]
|
]
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
|
@ -334,9 +334,9 @@ checksum = "6e63cff320ae2c57904679ba7cb63280a3dc4613885beafb148ee7bf9aa9042d"
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "syn"
|
name = "syn"
|
||||||
version = "1.0.96"
|
version = "1.0.98"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "0748dd251e24453cb8717f0354206b91557e4ec8703673a4b30208f2abaf1ebf"
|
checksum = "c50aef8a904de4c23c788f104b7dddc7d6f79c647c7c8ce4cc8f73eb0ca773dd"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"proc-macro2",
|
"proc-macro2",
|
||||||
"quote",
|
"quote",
|
||||||
|
@ -376,9 +376,9 @@ dependencies = [
|
||||||
|
|
||||||
[[package]]
|
[[package]]
|
||||||
name = "time"
|
name = "time"
|
||||||
version = "0.3.9"
|
version = "0.3.11"
|
||||||
source = "registry+https://github.com/rust-lang/crates.io-index"
|
source = "registry+https://github.com/rust-lang/crates.io-index"
|
||||||
checksum = "c2702e08a7a860f005826c6815dcac101b19b5eb330c27fe4a5928fec1d20ddd"
|
checksum = "72c91f41dcb2f096c05f0873d667dceec1087ce5bcf984ec8ffb19acddbb3217"
|
||||||
dependencies = [
|
dependencies = [
|
||||||
"itoa",
|
"itoa",
|
||||||
"libc",
|
"libc",
|
||||||
|
|
|
@ -1,6 +1,6 @@
|
||||||
[package]
|
[package]
|
||||||
name = "crypto-utils"
|
name = "crypto-utils"
|
||||||
version = "0.2.1"
|
version = "0.3.0"
|
||||||
description = "Cryptography Utils for Rust"
|
description = "Cryptography Utils for Rust"
|
||||||
authors = ["MedzikUser <nivua1fn@duck.com>"]
|
authors = ["MedzikUser <nivua1fn@duck.com>"]
|
||||||
license = "MIT"
|
license = "MIT"
|
||||||
|
|
|
@ -1,8 +1,5 @@
|
||||||
//! Module for creating and decoding json web token.
|
//! Module for creating and decoding json web token.
|
||||||
//!
|
//!
|
||||||
//! **Required `jwt` feature!**
|
|
||||||
//!
|
|
||||||
//! Examples:
|
|
||||||
//! ```
|
//! ```
|
||||||
//! use crypto_utils::jsonwebtoken::{Claims, Token};
|
//! use crypto_utils::jsonwebtoken::{Claims, Token};
|
||||||
//!
|
//!
|
||||||
|
@ -21,7 +18,7 @@
|
||||||
|
|
||||||
use chrono::{Duration, Utc};
|
use chrono::{Duration, Utc};
|
||||||
use jsonwebtoken::{
|
use jsonwebtoken::{
|
||||||
errors::Error, Algorithm, DecodingKey, EncodingKey, Header, TokenData, Validation,
|
errors::Error, Algorithm, DecodingKey, EncodingKey, Header, Validation,
|
||||||
};
|
};
|
||||||
use serde::{Deserialize, Serialize};
|
use serde::{Deserialize, Serialize};
|
||||||
|
|
||||||
|
@ -57,6 +54,9 @@ impl Claims {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/// The return type of a successful call to [decode](Token::decode).
|
||||||
|
pub type TokenData = jsonwebtoken::TokenData<Claims>;
|
||||||
|
|
||||||
/// Json Web Token
|
/// Json Web Token
|
||||||
#[derive(Debug, Serialize, Deserialize, Clone)]
|
#[derive(Debug, Serialize, Deserialize, Clone)]
|
||||||
pub struct Token {
|
pub struct Token {
|
||||||
|
@ -112,7 +112,7 @@ impl Token {
|
||||||
/// // decode token
|
/// // decode token
|
||||||
/// let decoded = Token::decode(secret, token.encoded).unwrap();
|
/// let decoded = Token::decode(secret, token.encoded).unwrap();
|
||||||
/// ```
|
/// ```
|
||||||
pub fn decode(key: &[u8], token: String) -> Result<TokenData<Claims>, Error> {
|
pub fn decode(key: &[u8], token: String) -> Result<TokenData, Error> {
|
||||||
jsonwebtoken::decode::<Claims>(
|
jsonwebtoken::decode::<Claims>(
|
||||||
&token,
|
&token,
|
||||||
&DecodingKey::from_secret(key),
|
&DecodingKey::from_secret(key),
|
||||||
|
|
63
src/lib.rs
63
src/lib.rs
|
@ -16,70 +16,19 @@
|
||||||
//!
|
//!
|
||||||
//! ```toml
|
//! ```toml
|
||||||
//! [dependencies]
|
//! [dependencies]
|
||||||
//! crypto-utils = "0.2.1"
|
//! crypto-utils = "0.3.0"
|
||||||
//! ```
|
//! ```
|
||||||
//!
|
//!
|
||||||
//! ## How to use?
|
//! ## How to use?
|
||||||
//!
|
//!
|
||||||
//! ### Compute a Sha hash
|
//! Check [jsonwebtoken] and [sha] module
|
||||||
//!
|
|
||||||
//! Add `sha` features (is enabled by default)
|
|
||||||
//!
|
|
||||||
//! ```toml
|
|
||||||
//! [dependencies]
|
|
||||||
//! crypto-utils = { version = "...", features = ["sha"] }
|
|
||||||
//! ```
|
|
||||||
//!
|
|
||||||
//! Quick and easy Sha1, Sha256 and Sha512 hash computing.
|
|
||||||
//!
|
|
||||||
//! ```
|
|
||||||
//! use crypto_utils::sha::{Algorithm, CryptographicHash};
|
|
||||||
//!
|
|
||||||
//! // input data for a hasher
|
|
||||||
//! let input = "P@ssw0rd"; // &str
|
|
||||||
//!
|
|
||||||
//! // compute hash
|
|
||||||
//! let hash_bytes = CryptographicHash::hash(Algorithm::SHA1, input.as_bytes()); // Vec<u8>
|
|
||||||
//!
|
|
||||||
//! // decode hash to a String
|
|
||||||
//! let hash = hex::encode(hash_bytes); // String
|
|
||||||
//!
|
|
||||||
//! assert_eq!(hash, "21bd12dc183f740ee76f27b78eb39c8ad972a757".to_string())
|
|
||||||
//! ```
|
|
||||||
//!
|
|
||||||
//! ### Json Web Token
|
|
||||||
//!
|
|
||||||
//! Add `jwt` features (is enabled by default)
|
|
||||||
//!
|
|
||||||
//! ```toml
|
|
||||||
//! [dependencies]
|
|
||||||
//! crypto-utils = { version = "...", features = ["jwt"] }
|
|
||||||
//! ```
|
|
||||||
//!
|
|
||||||
//! Create and decode a token
|
|
||||||
//!
|
|
||||||
//! ```
|
|
||||||
//! use crypto_utils::jsonwebtoken::{Claims, Token};
|
|
||||||
//!
|
|
||||||
//! let secret = b"secret";
|
|
||||||
//! let user_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
|
|
||||||
//!
|
|
||||||
//! // create claims
|
|
||||||
//! let claims = Claims::new(user_id, 24);
|
|
||||||
//!
|
|
||||||
//! // create token
|
|
||||||
//! let token = Token::new(secret, claims).unwrap();
|
|
||||||
//!
|
|
||||||
//! // decode token
|
|
||||||
//! let decoded = Token::decode(secret, token.encoded).unwrap();
|
|
||||||
//! ```
|
|
||||||
//!
|
//!
|
||||||
//! ## All Feature flags
|
//! ## All Feature flags
|
||||||
//!
|
//!
|
||||||
//! | Feature | Description | Dependencies | Default |
|
//! | Feature | Description | Dependencies | Default |
|
||||||
//! |:-----------|:-------------------------------------------------------------|:-------------------------------------------|:--------|
|
//! |:---------|:------------------------------------------------------------|:----------------------------------------|:--------|
|
||||||
//! | `sha` | Enable support for the Sha1, Sha256 and Sha512 hasher | `sha` and `sha2` | yes |
|
//! | `sha` | Enable support for the Sha1, Sha256 and Sha512 hasher | `sha` and `sha2` | yes |
|
||||||
//! | `jwt` | Enable support for the Json Web Token utils | `chrono`, `serde` and `jsonwebtoken` | yes |
|
//! | `jwt` | Enable support for the Json Web Token utils | `chrono`, `serde` and `jsonwebtoken` | yes |
|
||||||
|
|
||||||
#![warn(missing_docs)]
|
#![warn(missing_docs)]
|
||||||
|
|
||||||
|
|
|
@ -1,8 +1,5 @@
|
||||||
//! Module for creating sha1, sha256 and sha512 hashes.
|
//! Module for creating sha1, sha256 and sha512 hashes.
|
||||||
//!
|
//!
|
||||||
//! **Required `sha` feature!**
|
|
||||||
//!
|
|
||||||
//! Examples:
|
|
||||||
//! ```
|
//! ```
|
||||||
//! use crypto_utils::sha::{Algorithm, CryptographicHash};
|
//! use crypto_utils::sha::{Algorithm, CryptographicHash};
|
||||||
//!
|
//!
|
||||||
|
|
Loading…
Reference in New Issue