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 (Ac‐
       count->Your Settings->Applications->Generate New Token).

       This  command can be configured with "datalad.create-sibling-ghlike.extra-remote-settings.NETLOC.KEY=VAL‐
       UE" 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 re‐
              side 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 con‐
              vertible 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  're‐
              place',  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 ses‐
              sions a confirmation prompt is shown, an exception is raised in non-interactive sessions. The 're‐
              place' mode will be removed in a future release. Constraints: value must be one of  ('skip',  'er‐
              ror', '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  vari‐
              able  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  ac‐
              cess,  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  sib‐
              ling.  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>.

datalad create-sibling-gogs 1.1.0                  2024-06-14                     datalad create-sibling-gogs(1)