mirror of
1
Fork 0
Beyond coding. We forge.
Go to file
Jade Lovelace 900381d6e9 Add an immutable tarball link to archive download headers for Nix
This allows `nix flake metadata` and nix in general to lock a *branch*
tarball link in a manner that causes it to fetch the correct commit even
if the branch is updated with a newer version.

For further context, Nix flakes are a feature that, among other things,
allows for "inputs" that are "github:someuser/somerepo",
"https://some-tarball-service/some-tarball.tar.gz",
"sourcehut:~meow/nya" or similar. This feature allows our users to fetch
tarballs of git-based inputs to their builds rather than using git to
fetch them, saving significant download time.

There is presently no gitea or forgejo specific fetcher in Nix, and we
don't particularly wish to have one. Ideally (as a developer on a Nix
implementation myself) we could just use the generic tarball fetcher and
not add specific forgejo support, but to do so, we need additional
metadata to know which commit a given *branch* tarball represents, which
is the purpose of the Link header added here.

The result of this patch is that a Nix user can specify `inputs.something.url =
"https://forgejo-host/some/project/archive/main.tar.gz"` in flake.nix
and get a link to some concrete tarball for the actual commit in the
lock file, then when they run `nix flake update` in the future, they
will get the latest commit in that branch.

Example of it working locally:

 » nix flake metadata --refresh 'http://localhost:3000/api/v1/repos/jade/cats/archive/main.tar.gz?dir=configs/nix'
Resolved URL:  http://localhost:3000/api/v1/repos/jade/cats/archive/main.tar.gz?dir=configs/nix
Locked URL:    804ede182b.tar.gz?dir=configs
/nix&narHash=sha256-yP7KkDVfuixZzs0fsqhSETXFC0y8m6nmPLw2GrAMxKQ%3D
Description:   Computers with the nixos
Path:          /nix/store/s856c6yqghyan4v0zy6jj19ksv0q22nx-source
Revision:      804ede182b6b66469b23ea4d21eece52766b7a06
Last modified: 2024-05-02 00:48:32

For details on the header value, see:
56763ff918/doc/manual/src/protocols/tarball-fetcher.md

(cherry picked from commit 6631f56ebf)
2024-05-29 18:50:14 +00:00
.devcontainer Switch to the maintained vitest extension (#29914) 2024-03-26 19:04:25 +01:00
.forgejo fix(release): add missing ARG RELEASE_VERSION 2024-04-17 16:06:43 +00:00
.gitea pull_request_template: test/needed label 2024-03-22 10:11:47 +01:00
assets Replace reply with a forked version to fix the cut-off of the incoming mail text (#3747) 2024-05-13 23:51:40 +02:00
build s/Gitea/Forgejo in various log messages and comments 2024-04-22 14:41:17 +00:00
cmd fix(cli): add missing quote in storage help 2024-05-25 07:50:18 +00:00
contrib Merge branch 'rebase-forgejo-dependency' into wip-forgejo 2024-02-05 18:58:23 +01:00
custom/conf Fixup app.example.ini for task section, which is now queue.task (#30555) 2024-04-21 18:14:45 +02:00
docker [BRANDING] cosmetic s/Gitea/Forgejo/ in logs, messages, etc. 2024-02-05 16:02:14 +01:00
models test: check hook_task deletion 2024-05-24 12:46:33 +00:00
modules fix(services): set SendNotificationEmailOnNewUser 2024-05-25 17:32:52 +02:00
options [v7.0/forgejo] [I18N] Fixes and improvements to English locale (#3914) 2024-05-26 11:39:48 +00:00
public [FEAT] sourcehut webhooks 2024-04-05 19:36:04 +00:00
release-notes/8.0.0 Add an immutable tarball link to archive download headers for Nix 2024-05-29 18:50:14 +00:00
releases/images [DOCS] RELEASE-NOTES.md 2024-02-05 14:44:32 +01:00
routers Add an immutable tarball link to archive download headers for Nix 2024-05-29 18:50:14 +00:00
services migrations: Map non-existant external users to Ghost 2024-05-28 16:44:23 +00:00
templates Merge pull request '[gitea] week 2024-21-v7.0 cherry pick (release/v1.22 -> v7.0/forgejo)' (#3859) from earl-warren/wcp/2024-21-v7.0 into v7.0/forgejo 2024-05-24 19:59:51 +00:00
tests Add an immutable tarball link to archive download headers for Nix 2024-05-29 18:50:14 +00:00
tools Add svg linter and fix incorrect svgs (#30086) 2024-03-30 07:17:30 +01:00
web_src [PORT] gitea#30342: Fix label-list rendering in timeline, decrease gap 2024-05-24 01:45:38 +02:00
.air.toml Exclude `routers/private/tests` from air (#29949) 2024-03-26 19:04:26 +01:00
.changelog.yml Adapt `.changelog.yml` to new labeling system (#27701) 2023-10-20 00:22:00 +02:00
.deadcode-out [DEADCODE] update 2024-05-14 16:47:37 +02:00
.dockerignore Adjust VS Code debug filename match in .gitignore (#30158) 2024-03-30 07:17:32 +01:00
.editorconfig [v7.0/forgejo] Improve translatability of "Transfer ownership" (#3750) 2024-05-14 12:14:36 +00:00
.eslintrc.yaml Forbid jQuery `.attr` (#30116) 2024-03-30 07:17:31 +01:00
.gitattributes [META] Use correct language for .tmpl 2024-02-05 14:44:33 +01:00
.gitignore move some scripts from 'build' to 'tools' directory, misc refactors (#29844) 2024-03-26 19:04:25 +01:00
.gitmodules cleanup(tests): remove manual testing submodule 2024-04-21 08:46:56 +00:00
.gitpod.yml Switch to the maintained vitest extension (#29914) 2024-03-26 19:04:25 +01:00
.golangci.yml [GITEA] depguard sha256-simd 2024-02-05 16:54:44 +01:00
.ignore Add `/public/assets` to `.ignore` (#26232) 2023-07-30 12:34:20 +02:00
.markdownlint.yaml Update JS dependencies (#28537) 2023-12-30 05:29:03 +00:00
.npmrc Upgrade to npm lockfile v3 and explicitely set it (#23561) 2023-03-18 19:38:10 +01:00
.spectral.yaml Add spectral linter for Swagger (#20321) 2022-07-11 18:07:16 -05:00
.stylelintrc.yaml Enable a few stylelint rules (#30038) 2024-03-26 19:04:28 +01:00
.yamllint.yaml fully replace drone with actions (#27556) 2023-10-11 06:39:32 +00:00
BSDmakefile Fix build errors on BSD (in BSDMakefile) (#27594) 2023-10-13 15:38:27 +00:00
CODEOWNERS [META] Add CODEOWNERS files 2024-02-05 14:44:33 +01:00
CONTRIBUTING.md docs: contributing: avoid information duplication (#3454) 2024-04-25 19:13:36 +00:00
DCO Remove address from DCO (#22595) 2023-01-24 18:52:38 +00:00
Dockerfile fix(release): add missing ARG RELEASE_VERSION 2024-04-17 16:06:43 +00:00
Dockerfile.rootless feat(release): add OCI labels to container images 2024-04-17 05:48:38 +00:00
LICENSE [DOCS] LICENSE: add Forgejo Authors 2024-02-05 14:44:32 +01:00
MAINTAINERS Apply to become a maintainer (#27522) 2023-10-08 10:36:40 -04:00
Makefile fix: Forgejo 7.0 is compatible with Gitea v1.21.11 2024-05-21 15:01:37 +02:00
README.md [BRANDING] add Forgejo logo 2024-02-05 16:02:13 +01:00
RELEASE-NOTES.md [v7.0/forgejo] docs(release-notes): 7.0.3 (#3884) 2024-05-24 12:40:26 +00:00
build.go User/Org Feed render description as per web (#23887) 2023-04-04 04:39:47 +01:00
go.mod Replace reply with a forked version to fix the cut-off of the incoming mail text (#3747) 2024-05-13 23:51:40 +02:00
go.sum Replace reply with a forked version to fix the cut-off of the incoming mail text (#3747) 2024-05-13 23:51:40 +02:00
main.go [RELEASE] decouple the release name from the version number 2024-02-17 15:27:35 +01:00
package-lock.json Update dependency mermaid to v10.9.1 2024-05-16 18:12:23 +02:00
package.json Update dependency mermaid to v10.9.1 2024-05-16 18:12:23 +02:00
playwright.config.js Enforce trailing comma in JS on multiline (#30002) 2024-03-26 19:04:27 +01:00
poetry.lock Upgrade `tqdm` dependency (#30996) 2024-05-24 15:15:07 +02:00
poetry.toml Clean up pyproject.toml and package.json, fix poetry options (#25327) 2023-06-18 18:13:08 +00:00
pyproject.toml Update js and py dependencies, bump python (#29561) 2024-03-06 12:10:46 +08:00
renovate.json Reduce concurrent Renovate PR's 2024-03-26 09:40:48 +01:00
tailwind.config.js Migrate font-family to tailwind (#30118) 2024-03-30 07:17:32 +01:00
updates.config.js Configure pinned JS dependencies via updates.config.js (#29696) 2024-03-20 08:46:28 +01:00
vitest.config.js Switch to happy-dom for testing (#29948) 2024-03-26 19:04:26 +01:00
webpack.config.js Update JS any PY dependencies, remove workarounds (#30085) 2024-03-30 07:17:30 +01:00

README.md

Welcome to Forgejo

Hi there! Tired of big platforms playing monopoly? Providing Git hosting for your project, friends, company or community? Forgejo (/for'd͡ʒe.jo/ inspired by forĝejo the Esperanto word for forge) has you covered with its intuitive interface, light and easy hosting and a lot of builtin functionality.

Forgejo was created in 2022 because we think that the project should be owned by an independent community. If you second that, then Forgejo is for you! Our promise: Independent Free/Libre Software forever!

What does Forgejo offer?

If you like any of the following, Forgejo is literally meant for you:

  • Lightweight: Forgejo can easily be hosted on nearly every machine. Running on a Raspberry? Small cloud instance? No problem!
  • Project management: Besides Git hosting, Forgejo offers issues, pull requests, wikis, kanban boards and much more to coordinate with your team.
  • Publishing: Have something to share? Use releases to host your software for download, or use the package registry to publish it for docker, npm and many other package managers.
  • Customizable: Want to change your look? Change some settings? There are many config switches to make Forgejo work exactly like you want.
  • Powerful: Organizations & team permissions, CI integration, Code Search, LDAP, OAuth and much more. If you have advanced needs, Forgejo has you covered.
  • Privacy: From update checker to default settings: Forgejo is built to be privacy first for you and your crew.
  • Federation: (WIP) We are actively working to connect software forges with each other through ActivityPub, and create a collaborative network of personal instances.

Learn more

Dive into the documentation, subscribe to releases and blog post on our website, find us on the Fediverse or hop into our Matrix room if you have any questions or want to get involved.

Get involved

If you are interested in making Forgejo better, either by reporting a bug or by changing the governance, please take a look at the contribution guide.