Struct twistrs::permutate::Domain

pub struct Domain {
    pub fqdn: String,
    pub tld: String,
    pub domain: String,
}

Wrapper around an FQDN to perform permutations against.

Fields

fqdn: String

The domain FQDN to generate permutations from.

tld: String

The top-level domain of the FQDN (e.g. .com).

domain: String

The remainder of the domain (e.g. google).

Implementations

impl Domain

pub fn new(fqdn: &str) -> Result<Domain, Error>

Wrap a desired FQDN into a Domain container. Internally will perform additional operations to break the domain into one or more chunks to be used during domain permutations.

pub fn all(&self) -> Result<impl Iterator<Item = Permutation> + '_, Error>

Generate any and all possible domain permutations for a given Domain.

Returns Iterator<String> with an iterator of domain permutations and includes the results of all other individual permutation methods.

Any future permutations will also be included into this function call without any changes required from any client implementations.

pub fn addition(&self) -> impl Iterator<Item = Permutation> + '_

Add every ASCII lowercase character between the Domain (e.g. google) and top-level domain (e.g. .com).

pub fn bitsquatting(&self) -> impl Iterator<Item = Permutation> + '_

Following implementation takes inspiration from the following content:

• <https://github.com/artemdinaburg/bitsquat-script/blob/master/bitsquat.py>
• <http://dinaburg.org/bitsquatting.html>

Go through each char in the domain and XOR it against 8 separate masks:

00000001 ^ chr 00000010 ^ chr 00000100 ^ chr 00001000 ^ chr 00010000 ^ chr 00100000 ^ chr 01000000 ^ chr 10000000 ^ chr

Then check if the resulting bit operation falls within ASCII range.

pub fn homoglyph(&self) -> Result<impl Iterator<Item = Permutation> + '_, Error>

Permutation method that replaces ASCII characters with multiple homoglyphs similar to the respective ASCII character.

pub fn hyphentation(&self) -> impl Iterator<Item = Permutation> + '_

Permutation method that inserts hyphens (i.e. -) between each character in the domain where valid.

pub fn insertion(&self) -> impl Iterator<Item = Permutation> + '_

Permutation method that inserts specific characters that are close to any character in the domain depending on the keyboard (e.g. Q next to W in qwerty keyboard layout.

pub fn omission(&self) -> impl Iterator<Item = Permutation> + '_

Permutation method that selectively removes a character from the domain.

pub fn repetition(&self) -> impl Iterator<Item = Permutation> + '_

Permutation method that repeats characters twice provided they are alphabetic characters (e.g. google.com -> gooogle.com).

pub fn replacement(&self) -> impl Iterator<Item = Permutation> + '_

Permutation method similar to insertion, except that it replaces a given character with another character in proximity depending on keyboard layout.

pub fn subdomain(&self) -> impl Iterator<Item = Permutation> + '_

pub fn transposition(&self) -> impl Iterator<Item = Permutation> + '_

Permutation method that swaps out characters in the domain (e.g. google.com -> goolge.com).

pub fn vowel_swap(&self) -> impl Iterator<Item = Permutation> + '_

Permutation method that swaps vowels for other vowels (e.g. google.com -> gougle.com).

pub fn keyword(&self) -> impl Iterator<Item = Permutation> + '_

Permutation mode that appends and prepends common keywords to the domain in the following order:

1. Prepend keyword and dash (e.g. foo.com -> word-foo.com)
2. Prepend keyword (e.g. foo.com -> wordfoo.com)
3. Append keyword and dash (e.g. foo.com -> foo-word.com)
4. Append keyword and dash (e.g. foo.com -> fooword.com)

pub fn tld(&self) -> impl Iterator<Item = Permutation> + '_

Permutation method that replaces all TLDs as variations of the root domain passed.

Trait Implementations

impl Clone for Domain

fn clone(&self) -> Domain

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Domain

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

Formats the value using the given formatter.

impl Default for Domain

fn default() -> Domain

Returns the “default value” for a type.

impl Hash for Domain

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Domain

fn eq(&self, other: &Domain) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Serialize for Domain

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

Serialize this value into the given Serde serializer.

impl Eq for Domain

impl StructuralEq for Domain

impl StructuralPartialEq for Domain