debsearch

README

debsearch

Tools and a library for finding Debian packages.

There is a debsearch Go package, plus debsearch a command line tool, and DebFind a GUI application.

Both debsearch and DebFind are run as an ordinary user and are very fast. They should prove useful to anyone who uses Debian or a Debian-derived Linux distribution such as Ubuntu.

Searching can be by Section, Tags, and words (found in the name and short and long descriptions), in any combination.

License

GPL-3

---

Documentation

Index

• Constants
• Variables
• func HumanSize(size int) string
• func NewDeb() *deb
• type FilePair
  • func NewFilePair(packages, i18n string) FilePair
  • func StdFilePairs(arc string) []FilePair
  • func StdFilePairsWithDescriptions(arc string) []FilePair
• type Model
  • func NewModel(filepairs ...FilePair) (Model, error)
• type Query
  • func NewQuery() *Query
  • func (me *Query) Clear()
  • func (me *Query) Match(deb *deb) bool
  • func (me *Query) SelectFrom(model *Model) []*deb
  • func (me *Query) String() string

Constants

const (
	DefaultArc = "amd64"

	Arcs = "alpha amd64 arm arm64 armel armhf avr32 hppa hurd-amd64 " +
		"hurd-i386 i386 ia64 kfreebsd-amd64 kfreebsd-i386 m32 m68k mips " +
		"mips64el mipsel netbsd-alpha netbsd-i386 or1k powerpc " +
		"powerpcspe ppc64el riscv64 s390 s390x sh4 sparc sparc64 x32"
)

Variables

var (
	Err101 = errors.New("E101: failed to open packages file")
	Err102 = errors.New("E102: no package files given")
)

var Version string

Functions

func HumanSize

func HumanSize(size int) string

func NewDeb

func NewDeb() *deb

Types

type FilePair

type FilePair struct {
	Packages string
	I18n     string
}

func NewFilePair

func NewFilePair(packages, i18n string) FilePair

func StdFilePairs

func StdFilePairs(arc string) []FilePair

func StdFilePairsWithDescriptions

func StdFilePairsWithDescriptions(arc string) []FilePair

type Model

type Model struct {
	Debs              map[string]*deb
	SectionsAndCounts map[string]int
	TagsAndCounts     map[string]int
}

func NewModel

func NewModel(filepairs ...FilePair) (Model, error)

type Query

type Query struct {
	Sections gset.Set[string] // sections are always or-ed
	Tags     gset.Set[string]
	TagsAnd  bool // if true all tags must match; else any
	Words    gset.Set[string]
	WordsAnd bool // if true all tags must match; else any
}

func NewQuery

func NewQuery() *Query

func (*Query) Clear

func (me *Query) Clear()

func (*Query) Match

func (me *Query) Match(deb *deb) bool

func (*Query) SelectFrom

func (me *Query) SelectFrom(model *Model) []*deb

func (*Query) String

func (me *Query) String() string