Zy Filemanager

📁 File Browser

Name	Size	Permissions	Actions
📄 .npmignore (14 bytes)	14 B	0644	✍️ ⬇️ 🗑️
📄 .travis.yml (115 bytes)	115 B	0644	✍️ ⬇️ 🗑️
📄 CHANGELOG.md (212 bytes)	212 B	0644	✍️ ⬇️ 🗑️
📄 LICENSE (741 bytes)	741 B	0644	✍️ ⬇️ 🗑️
📄 README.md (1,371 bytes)	1.34 KB	0644	✍️ ⬇️ 🗑️
📝 normalize-git-url.js (1,175 bytes)	1.15 KB	0644	✍️ ⬇️ 🗑️
📄 package.json (2,248 bytes)	2.2 KB	0644	✍️ ⬇️ 🗑️

📤 Upload Files

Single File

Multiple Files

ZIP Extract

ZIP file will be deleted after extraction

➕ Create New

New Folder

New File

✍️ Editing: README.md

            File: /opt/alt/alt-nodejs6/root/usr/lib/node_modules/npm/node_modules.bundled/normalize-git-url/README.md

            Size: 1.34 KB | 
            Last Modified: 2021-09-28 16:36:12        

# normalize-git-url

You have a bunch of Git URLs. You want to convert them to a canonical
representation, probably for use inside npm so that it doesn't end up creating
a bunch of superfluous cached origins. You use this package.

## Usage

```javascript
var ngu = require('normalize-git-url');
var normalized = ngu("git+ssh://git@github.com:organization/repo.git#hashbrowns")
// get back:
// {
//   url : "ssh://git@github.com/organization/repo.git",
//   branch : "hashbrowns" // did u know hashbrowns are delicious?
// }
```

## API

There's just the one function, and all it takes is a single parameter, a non-normalized Git URL.

### normalizeGitUrl(url)

* `url` {String} The Git URL (very loosely speaking) to be normalized.

Returns an object with the following format:

* `url` {String} The normalized URL.
* `branch` {String} The treeish to be checked out once the repo at `url` is
  cloned. It doesn't have to be a branch, but it's a lot easier to intuit what
  the output is for with that name.

## Limitations

Right now this doesn't try to special-case GitHub too much -- it doesn't ensure
that `.git` is added to the end of URLs, it doesn't prefer `https:` over
`http:` or `ssh:`, it doesn't deal with redirects, and it doesn't try to
resolve symbolic names to treeish hashcodes. For now, it just tries to account
for minor differences in representation.

↩️ Back