v0.14.0a3 - URL Parsing

What's new

Parser: Experimental VCS URL parsing added (#376):

VCS Parsers return dataclasses.dataclass() instances. The new tools support validation, parsing, mutating and exporting into URLs consumable by the VCS.

Warning

APIs are unstable and subject to break until we get it right.

• libvcs.parse.git

  • GitURL - Parse git URLs
    • is_valid()
    • to_url() - export git clone-compatible URL

• libvcs.parse.hg

  • HgURL - Parse Mercurial URLs

    • is_valid()
    • to_url() - export hg clone-compatible URL

• libvcs.parse.svn

  • SvnURL - Parse Subversion URLs

    • is_valid()
    • to_url() - export svn checkout-compatible URL

Detection can be extended through writing Matchers and adding them to the classes’ MatcherRegistry

You can write your own VCS parser by implementing URLProtocol, but it would be most efficient if you studied the source of the git(1) parser to see how it’s done.

Autogenerated

• Parsing / detection and location by @tony in #376

Full Changelog: v0.14.0a2...v0.14.0a3