Skip to content

Convert Ringlet software repositories to GOPROXY

[Home | sourcehut | crates.io]

Overview

The ringlet2go utility examines a Git repository that contains one or more Go modules, generates static files that correspond to the HTTP request paths defined in the GOPROXY protocol, and stores them into a tree synced to a remote webserver.

Limitations

The ringlet2go utility currently has the following limitations:

  • only works for a single module within a single repository
  • hardcodes a devel.ringlet.net prefix

Building ringlet2go

With a recent enough Rust build toolchain, cargo build --release should be enough to build a target/release/ringlet2go-cli executable file. You may then copy that file to a location of your choice and run it.

Using ringlet2go

List the configuration settings

In the directory containing the go.mod file:

ringlet2go-cli show config

From another directory:

ringlet2go-cli show config /path/to/module/directory

Simulate an update without uplodating the final result

ringlet2go-cli -v update --noop

Update a module's data in the GOPROXY tree and upload it

ringlet2go-cli update

Contact

The ringlet2go utility was written by Peter Pentchev. It is developed in a sourcehut repository. This documentation is hosted at Ringlet.