autodiscovery package

import "code.pfad.fr/vanitydoc/autodiscovery"

package autodiscovery is an implementation of the VCS Autodiscovery RFC.

Index ¶

• type Forge
• type VCS
  • func Forgejo(url, defaultBranch string) VCS
  • func Github(url, defaultBranch string) VCS
  • func New(typ string, url, defaultBranch string) (VCS, error)
  • func SourceHutGit(url, defaultBranch string) VCS
  • func (vcs VCS) GoImport(wr io.Writer, importPrefix string) error
  • func (vcs VCS) MetaTags(wr io.Writer) error

type Forge ¶

type Forge struct {
	Summary string // overview of the project
	Dir     string
	File    string // file with pretty printing
	Line    string // file with specific line hightlighted
	RawFile string
}

Forge indicates the URLs patterrn available in the software forge (with {ref}, {path} and {line} as placeholders).

type VCS ¶

type VCS struct {
	// VCS Standard Tags
	Kind          string // git, fossil, pijul...
	DefaultBranch string
	Clone         []string // URLs for clones (unauthenticated first)
	Forge         Forge
}

VCS represents the Version Control System being used.

func Forgejo ¶

func Forgejo(url, defaultBranch string) VCS

Forgejo generates VCS for forgejo/gitea. For instance "https://codeberg.org/pfad.fr/vanitydoc" and defaultBranch "main".

func Github ¶

func Github(url, defaultBranch string) VCS

Github generates VCS for github. For instance "https://github.com/fluhus/godoc-tricks" and defaultBranch "main".

func New ¶

func New(typ string, url, defaultBranch string) (VCS, error)

NewFromString creates a VCS of the given type (gitsrht, forgejo, github).

func SourceHutGit ¶

func SourceHutGit(url, defaultBranch string) VCS

SourceHutGit generates VCS for git.sr.ht. For instance "https://git.sr.ht/~username/repo" and defaultBranch "main".

func (VCS) GoImport ¶

func (vcs VCS) GoImport(wr io.Writer, importPrefix string) error

GoImport writes the go-import meta tag.

func (VCS) MetaTags ¶

func (vcs VCS) MetaTags(wr io.Writer) error

MetaTags writes the VCS Autodiscovery RFC meta tags (which are not empty).

Source Files ¶

autodiscovery.go

Forge ¶

https://codeberg.org/pfad.fr/vanitydoc

https://codeberg.org/pfad.fr/vanitydoc.git
git@codeberg.org:pfad.fr/vanitydoc.git