git-username

Get the username (or 'owner' name) from a git/GitHub remote origin URL.

Please consider following this project's author, Jon Schlinkert, and consider starring the project to show your :heart: and support.

Install

Install with npm:

1$ npm install --save git-username

Usage

If no arguments are passed, the .git/config in the current working directory is used.

1var username = require('git-username');
2console.log(username()); //=> jonschlinkert

Options

options.cwd

Type: string

Default: process.cwd()

Set the current working directory (cwd):

Examples

1username({ cwd: 'some/path' });
2
3// cwd may also be passed as the first argument
4username('some/path');

options.strict

Type: boolean

Default: undefined

Throw an error when a git config or git remote origin cannot be resolved. Otherwise, when strict is not true and a remote origin cannot be resolved, null is returned.

Example

1username({ strict: true });

Release history

v1.0

Breaking changes

• The second argument can no longer be a boolean (for warning when git remote origin is not found). Use options.strict instead.

About

1$ npm install && npm test

1$ npm install -g verbose/verb#dev verb-generate-readme && verb

Related projects

You might also be interested in these projects:

• git-branch: Get the current branch for a local git repository. | homepage
• git-user-name: Get a user's name from git config at the project or global scope, depending on… more | homepage
• parse-git-config: Parse .git/config into a JavaScript object. sync or async. | homepage
• remote-origin-url: Get the git remote origin URL from your local git repository. Remember! A remote origin… more | homepage

Contributors

Author

Jon Schlinkert

• LinkedIn Profile
• GitHub Profile
• Twitter Profile

License

Copyright © 2018, Jon Schlinkert. Released under the MIT License.

This file was generated by verb-generate-readme, v0.6.0, on March 02, 2018.