database

Documentation

Overview

Package database manages storage for GoPkgDoc.

Index

• type Database
  • func New() (*Database, error)
  • func (db *Database) AddBadCrawl(path string) error
  • func (db *Database) AddNewCrawl(importPath string) error
  • func (db *Database) AllPackages() ([]Package, error)
  • func (db *Database) Block(root string) error
  • func (db *Database) BumpCrawl(projectRoot string) error
  • func (db *Database) Delete(path string) error
  • func (db *Database) Do(f func(*PackageInfo) error) error
  • func (db *Database) Exists(path string) (bool, error)
  • func (db *Database) Get(path string) (*doc.Package, []Package, time.Time, error)
  • func (db *Database) GetDoc(path string) (*doc.Package, time.Time, error)
  • func (db *Database) GetGob(key string, value interface{}) error
  • func (db *Database) GoIndex() ([]Package, error)
  • func (db *Database) GoSubrepoIndex() ([]Package, error)
  • func (db *Database) ImportGraph(pdoc *doc.Package, level DepLevel) ([]Package, [][2]int, error)
  • func (db *Database) ImporterCount(path string) (int, error)
  • func (db *Database) Importers(path string) ([]Package, error)
  • func (db *Database) IncrementCounter(key string, delta float64) (float64, error)
  • func (db *Database) IncrementPopularScore(path string) error
  • func (db *Database) Index() ([]Package, error)
  • func (db *Database) IsBlocked(path string) (bool, error)
  • func (db *Database) Packages(paths []string) ([]Package, error)
  • func (db *Database) PopNewCrawl() (string, bool, error)
  • func (db *Database) Popular(count int) ([]Package, error)
  • func (db *Database) PopularWithScores() ([]Package, error)
  • func (db *Database) Project(projectRoot string) ([]Package, error)
  • func (db *Database) Put(pdoc *doc.Package, nextCrawl time.Time, hide bool) error
  • func (db *Database) PutGob(key string, value interface{}) error
  • func (db *Database) Query(q string) ([]Package, error)
  • func (db *Database) SetNextCrawlEtag(projectRoot string, etag string, t time.Time) error
• type DepLevel
• type Package
• type PackageInfo

Types

type Database

type Database struct {
	Pool interface {
		Get() redis.Conn
	}
}

func New

func New() (*Database, error)

New creates a database configured from command line flags.

func (*Database) AddBadCrawl

func (db *Database) AddBadCrawl(path string) error

func (*Database) AddNewCrawl

func (db *Database) AddNewCrawl(importPath string) error

func (*Database) AllPackages

func (db *Database) AllPackages() ([]Package, error)

func (*Database) Block

func (db *Database) Block(root string) error

func (*Database) BumpCrawl

func (db *Database) BumpCrawl(projectRoot string) error

func (*Database) Delete

func (db *Database) Delete(path string) error

Delete deletes the documenation for the given import path.

func (*Database) Do

func (db *Database) Do(f func(*PackageInfo) error) error

Do executes function f for each document in the database.

func (*Database) Exists

func (db *Database) Exists(path string) (bool, error)

Exists returns true if package with import path exists in the database.

func (*Database) Get

func (db *Database) Get(path string) (*doc.Package, []Package, time.Time, error)

Get gets the package documenation and sub-directories for the the given import path.

func (*Database) GetDoc

func (db *Database) GetDoc(path string) (*doc.Package, time.Time, error)

func (*Database) GetGob

func (db *Database) GetGob(key string, value interface{}) error

func (*Database) GoIndex

func (db *Database) GoIndex() ([]Package, error)

func (*Database) GoSubrepoIndex

func (db *Database) GoSubrepoIndex() ([]Package, error)

func (*Database) ImportGraph

func (db *Database) ImportGraph(pdoc *doc.Package, level DepLevel) ([]Package, [][2]int, error)

func (*Database) ImporterCount

func (db *Database) ImporterCount(path string) (int, error)

func (*Database) Importers

func (db *Database) Importers(path string) ([]Package, error)

func (*Database) IncrementCounter

func (db *Database) IncrementCounter(key string, delta float64) (float64, error)

func (*Database) IncrementPopularScore

func (db *Database) IncrementPopularScore(path string) error

func (*Database) Index

func (db *Database) Index() ([]Package, error)

func (*Database) IsBlocked

func (db *Database) IsBlocked(path string) (bool, error)

func (*Database) Packages

func (db *Database) Packages(paths []string) ([]Package, error)

func (*Database) PopNewCrawl

func (db *Database) PopNewCrawl() (string, bool, error)

func (*Database) Popular

func (db *Database) Popular(count int) ([]Package, error)

func (*Database) PopularWithScores

func (db *Database) PopularWithScores() ([]Package, error)

func (*Database) Project

func (db *Database) Project(projectRoot string) ([]Package, error)

func (*Database) Put

func (db *Database) Put(pdoc *doc.Package, nextCrawl time.Time, hide bool) error

Put adds the package documentation to the database.

func (*Database) PutGob

func (db *Database) PutGob(key string, value interface{}) error

func (*Database) Query

func (db *Database) Query(q string) ([]Package, error)

func (*Database) SetNextCrawlEtag

func (db *Database) SetNextCrawlEtag(projectRoot string, etag string, t time.Time) error

SetNextCrawlEtag sets the next crawl time for all packages in the project with the given etag.

type DepLevel

type DepLevel int

DepLevel specifies the level of depdenencies to show in an import graph.

const (
	ShowAllDeps      DepLevel = iota // show all dependencies
	HideStandardDeps                 // don't show dependencies of standard libraries
	HideStandardAll                  // don't show standard libraries at all
)

type Package

type Package struct {
	Path     string `json:"path"`
	Synopsis string `json:"synopsis,omitempty"`
}

type PackageInfo

type PackageInfo struct {
	PDoc  *doc.Package
	Score float64
	Kind  string
	Size  int
}