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 deploy‐
       ments 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 (Ac‐
       count->Settings->Applications->Generate 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 Gitea instance to apply the configuration for.  This leads to a behav‐
       ior that is equivalent to calling datalad's ``siblings('configure', ...)``||``siblings  configure``  com‐
       mand  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

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

       --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 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-gitea 1.1.5                 2025-03-03                    datalad create-sibling-gitea(1)