NAME

       datalad create-sibling-gitea - create a dataset sibling on a Gitea site

SYNOPSIS

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

DESCRIPTION

       Gitea  is  a  lightweight,  free  and  open source code hosting solution with low resource
       demands that enable running it on inexpensive devices like a Raspberry Pi.

       This command uses the main Gitea instance at https://gitea.com as the default target,  but
       other deployments can be used via the 'api' parameter.

       In  order  to  be able to use this command, a personal access token has to be generated on
       the platform (Account->Settings->Applications->Generate 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 Gitea 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

       --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 [Default: 'gitea']

       --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']

       --api URL
              URL of the Gitea instance without a 'api/<version>' suffix. Constraints: value must
              be a string or value must be NONE [Default: 'https://gitea.com']

       --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>.