https://github.com/dpb587/go-importshttp

Utilities for hosting Go packages on custom/vanity domains.
https://github.com/dpb587/go-importshttp

golang imports modules packages vanity

Last synced: about 1 month ago
JSON representation

Utilities for hosting Go packages on custom/vanity domains.

• Host: GitHub
• URL: https://github.com/dpb587/go-importshttp
• Owner: dpb587
• License: mit
• Created: 2021-08-30T01:45:59.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-09-04T12:27:48.000Z (over 3 years ago)
• Last Synced: 2024-06-20T03:56:32.633Z (6 months ago)
• Topics: golang, imports, modules, packages, vanity
• Language: Go
• Homepage: https://go.dpb.io/importshttp
• Size: 313 KB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome - dpb587/go-importshttp - Utilities for hosting Go packages on custom/vanity domains. (Go)
• awesome - dpb587/go-importshttp - Utilities for hosting Go packages on custom/vanity domains. (Go)

README

        
# go.dpb.io/importshttp

Utilities for hosting Go packages on custom/vanity domains.

 * automatic `go-import` and `go-source` parameters used by Go tooling

 * theming with professional listing and package views by default

 * configurable action links for packages (e.g. `pkg.go.dev`, repository source, custom URLs)

 * used as a server, static site generator, or generic `http.Handler`

 * YAML-based or programmatic configuration

## Usage

For a live example, visit [go.dpb.io](https://go.dpb.io) ([source](https://github.com/dpb587/go.dpb.io); automated via [Cloud Build](https://cloud.google.com/build) and deployed to [Cloud Run](https://cloud.google.com/run)).

To run a server locally, use the [`cmd/server` package](cmd/server)...

```bash

go run go.dpb.io/importshttp/cmd/server \

  -pkg=go.example.com/firstpackage=github.com/golang/go/tree/master \

  -pkg=go.example.com/secondpackage=bitbucket.org/example/secondpackage/src/master

```

To publish a static site with GitHub Pages + Actions, use the [`dpb587/go-importshttp-for-github` template](https://github.com/dpb587/go-importshttp-for-github).

Learn more from the [`examples` directory](examples) and [code documentation](https://pkg.go.dev/go.dpb.io/importshttp).

## License

[MIT License](LICENSE)