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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
//! # Utility Library
//!
//! This library provides a collection of utility modules for common programming tasks.
//! Many features are optional and can be enabled via feature flags.
//!
//! ## Features
//!
//! The library supports the following optional features that can be enabled in your `Cargo.toml`:
//! - `base64`: Enables base64 encoding/decoding utilities
//! - `hmac`: Provides HMAC cryptographic functionality
//! - `jwt`: Includes JSON Web Token handling
//! - `crypto`: Enables password hashing and cryptographic functions
//! - `reqwest`: Provides HTTP client utilities
//! - `regex`: Enables regular expression functionality and text cleaning utilities
//!
//! ## Modules
//!
//! ### Always Available Modules
//!
//! * `form` - Form handling utilities
//! * `fs` - File system operations
//! * `json` - JSON processing utilities
//! * `number` - Numeric type conversions and operations
//! * `once_lock` - Thread-safe initialization primitives
//! * `string` - String manipulation utilities
//! * `time` - Time and date handling functions
//! * `blk` - Re-exported tokio blocking operations
//!
//! ### Feature-Gated Modules
//!
//! * `base64` (requires `base64` feature) - Base64 encoding and decoding
//! * `hmac` (requires `hmac` feature) - HMAC message authentication
//! * `jwt` (requires `jwt` feature) - JSON Web Token operations
//! * `password` (requires `crypto` feature) - Password hashing and verification
//! * `reqwest` (requires `reqwest` feature) - HTTP client utilities
//! * `regex` (requires `regex` feature) - Regular expression operations and validation
//! * `text_cleaner` (requires `regex` feature) - Text cleaning and sanitization utilities
//!
//! ## Usage
//!
//! Add this to your `Cargo.toml`:
//!
//! ```toml
//! [dependencies]
//! foxtive = { version = "0.7", features = ["base64", "jwt", "regex"] }
//! ```
//!
//! ## Examples
//!
//! Using the JSON utilities:
//! ```rust
//! use foxtive::helpers::json;
//!
//! // Example JSON operations
//! ```
//!
//! Using the file system utilities:
//! ```rust
//! use foxtive::helpers::fs;
//!
//! // Example file system operations
//! ```
//!
//! ## Feature Combinations
//!
//! Some features work well together:
//! - `jwt` + `hmac` for signed JWT tokens
//! - `crypto` + `base64` for password hashing with encoded output
//! - `reqwest` + `json` for HTTP API interactions
//!
//! ## Thread Safety
//!
//! Most utilities in this library are designed to be thread-safe and can be safely
//! used in async contexts. The `once_lock` module specifically provides thread-safe
//! initialization primitives.
//!
//! ## Error Handling
//!
//! Operations that can fail return `Result` types. It's recommended to use the
//! `anyhow` crate for error handling when working with this library.
//!
//! ## Async Support
//!
//! Many operations in this library support async/await syntax, particularly in the
//! `reqwest` and file system operations. The library uses tokio as its async runtime.
pub use ;
pub use ;
pub use *;