slarosa / giturlparse.py

Parse & rewrite git urls (supports GitHub, Bitbucket, Assembla ...)

giturlparse.py

Parse & rewrite git urls (supports GitHub, Bitbucket, FriendCode, Assembla ...)

Installing

pip install giturlparse.py

Examples

Parse

from giturlparse import parse

p = parse('[email protected]:AaronO/some-repo.git')

p.host, p.owner, p.repo

# => ('bitbucket.org', 'AaronO', 'some-repo')

Rewrite

from giturlparse import parse

url = '[email protected]:Org/Private-repo.git'

p = parse(url)

p.url2ssh, p.url2https, p.url2git, p.url2http
# => ('[email protected]:Org/Private-repo.git', 'https://github.com/Org/Private-repo.git', 'git://github.com/Org/Private-repo.git', None)

URLS

Alternative URLs for same repo

from giturlparse import parse

url = '[email protected]:Org/Private-repo.git'

parse(url).urls
# => {
#     'ssh': '[email protected]:Org/Private-repo.git',
#     'https': 'https://github.com/Org/Private-repo.git',
#     'git': 'git://github.com/Org/Private-repo.git'
# }

Validate

from giturlparse import parse, validate

url = '[email protected]:Org/Private-repo.git'

parse(url).valid
# => True

# Or

validate(url)
# => True

Tests

python -m giturlparse.tests

License

Apache v2 (Check out LICENSE file)