module documentation

This code attempts to make it easier to deal with human variation in references to laws.

This is code that doesn't have a specific spec to adhere to, will never be perfect, and is relatively creative in ways that you don't have complete control over.

It has nonetheless seen repeated use.

It is included to make some things easier, and to steal fragments of code for if you want to refine its functionality.

Function resolve_deeplink_bwbid CVDR has links to laws that look like:
Variable _deeplink_resolved_bwbs Undocumented
Variable _deeplink_resolved_redirections Undocumented
def resolve_deeplink_bwbid(url, use_cache=True):

CVDR has links to laws that look like:

    http://wetten.overheid.nl/cgi-bin/deeplink/law1/title=Burgerlijk%20Wetboek%20Boek%201
    http://wetten.overheid.nl/cgi-bin/deeplink/law1/bwbid=BWBR0005537/article=1:2

that go to:

    https://wetten.overheid.nl/BWBR0002656/2024-01-01
    https://wetten.overheid.nl/BWBR0005537/2024-09-01/#Hoofdstuk1_Titeldeel1.1_Artikel1:2

While 'deeplink' may not be the best name for 'resolver', it's the term that is used. Note that the resolver it quieries live can be SLOW, so this function is equally slow to respond.

...the first time we see such a link, because we cache results on disk so that later reponses can be fast, but keep in mind that in theory, the resolver's answer may change over time.

_deeplink_resolved_bwbs =

Undocumented

_deeplink_resolved_redirections =

Undocumented