Crates.io | just-a-tag |
lib.rs | just-a-tag |
version | 0.1.1 |
source | src |
created_at | 2023-07-18 21:04:10.198594 |
updated_at | 2023-07-18 21:08:05.470268 |
description | A #tag-type, RFC 1035 DNS label compatible |
homepage | https://github.com/sunsided/just-a-tag |
repository | https://github.com/sunsided/just-a-tag |
max_upload_size | |
id | 919758 |
size | 37,967 |
This crate contains the Tag
type, an RFC 1035
DNS label compatible string, with parsing FromStr
and optional serde support.
use justatag::Tag;
fn tags() {
assert_eq!(Tag::new("some-tag"), "some-tag");
assert_eq!(Tag::from_str("some-tag").unwrap(), "some-tag");
assert!(Tag::from_str("invalid-").is_err());
}
A bit untrue to the crate's name, it also provides the [TagUnion
] type, which represents
(unsurprisingly, this time) a union of tags.
use std::collections::HashSet;
use justatag::{MatchesAnyTagUnion, Tag, TagUnion};
fn tag_unions() {
let union = TagUnion::from_str("foo").unwrap();
assert!(union.contains(&Tag::new("foo")));
assert_eq!(union.len(), 1);
let union = TagUnion::from_str("foo+bar").unwrap();
assert!(union.contains(&Tag::new("foo")));
assert!(union.contains(&Tag::new("bar")));
assert_eq!(union.len(), 2);
// TagUnions are particularly interesting when bundled up.
let unions = vec![
TagUnion::from_str("bar+baz").unwrap(),
TagUnion::from_str("foo").unwrap()
];
// foo matches
let set_1 = HashSet::from_iter([Tag::new("foo"), Tag::new("bar")]);
assert!(unions.matches_set(&set_1));
// bar+baz matches
let set_2 = HashSet::from_iter([Tag::new("fubar"), Tag::new("bar"), Tag::new("baz")]);
assert!(unions.matches_set(&set_2));
// none match
let set_3 = HashSet::from_iter([Tag::new("fubar"), Tag::new("bar")]);
assert!(!unions.matches_set(&set_3));
}