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] [--dry-run] [--version] [<org-name>/]<repo-basename>

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

       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.

       --dry-run
              if set, no repository will be created, only  tests  for  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>.