https://github.com/Debian/dh-make-golang

Automatically creates Debian packaging for Go packages
https://github.com/Debian/dh-make-golang

Last synced: 2 months ago
JSON representation

Automatically creates Debian packaging for Go packages

• Host: GitHub
• URL: https://github.com/Debian/dh-make-golang
• Owner: Debian
• License: bsd-3-clause
• Created: 2015-07-21T08:06:17.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-08-30T06:04:48.000Z (5 months ago)
• Last Synced: 2024-10-08T11:58:07.377Z (3 months ago)
• Language: Go
• Size: 354 KB
• Stars: 375
• Watchers: 37
• Forks: 76
• Open Issues: 35
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• go-awesome - dh-make-golang - Automatically builds Debian packages (Open source library / Build And Compile)

README

        
![CI Test](https://github.com/anthonyfok/dh-make-golang/actions/workflows/ci-test.yml/badge.svg)

dh-make-golang is a tool to automatically create Debian packaging for Go

packages. Its goal is to automate away as much of the work as possible when

creating a Debian package for a Go library package or Go program.

## Overview

All you need to specify is a Go package name. In your current working

directory, a new directory will be created containing a git repository. Inside

that repository, you’ll find the Go package’s source code plus the necessary

Debian packaging files to build a Debian package. The packaging adheres to the

[pkg-go packaging guidelines](https://go-team.pages.debian.net/packaging.html)

and hence can be placed alongside the other [team-maintained packages in

pkg-go](https://salsa.debian.org/go-team/packages), hosted on Debian’s

[salsa](https://wiki.debian.org/Salsa).

## Usage/example

For an introductory example, see [this annotated demonstration of how to use

dh-make-golang](https://people.debian.org/~stapelberg/2015/07/27/dh-make-golang.html).

## dh-make-golang’s usage of the internet

dh-make-golang makes heavy use of online resources to improve the resulting

package. In no particular order and depending on where your package is hosted,

dh-make-golang may query:

* By virtue of using `go get`, the specified Go package and all of its

  dependencies will be downloaded. This step can quickly cause dozens of

  megabytes to be transferred, so be careful if you are on a metered internet

  connection.

* The output of

  [filter-packages.sh](https://github.com/Debian/dh-make-golang/blob/master/filter-packages.sh),

  hosted on https://people.debian.org/~stapelberg/dh-make-golang/. This is used

  to figure out whether dependencies are already packaged in Debian, and

  whether you are about to duplicate somebody else’s work.

* GitHub’s API, to get the license, repository creator, description and README

  for Go packages hosted on GitHub.