Struct UserAgentDatabase 

pub struct UserAgentDatabase { /* private fields */ }

Available on crate features std and ua only.

In-memory catalogue of captured user-agent profiles.

Profiles are drawn per request flow by UserAgentDatabase::select, weighted by how often each was observed, and can be looked up by exact User-Agent header value.

Implementations

impl UserAgentDatabase

pub fn select( &self, request: &SelectionRequest, seed: ProfileSeed, key: DrawKey, ) -> Result<SelectedProfile, SelectionError>

impl UserAgentDatabase

pub fn try_embedded() -> Result<UserAgentDatabase, Box<dyn Error + Send + Sync>>

Available on crate feature embed-profiles only.

Load the profiles embedded with the rama-ua crate.

This function is only available if the embed-profiles feature is enabled.

pub fn try_from_json_slice( bytes: &[u8], ) -> Result<UserAgentDatabase, Box<dyn Error + Send + Sync>>

Load a user-agent database from a JSON array of UserAgentProfileInput rows.

Complementary rows with the same User-Agent are merged and converted into captured profiles; missing HTTP/1, HTTP/2 or TLS components are never synthesized.

pub fn try_from_archive( bytes: &[u8], authorized: bool, current_day: u32, horizon: u32, limits: ProfileArchiveLimits, ) -> Result<UserAgentDatabase, Box<dyn Error + Send + Sync>>

pub fn candidates( &self, filter: ProfileCandidateFilter<'_>, ) -> Result<Box<[ProfileCandidate<'_>]>, ProfileDataError>

pub fn len(&self) -> usize

Get the number of profiles in the database.

pub fn is_empty(&self) -> bool

Check if the database is empty.

pub fn iter_ua_str(&self) -> impl Iterator<Item = &str>

Iterate over the User-Agent header value strings in the database.

pub fn insert(&mut self, profile: UserAgentProfile)

Insert a new UserAgentProfile into the database, also indexing it by its User-Agent header value.

pub fn get_exact_header_str( &self, ua: &str, ) -> impl Iterator<Item = &UserAgentProfile>

Every UserAgentProfile observed with exactly this User-Agent header value.

pub fn iter(&self) -> impl Iterator<Item = &UserAgentProfile>

Iterate over all UserAgentProfiles in the database.

Trait Implementations

impl Debug for UserAgentDatabase

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for UserAgentDatabase

fn default() -> UserAgentDatabase

Returns the “default value” for a type.

impl FromIterator<UserAgentProfile> for UserAgentDatabase

fn from_iter<T>(iter: T) -> UserAgentDatabase

where T: IntoIterator<Item = UserAgentProfile>,

Creates a value from an iterator.

impl ProfileSource for UserAgentDatabase

fn select_profile( &self, request: &SelectionRequest, seed: ProfileSeed, key: DrawKey, ) -> Result<SelectedProfile, SelectionError>

Draw a profile for one request flow.