12 releases (3 stable)
new 1.1.1 | Dec 3, 2024 |
---|---|
1.1.0 | Nov 29, 2024 |
1.0.0 | Oct 24, 2024 |
0.5.0 | Oct 24, 2024 |
0.1.3 | Oct 22, 2024 |
#319 in Data structures
135 downloads per month
60KB
941 lines
form_builder
A library for building forms with various fields and validation.
Overview
form_builder
is a Rust library designed to simplify the creation and validation of forms. It provides a flexible way to define forms with different types of fields, including text fields, select fields, and multiselect fields. The library also supports custom validation for these fields, making it easy to ensure that user input meets specific criteria.
Features
- Flexible Form Creation: Easily create forms with various types of fields.
- Custom Validation: Define custom validation rules for each field.
- Optional Fields: Support for optional fields using the
Optional
type. - Select and Multiselect Fields: Built-in support for select and multiselect fields.
- Comprehensive Error Handling: Detailed error messages for validation failures.
Installation
To use form_builder
in your project, add the following to your Cargo.toml
:
[dependencies]
form_builder = "1.1.1"
Example
use form_builder::{FormBuilder, Optional, ValidationMethods, Validator};
fn validate_custom(value: &str) -> bool {
value.len() > 5
}
fn main() -> Result<(), String> {
let mut form = FormBuilder::new()
.add_field::<String>(
"name",
"Enter name:",
Some(Validator::new(vec![
(ValidationMethods::not_empty, Some("Name cannot be empty")),
(
ValidationMethods::validate_name,
Some("Name cannot contain numbers"),
),
])),
)
.add_field::<String>(
"email",
"Enter email:",
Some(Validator::new(vec![
(ValidationMethods::not_empty, Some("Email cannot be empty")),
(
ValidationMethods::validate_email,
Some("Invalid email format"),
),
])),
)
.add_field::<u32>(
"age",
"Enter age:",
Some(Validator::new(vec![(
ValidationMethods::not_empty,
Some("Age cannot be empty"),
)])),
)
.add_field::<String>(
"custom",
"Enter custom value:",
Some(Validator::new(vec![
(
ValidationMethods::not_empty,
Some("Custom value cannot be empty"),
),
(
validate_custom,
Some("Custom value must be longer than 5 characters"),
),
])),
)
.add_field::<f64>(
"height",
"Enter height:",
Some(Validator::new(vec![(
ValidationMethods::not_empty,
Some("Height cannot be empty"),
)])),
)
.add_field::<bool>(
"is_student",
"Are you a student (true/false):",
Some(Validator::new(vec![(
ValidationMethods::not_empty,
Some("This field cannot be empty"),
)])),
)
.add_field::<char>(
"initial",
"Enter your initial:",
Some(Validator::new(vec![(
ValidationMethods::not_empty,
Some("Initial cannot be empty"),
)])),
)
.add_field::<Optional<u32>>("width", "Enter width (optional):", None)
.add_select(
"gender",
"Select your gender:",
vec![
(1u32, "Male"),
(2u32, "Female"),
(3u32, "Other"),
],
)
.add_multiselect(
"hobbies",
"Select your hobbies:",
vec![
("reading".to_string(), "Reading"),
("sports".to_string(), "Sports"),
("music".to_string(), "Music"),
],
Some(2),
)
.build();
form.fill()?;
let name: String = form.get_value("name")?;
let email: String = form.get_value("email")?;
let age: u32 = form.get_value("age")?;
let custom: String = form.get_value("custom")?;
let height: f64 = form.get_value("height")?;
let is_student: bool = form.get_value("is_student")?;
let initial: char = form.get_value("initial")?;
let width: Optional<u32> = form.get_value("width")?;
let gender: u32 = form.get_value("gender")?;
let hobbies: Vec<String> = form.get_value_vec("hobbies")?;
let width = process_width(width);
println!(
"Name: {:?}, Email: {:?}, Age: {:?}, Custom: {:?}, Height: {:?}, Is Student: {:?}, Initial: {:?}, Width: {:?}, Gender: {:?}, Hobbies: {:?}",
name, email, age, custom, height, is_student, initial, width, gender, hobbies
);
Ok(())
}
fn process_width(width: Optional<u32>) -> u32 {
match width {
Optional::Some(value) => value + 20,
Optional::None => 0,
}
}
Documentation
For more detailed documentation, including all available methods and examples, please refer to the API documentation.
License
This project is licensed under the MIT License. See the LICENSE file for more details.
Dependency Licenses
This project uses the following packages under the MIT license:
Each of these packages includes an MIT license file, which can be found in their repositories.
Contributing
Contributions are welcome! If you find a bug or have a feature request, please open an issue on GitHub. If you would like to contribute code, please fork the repository and submit a pull request.
Acknowledgements
Special thanks to the Rust community for their support and contributions to the ecosystem. This library would not be possible without the hard work and dedication of many individuals.
Contact
For questions or feedback, please contact the maintainer at [gawrmiko@gmail.com]
Dependencies
~2.2–3.5MB
~56K SLoC