Exposed attributes

• platform: platform codename

• host: server hostname

• resource: same as host

• port: URL port (only if explicitly defined in URL)

• protocol: URL protocol (git, ssh, http/https)

• protocols: list of protocols explicitly defined in URL

• user: repository user

• owner: repository owner (user or organization)

• repo: repository name

• name: same as repo

• groups: list of groups - gitlab only

• path: path to file or directory (includes the branch name) - gitlab / github only

• path_raw: raw path starting from the repo name (might include platform keyword) - gitlab / github only

• branch: branch name (when parseable) - gitlab / github only

• username: username from <username>:<access_token>@<url> gitlab / github urls

• access_token: access token from <username>:<access_token>@<url> gitlab / github urls

Parse

from giturlparse import parse

p = parse('git@bitbucket.org:AaronO/some-repo.git')

p.host, p.owner, p.repo

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

Rewrite

from giturlparse import parse

url = 'git@github.com:Org/Private-repo.git'

p = parse(url)

p.url2ssh, p.url2https, p.url2git, p.url2http
# => ('git@github.com: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 = 'git@github.com:Org/Private-repo.git'

parse(url).urls
# => {
#     'ssh': 'git@github.com: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 = 'git@github.com:Org/Private-repo.git'

parse(url).valid
# => True

# Or

validate(url)
# => True

Tests

python -munittest

License

Apache v2 (Check out LICENSE file)

0.16.0 (2026-10-13)

0.15.0 (2026-06-16)

0.14.0 (2025-10-22)

0.13.0 (2025-10-22)

0.12.0 (2023-09-24)

0.11.1 (2023-08-04)

0.11.0 (2023-08-03)

0.10.0 (2020-12-05)

0.9.2 (2018-10-27)

• Removed “s” from the base platform regex

• Fix license classifier in setup.py

• Update meta files

0.9.1 (2018-01-20)

• First fork release