Struct Cleaner 

pub struct Cleaner<'a> {
    pub docs: Cow<'a, CleanerDocs>,
    pub params: Params<'a>,
    pub commons: Cow<'a, Commons>,
    pub actions: Cow<'a, [Action]>,
}

The config that determines all behavior of how URLs are cleaned.

Fields

docs: Cow<'a, CleanerDocs>

The documentation.

Defaults to an empty CleanerDocs.

params: Params<'a>

Tuning shared between all Tasks spawned with this Cleaner.

Defaults to an empty Params.

commons: Cow<'a, Commons>

Basically functions.

Defaults to an empty Commons.

actions: Cow<'a, [Action]>

The Actions to apply.

Defaults to an empty Vec.

Implementations

impl<'a> Cleaner<'a>

pub fn borrowed(&'a self) -> Self

Create a new Self that Cow::Borroweds all fields.

Basically a very cheap Clone that you can apply ParamsDiffs to.

pub fn load_from_file<T: AsRef<Path>>( path: T, ) -> Result<Cleaner<'static>, GetCleanerError>

Load Self from a JSON file.

Errors

If the call to std::fs::read_to_string returns an error, that error is returned.

If the call to serde_json::from_str returns an error, that error is returned.

pub fn get_default() -> Result<&'static Cleaner<'static>, GetCleanerError>

Gets the default Self compiled into the binary itself.

If you know you’re only going to get the default config once, Self::get_default_no_cache is better because you can apply ParamsDiffs to it without Clone::cloneing.

Errors

If the call to Self::get_default_no_cache returns an error, that error is returned. If the call to Self::get_default_no_cache returns an error, that error is returned.

Examples

use url_cleaner_engine::types::*;

Cleaner::get_default().unwrap();

pub fn get_default_no_cache() -> Result<Cleaner<'static>, GetCleanerError>

Deserializes DEFAULT_CLEANER_STR and returns it without caching.

If you’re getting the default config often and rarely using ParamsDiffs, Self::get_default may be better due to it only deserializing the config once.

Errors

If the call to serde_json::from_str returns an error, that error is returned.

Examples

use url_cleaner_engine::types::*;

Cleaner::get_default_no_cache().unwrap();

pub fn load_or_get_default<T: AsRef<Path>>( path: Option<T>, ) -> Result<Cow<'static, Self>, GetCleanerError>

If path is Some, returns the result of Self::load_from_file in a Cow::Owned.

If path is None, returns the result of Self::get_default in a Cow::Borrowed.

Errors

If the call to Self::load_from_file returns an error, that error is returned.

If the call to Self::get_default returns an error, that error is returned.

Examples

use url_cleaner_engine::types::*;

assert_eq!(
    Cleaner::get_default().unwrap(),
    &*Cleaner::load_or_get_default(None::<&str>).unwrap()
);

assert_eq!(
    Cleaner::get_default().unwrap(),
    &*Cleaner::load_or_get_default(Some("default-cleaner.json")).unwrap()
);

pub fn load_or_get_default_no_cache<T: AsRef<Path>>( path: Option<T>, ) -> Result<Self, GetCleanerError>

If path is Some, returns the result of Self::load_from_file.

If path is None, returns the result of Self::get_default_no_cache.

Errors

If the call to Self::load_from_file returns an error, that error is returned.

If the call to Self::get_default_no_cache returns an error, that error is returned.

Examples

use url_cleaner_engine::types::*;

assert_eq!(
    Cleaner::get_default_no_cache().unwrap(),
    Cleaner::load_or_get_default_no_cache(None::<&str>).unwrap()
);

assert_eq!(
    Cleaner::get_default_no_cache().unwrap(),
    Cleaner::load_or_get_default_no_cache(Some("default-cleaner.json")).unwrap()
);

pub fn apply( &self, task_state: &mut TaskState<'_>, ) -> Result<(), ApplyCleanerError>

Applies each Action in Self::actions in order to the provided TaskState.

If an error is returned, task_state may be left in a partially modified state.

Errors

If any call to Action::apply returns an error, that error is returned.

pub fn run_tests(&self, tests: Tests)

Runs the provided Tests, panicking if any of them fail.

Panics

If any Test fails, panics.

pub fn assert_suitability(&self)

Asserts the suitability of self to be URL Cleaner’s default config.

Exact behavior is unspecified and changes are not considered breaking.

Panics

If self is deemed unsuitable to be URL Cleaner’s default config, panics.

Examples

use url_cleaner_engine::types::*;

Cleaner::get_default().unwrap().assert_suitability();

impl<'a> Cleaner<'a>

pub fn with_profiles(self, profiles: ProfilesConfig) -> ProfiledCleaner<'a>

Convert the Cleaner into a ProfiledCleaner using the specified ProfilesConfig.

Trait Implementations

impl<'a> Clone for Cleaner<'a>

fn clone(&self) -> Cleaner<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for Cleaner<'a>

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

Formats the value using the given formatter.

impl<'a> Default for Cleaner<'a>

fn default() -> Cleaner<'a>

Returns the “default value” for a type.

impl<'de, 'a> Deserialize<'de> for Cleaner<'a>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<'a> PartialEq for Cleaner<'a>

fn eq(&self, other: &Cleaner<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Serialize for Cleaner<'a>

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> Eq for Cleaner<'a>

impl<'a> StructuralPartialEq for Cleaner<'a>