Metadata-Version: 2.1
Name: ural
Version: 0.0.3
Summary: A helper library full of URL-related heuristics.
Home-page: http://github.com/medialab/ural
Author: Guillaume Plique
Author-email: kropotkinepiotr@gmail.com
License: MIT
Keywords: url
Platform: UNKNOWN
Requires-Python: >=3
Description-Content-Type: text/markdown

[![Build Status](https://travis-ci.org/medialab/ural.svg)](https://travis-ci.org/medialab/ural)

# Ural

A helper library full of URL-related heuristics.

## Installation

You can install `ural` with pip with the following command:

```
pip install ural
```

## Usage

* [normalize_url](#normalize_url)

### normalize_url

Function normalizing the given url by stripping it of usually non-discriminant parts such as irrelevant query items or sub-domains etc.

This is a very useful utility when attempting to match similar urls written slightly differently when shared on social media etc.

```python
from ural import normalize_url

url('https://www2.lemonde.fr/index.php#anchor')
>>> 'lemonde.fr'
```

*Arguments*

* **url** *string*: URL to normalize.


todo: ensure protocol


