- Remove trackers
- Remove referrers
- Identify malicious intent
- Verify URL validity
- Improve URL load speeds
Having imported neutralise-link you may use the neutralise function which takes a URL string as the argument.
The function is designed to return either a string URL or None. It is recommended to use the returned URL value in place of the original URL as this is the neutralised version of the URL.
By default, the function will return None in two cases:
- The link is invalid
- The link is deemed malicious
You may override the 2nd case by calling the function with the optional parameter,
safe=false.
You may also skip the validity check by calling the function with the optional parameter,
check_valid=false. This is recommended if you do not need to check for URL validity as it leads to significantly faster performance, but at the potential risk of returning impure URLs (i.e. URLs that have been redirected).
from neutralise_link import neutralise
def main(url: str) -> str:
"""Validate user URL input for storing."""
url = neutralise(url=url, safe=True, check_valid=True)
if not url:
print("URL is malformed or malicious.")
print("URL is safe and in its pure form.")- Have python 3.10 installed on system (e.g. using anaconda/homebrew)
- Set up a virtual environment using
python -m venv venv - Activate the virtual environment using
source venv/bin/activate - Install development dependencies using
pip install -r requirements.txt
It is important to ensure that ALL tests pass before submitting a PR.
python -m unittest discover -s testsIt is also imperative that coverage is above 90% before submitting a PR. Validate this by running:
coverage run -m tests.test_neutralise && coverage report && coverage html-
Navigate to root directory of the project and run:
python -m build -
Install the package found in
neutralise-link/dist/in your repo usingpip installfollowed by the relative path of the.tar.gzpackage file located in the project. For example:
pip install dist/neutralise_link-0.1.0.tar.gzEnsure that the package is built and the dist directory is populated. Then run:
python -m twine upload dist/*