Man page - datalad-create-sibling-gogs(1)

Packages contains this manual

Package:  datalad
apt-get install datalad

Manuals in package:
• datalad-download-url(1)
• datalad-no-annex(1)
• datalad-addurls(1)
• datalad-siblings(1)
• datalad-remove(1)
• datalad-drop(1)
• datalad-export-archive(1)
• datalad-export-archive-ora(1)
• datalad-create-sibling-gogs(1)
• datalad-push(1)
• datalad-create-sibling-gitea(1)
• datalad-copy-file(1)
• datalad-sshrun(1)
• datalad-subdatasets(1)
• datalad-check-dates(1)
• datalad-create-sibling-gitlab(1)
• datalad-clone(1)
• datalad-create-test-dataset(1)
• datalad-wtf(1)
• datalad-create-sibling-github(1)
• datalad-shell-completion(1)
• datalad-uninstall(1)
• datalad-create-sibling-gin(1)
• datalad-configuration(1)
• datalad-update(1)
• datalad-get(1)
• datalad(1)
• datalad-clean(1)
• datalad-create-sibling-ria(1)
• datalad-rerun(1)
• datalad-create(1)
• datalad-unlock(1)
• datalad-status(1)
• datalad-run(1)
• datalad-foreach-dataset(1)
• datalad-install(1)
• datalad-add-archive-content(1)
• datalad-create-sibling(1)
• datalad-run-procedure(1)
• datalad-save(1)
• datalad-diff(1)
• datalad-add-readme(1)
• datalad-export-to-figshare(1)
Documentations in package:
• datalad

Manual

datalad create-sibling-gogs

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHORS

---

NAME

datalad create-sibling-gogs - create a dataset sibling on a GOGS site

SYNOPSIS

datalad create-sibling-gogs [-h] [--api URL] [--dataset DATASET] [-r] [-R LEVELS] [-s NAME] [--existing {skip|error|reconfigure|replace}] [--credential NAME] [--access-protocol {https|ssh|https-ssh}] [--publish-depends SIBLINGNAME] [--private] [--description DESCRIPTION] [--dry-run] [--version] [<org-name>/]<repo-(base)name>

DESCRIPTION

GOGS is a self-hosted, free and open source code hosting solution with low resource demands that enable running it on inexpensive devices like a Raspberry Pi, or even directly on a NAS device.

In order to be able to use this command, a personal access token has to be generated on the platform (Account->Your Settings->Applications->Generate New Token).

This command can be configured with "datalad.create-sibling-ghlike.extra-remote-settings.NETLOC.KEY=VALUE" in order to add any local KEY = VALUE configuration to the created sibling in the local ‘.git/config‘ file. NETLOC is the domain of the Gogs instance to apply the configuration for. This leads to a behavior that is equivalent to calling datalad’s ‘‘siblings(’configure’, ...)‘‘||‘‘siblings configure‘‘ command with the respective KEY-VALUE pair after creating the sibling. The configuration, like any other, could be set at user- or system level, so users do not need to add this configuration to every sibling created with the service at NETLOC themselves.

New in version 0.16

OPTIONS

[<org-name>/]<repo-(base)name>

repository name, optionally including an ’<organization>/’ prefix if the repository shall not reside under a user’s namespace. When operating recursively, a suffix will be appended to this name for each subdataset. Constraints: value must be a string

-h , --help , --help-np

show this help message. --help-np forcefully disables the use of a pager for displaying the help message

--api URL

URL of the GOGS instance without a ’api/<version>’ suffix. Constraints: value must be a string or value must be NONE

--dataset DATASET , -d DATASET

dataset to create the publication target for. If not 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) or value must be NONE

-r , --recursive

if set, recurse into potential subdatasets.

-R LEVELS, --recursion-limit LEVELS

limit recursion into subdatasets to the given number of levels. Constraints: value must be convertible to type ’int’ or value must be NONE

-s NAME, --name NAME

name of the sibling in the local dataset installation (remote name). Constraints: value must be a string or value must be NONE

--existing {skip|error|reconfigure|replace}

behavior when already existing or configured siblings are discovered: skip the dataset (’skip’), update the configuration (’reconfigure’), or fail (’error’). DEPRECATED DANGER ZONE: With ’replace’, an existing repository will be irreversibly removed, re-initialized, and the sibling (re-)configured (thus implies ’reconfigure’). REPLACE could lead to data loss! In interactive sessions a confirmation prompt is shown, an exception is raised in non-interactive sessions. The ’replace’ mode will be removed in a future release. Constraints: value must be one of (’skip’, ’error’, ’reconfigure’, ’replace’) [Default: ’error’]

--credential NAME

name of the credential providing a personal access token to be used for authorization. The token can be supplied via configuration setting ’datalad.credential.<name>.token’, or environment variable DATALAD_CREDENTIAL_<NAME>_TOKEN, or will be queried from the active credential store using the provided name. If none is provided, the host-part of the API URL is used as a name (e.g. ’https://api.github.com’ -> ’api.github.com’). Constraints: value must be a string or value must be NONE

--access-protocol {https|ssh|https-ssh}

access protocol/URL to configure for the sibling. With ’https-ssh’ SSH will be used for write access, whereas HTTPS is used for read access. Constraints: value must be one of (’https’, ’ssh’, ’https-ssh’) [Default: ’https’]

--publish-depends 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 or value must be NONE

--private

if set, create a private repository.

--description DESCRIPTION

Brief description, displayed on the project’s page. Constraints: value must be a string or value must be NONE

--dry-run

if set, no repository will be created, only tests for sibling name collisions will be performed, and would-be repository names are reported for all relevant datasets.

--version

show the module and its version which provides the command

AUTHORS

datalad is developed by The DataLad Team and Contributors <team@datalad.org>.

---