.TH "datalad create-sibling-github" "1" "2019\-02\-08" ""datalad create-sibling-github 0.11.2"" .SH NAME \fBdatalad create-sibling-github\fR \- create dataset sibling on Github. .SH SYNOPSIS .nh .HP \fBdatalad create\-sibling\-github\fR [-h] [--dataset\~DATASET] [-r] [--recursion-limit\~LEVELS] [-s\~NAME] [--existing\~MODE] [--github-login\~NAME] [--github-passwd\~PASSWORD] [--github-organization\~NAME] [--access-protocol\~ACCESS_PROTOCOL] [--publish-depends\~SIBLINGNAME] [--dryrun] REPONAME .hy .SH DESCRIPTION A repository can be created under a user's Github account, or any organization a user is a member of (given appropriate permissions). .PP Recursive sibling creation for subdatasets is supported. A dataset hierarchy is represented as a flat list of Github repositories. .PP Github cannot host dataset content. However, in combination with other data sources (and siblings), publishing a dataset to Github can facilitate distribution and exchange, while still allowing any dataset consumer to obtain actual data content from alternative sources. .PP For Github authentication user credentials can be given as arguments. Alternatively, they are obtained interactively or queried from the systems credential store. Lastly, an *oauth* token stored in the Git configuration under variable *hub.oauthtoken* will be used automatically. Such a token can be obtained, for example, using the commandline Github interface (https://github.com/sociomantic/git\-hub) by running: git hub setup. .SH OPTIONS .TP REPONAME Github repository name. When operating recursively, a suffix will be appended to this name for each subdataset. Constraints: value must be a string .TP \fB-h\fR, \fB--help\fR, \fB--help-np\fR show this help message. --help-np forcefully disables the use of a pager for displaying the help message .TP \fB--dataset\fR \fI\s-1DATASET\s0\fR, \fB-d\fR \fI\s-1DATASET\s0\fR specify the dataset to create the publication target for. If no dataset is given, an attempt is made to identify the dataset based on the current working directory. Constraints: Value must be a Dataset or a valid identifier of a Dataset (e.g. a path) [Default: None] .TP \fB-r\fR, \fB--recursive\fR if set, recurse into potential subdataset. [Default: False] .TP \fB--recursion-limit\fR LEVELS limit recursion into subdataset to the given number of levels. Constraints: value must be convertible to type 'int' [Default: None] .TP \fB-s\fR NAME, \fB--name\fR NAME name to represent the Github repository in the local dataset installation. Constraints: value must be a string [Default: 'github'] .TP \fB--existing\fR MODE desired behavior when already existing or configured siblings are discovered. 'skip': ignore; 'error': fail immediately; 'reconfigure': use the existing repository and reconfigure the local dataset to use it as a sibling. Constraints: value must be one of ('skip', 'error', 'reconfigure') [Default: 'error'] .TP \fB--github-login\fR NAME Github user name or access token. Constraints: value must be a string [Default: None] .TP \fB--github-passwd\fR PASSWORD Github user password. Constraints: value must be a string [Default: None] .TP \fB--github-organization\fR NAME If provided, the repository will be created under this Github organization. The respective Github user needs appropriate permissions. Constraints: value must be a string [Default: None] .TP \fB--access-protocol\fR \fI\s-1ACCESS_PROTOCOL\s0\fR Which access protocol/URL to configure for the sibling. Constraints: value must be one of ('https', 'ssh') [Default: 'https'] .TP \fB--publish-depends\fR SIBLINGNAME add a dependency such that the given existing sibling is always published prior to the new sibling. This equals setting a configuration item 'remote.SIBLINGNAME.datalad-publish-depends'. This option can be given more than once to configure multiple dependencies. Constraints: value must be a string [Default: None] .TP \fB--dryrun\fR If this flag is set, no communication with Github is performed, and no repositories will be created. Instead would-be repository names are reported for all relevant datasets. [Default: False] .SH AUTHORS datalad is developed by The DataLad Team and Contributors .