Хостинги git. Ограничения на имена

Хостинги git. Ограничения на имена.

1 Общая информация

• Веб-интерфейсы Git-платформ часто накладывают ограничения на имена репозиториев и файлов.
• Это часто связано в том числе с необходимостью обеспечивать совместимость с разными операционными системами (см. Допустимые символы в имени файла).

2 Общие правила для имени репозитория

• На большинстве платформ имя репозитория должно состоять только из безопасных символов, которые гарантированно работают в URL и на разных файловых системах.
• Обычно это латинские буквы (a-z, A-Z), цифры (0-9), дефис ( - ), подчеркивание ( _ ), точка ( . ).

3 Ограничения по платформам

3.1 GitHub

3.1.1 Имена репозиториев

• Допускаются только буквы, цифры, дефисы ( - ), подчеркивания ( _ ), точки ( . ).
• Комбинации символов типа -- или .. обычно не запрещены явно, но их использование может быть нежелательным, так как ухудшает читаемость URL.

3.1.2 Имена файлов

• Ограничения связаны не столько с самим GitHub, сколько с файловой системой.
• GitHub позволит создать файл с именем test:file.txt, но если вы работаете в Windows, вы не сможете скачать (склонировать) такой репозиторий, так как двоеточие (:) запрещено в именах файлов Windows.
• То же самое касается имен CON, PRN, AUX и других зарезервированных имен устройств Windows.
• Скобки, например (103), автоматически заменяются на дефисы -103- при создании репозитория.

3.2 GitLab

3.2.1 Имена проектов (репозиториев)

• Могут содержать буквы, цифры, пробелы, эмодзи, подчеркивания ( _ ), точки ( . ), плюсы ( + ), дефисы ( - ), скобки ().

3.2.2 Слаг (путь к проекту)

• Из имени проекта автоматически генерируется слаг (slug) для URL.
• Слаг может содержать только латинские буквы, цифры, дефисы ( - ), подчеркивания ( _ ), точки ( . ).
• Он не может:
  • начинаться или заканчиваться дефисом, точкой или подчеркиванием;
  • содержать два специальных символа подряд (например, -- или ..);
  • заканчиваться на .git или .atom.

3.2.3 Имена файлов

• Ограничения продиктованы совместимостью с ОС.

3.3 Gitea

3.3.1 Имена репозиториев

• Аналогично GitHub — буквы, цифры, дефисы, подчеркивания, точки.

3.3.2 Имена секретов (переменных окружения)

• Имена секретов в Gitea могут содержать только буквы, цифры и подчеркивания ( _ ).
• Они не могут начинаться с цифры или префиксов GITHUB_ и GITEA_.

3.4 GitVerse

3.4.1 Имена репозиториев

• Нет явного списка запрещенных символов.
• Имена используются в URL (например, /repos/{owner}/{repo}), поэтому они должны быть URL-безопасными.
• Это исключает символы вроде =, &, ?, #, % и пробелы.
• Запрещены двойные символы ( -- ).
• То же и в релизах.