README.md — sigil-forgejo

1# sigil-forgejo

3A [Sigil](https://codeberg.org/sigil/sigil) library for the Forgejo/Codeberg REST API.

5## Modules

7| Module | Description |

8|--------|-------------|

9| `(forgejo client)` | Shared auth headers, URL construction, HTTP helpers |

10| `(forgejo repos)` | Get, list, create, delete repositories |

11| `(forgejo orgs)` | Organization info and repo listing |

12| `(forgejo topics)` | List, add, replace repository topics |

13| `(forgejo issues)` | List, create, get, comment on issues |

14| `(forgejo pulls)` | List, get, create, merge pull requests |

15| `(forgejo releases)` | List, create releases and upload assets |

17## Usage

19Add `sigil-forgejo` as a dependency in your `package.sgl`:

21```scheme

22(from-git url: "codeberg:sigil/sigil-forgejo" package: "sigil-forgejo")

23```

25Then import the modules you need:

27```scheme

28(import (forgejo repos)

29 (forgejo topics))

31(define base-url "https://codeberg.org")

32(define token (getenv "FORGEJO_TOKEN"))

34;; List repos in an org

35(forgejo-list-org-repos base-url token "sigil")

37;; Set topics on a repo

38(forgejo-replace-topics base-url token "sigil" "my-repo"

39 '("library" "sigil"))

40```

42## Building

44```bash

45sigil deps install

46sigil build

47```

49## License

51BSD-3-Clause