Package: cyrebro-domain-validator
Powered by CYREBROCYREBRO's Domain ValidatorDuring an internal development, we noticed that existing domain validation Python packages are not deeply
validating domains.Most of the time these packages only check the domain validity using regex, which mostly is not enough.That is why we at CYREBRO decided to create one that takes a deeper look into domains and provides a more reliable result.ValidationsCYREBRO's domain validator checks for:regex validity- deep regex, includes a list of known TLDs.HTTP(/s) availability.nslookup.whois.dkim records.spf records.InstallationThrough pipTo install the package, simply type:pip install cyrebro-domain-validatorThrough GitHubFirstly, clone the repository and extract the files.Export the files and navigate to the directory using the terminal/command line window.Lastly, once in an activated venv, enter the following command in the terminal/command line window:Windowspython .\setup.py installLinuxpython3 ./setup.py installDependenciesdnspythonbyrthalley.tldbybarseghyanartur.The dependencies will be installed automatically once installing the package.UsageInput Parametersdomain_name: str ->mandatory.dkim_selector: str ->optional.raw_data: bool ->optional.Using The PackageCYREBRO's Domain Validator allows you to receive the scan results in both boolean expression and dictionary formats.Importingfrom cyrebro_domain_validator import DomainValidator, validate_domainBasic UsageThe basic usage will provide you with a simpleTrueorFalseanswer, it allows for easy check within a condition.The function will returnTrueif the answer is positive foroneof the validity checks mentioned above.Example:if validate_domain(domain_name="github.com"):
    do_work()Advanced UsageIf a True or False answer does not match your needs, a dictionary is automatically generated upon run.The dictionary allows one to view the result of each validation separately, for more advanced usage in the code.To access the dictionary, simply provide True as the raw_data flag, a dictionary object will be returned.Example:domain_validation_details = validate_domain(domain_name="github.com", raw_data=True)
print(domain_validation_details, type(domain_validation_details))Output:{"regex": True,"http": True,"https": True,"nslookup": True,"whois": True,"dkim": True,"spf": True}<class 'dict'>The dictionary is available even if the domain is not valid.Note:the package requires internet connection to work properly.DKIM ClarificationIn order to retrieve the DKIM record of a domain, a specific query is used with a domain-specificselector.Due to the nature of this package, we are unable to know in advance the selectors that are used by each domain.We gathered some common DKIM selectors and the package tries querying with all of them.However, if you know the DKIM selector in advance (by extracting it from an email for example), the package accepts an arbitrary DKIM selector:domain_validator = DomainValidator("github.com", dkim_selector="some_selector")If a specific selector is passed, it will be firstly queried by the package.If for some reason, a result is unavailable, a fallback was implemented to try all common selectors.DevelopmentContributing is more than welcome and even encouraged by us.For any suggestions an email can be sent to:innovation@cyrebro.io.Pull requests are an option as well :blush: :hugs:.