Documentation
¶
Overview ¶
Package unit provides a source unit abstraction over distribution packages in various languages.
Package unit is a generated protocol buffer package.
It is generated from these files:
unit.proto
It has these top-level messages:
RepoSourceUnit
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func ExpandPaths ¶
ExpandPaths interprets paths, which contains paths (optionally with filepath.Glob-compatible globs) that are relative to base. A list of actual files that are referenced is returned.
Types ¶
type Info ¶
type Info struct {
// NameInRepository is the name to use when displaying the source unit in
// the context of the repository in which it is defined. This name
// typically needs less qualification than GlobalName.
//
// For example, a Go package's GlobalName is its repository URI basename
// plus its directory path within the repository (e.g.,
// "github.com/user/repo/x/y"'s NameInRepository is "repo/x/y"). Because npm
// and pip packages are named globally, their name is probably appropriate
// to use as both the unit's NameInRepository and GlobalName.
NameInRepository string
// GlobalName is the name to use when displaying the source unit *OUTSIDE OF*
// the context of the repository in which it is defined.
//
// For example, a Go package's GlobalName is its full import path. Because
// npm and pip packages are named globally, their name is probably
// appropriate to use as both the unit's NameInRepository and GlobalName.
GlobalName string
// Description is a short (~1-sentence) description of the source unit.
Description string
// TypeName is the human-readable name of the type of source unit; e.g., "Go
// package".
TypeName string
}
func GetInfo ¶
func GetInfo(u SourceUnit) Info
GetInfo returns a source unit's Info field if non-nil, or otherwise an Info struct filled with values derived from the source unit's name and type.
type Key ¶
type Key struct {
// Repo is the URI of the repository containing this source unit.
Repo string
// CommitID is the VCS commit that the source unit exists at.
CommitID string
// UnitType is the source unit's Type.
UnitType string
// Unit is the source unit's Name.
Unit string
}
Key is the unique key for a source unit.
type RepoSourceUnit ¶
type RepoSourceUnit struct {
Repo string `protobuf:"bytes,1,opt,name=repo,proto3" json:"repo,omitempty"`
CommitID string `protobuf:"bytes,2,opt,name=commit_id,proto3" json:"commit_id,omitempty"`
UnitType string `protobuf:"bytes,3,opt,name=unit_type,proto3" json:"unit_type,omitempty"`
Unit string `protobuf:"bytes,4,opt,name=unit,proto3" json:"unit,omitempty"`
// Data is the JSON of the underlying SourceUnit.
Data []byte `protobuf:"bytes,5,opt,name=data,proto3" json:"data,omitempty"`
}
A RepoSourceUnit is the "concrete" form of SourceUnit that includes information about which repository (and commit) the source unit exists in. In general, type SourceUnit is used during analysis of a single source unit and type RepoSourceUnit is used afterwards (either in cross-source-unit analysis, such as cross-reference resolution, or in after-the-fact DB/API queries).
func NewRepoSourceUnit ¶
func NewRepoSourceUnit(u *SourceUnit) (*RepoSourceUnit, error)
NewRepoSourceUnit creates an equivalent RepoSourceUnit from a SourceUnit.
It does not set the returned source unit's Private field (because it can't tell if it is private from the underlying source unit alone).
It also doesn't set CommitID (for the same reason).
func (*RepoSourceUnit) ProtoMessage ¶
func (*RepoSourceUnit) ProtoMessage()
func (*RepoSourceUnit) Reset ¶
func (m *RepoSourceUnit) Reset()
func (*RepoSourceUnit) SourceUnit ¶
func (u *RepoSourceUnit) SourceUnit() (*SourceUnit, error)
SourceUnit decodes u's Data JSON field to the SourceUnit it represents.
func (*RepoSourceUnit) String ¶
func (m *RepoSourceUnit) String() string
type SourceUnit ¶
type SourceUnit struct {
// Name is an opaque identifier for this source unit that MUST be unique
// among all other source units of the same type in the same repository.
//
// Two source units of different types in a repository may have the same name.
// To obtain an identifier for a source unit that is guaranteed to be unique
// repository-wide, use the ID method.
Name string
// Type is the type of source unit this represents, such as "GoPackage".
Type string
// Repo is the URI of the repository containing this source unit, if any.
// The scanner tool does not need to set this field - it can be left blank,
// to be filled in by the `src` tool
Repo string `json:",omitempty"`
// CommitID is the commit ID of the repository containing this
// source unit, if any. The scanner tool need not fill this in; it
// should be left blank, to be filled in by the `src` tool.
CommitID string `json:",omitempty"`
// Globs is a list of patterns that match files that make up this source
// unit. It is used to detect when the source unit definition is out of date
// (e.g., when a file matches the glob but is not in the Files list).
//
// TODO(sqs): implement this in the Makefiles
Globs []string `json:",omitempty"`
// Files is all of the files that make up this source unit. Filepaths should
// be relative to the repository root.
Files []string
// Dir is the root directory of this source unit. It is optional and maybe
// empty.
Dir string `json:",omitempty"`
// Dependencies is a list of dependencies that this source unit has. The
// schema for these dependencies is internal to the scanner that produced
// this source unit. The dependency resolver is expected to know how to
// interpret this schema.
//
// The dependency information stored in this field should be able to be very
// quickly determined by the scanner. The scanner should not perform any
// dependency resolution on these entries. This is because the scanner is
// run frequently and should execute very quickly, and dependency resolution
// is often slow (requiring network access, etc.).
Dependencies []interface{} `json:",omitempty"`
// Info is an optional field that contains additional information used to
// display the source unit
Info *Info `json:",omitempty"`
// Data is additional data dumped by the scanner about this source unit. It
// typically holds information that the scanner wants to make available to
// other components in the toolchain (grapher, dep resolver, etc.).
Data interface{} `json:",omitempty"`
// Config is an arbitrary key-value property map. The Config map from the
// tree config is copied verbatim to each source unit. It can be used to
// pass options from the Srcfile to tools.
Config map[string]interface{} `json:",omitempty"`
// Ops enumerates the operations that should be performed on this source
// unit. Each key is the name of an operation, and the value is the tool to
// use to perform that operation. If the value is nil, the tool is chosen
// automatically according to the user's configuration.
Ops map[string]*srclib.ToolRef `json:",omitempty"`
}
START SourceUnit OMIT
func (SourceUnit) ContainsAny ¶
func (u SourceUnit) ContainsAny(filenames []string) bool
ContainsAny returns true if u contains any files in filesnames. Currently doesn't process globs.
func (SourceUnit) ID ¶
func (u SourceUnit) ID() ID
ID returns an opaque identifier for this source unit that is guaranteed to be unique among all other source units in the same repository.
func (*SourceUnit) ID2 ¶
func (u *SourceUnit) ID2() ID2
func (*SourceUnit) Key ¶
func (u *SourceUnit) Key() Key
func (*SourceUnit) OpsSorted ¶
func (u *SourceUnit) OpsSorted() []string
OpsSorted returns the keys of the Ops map in sorted order.
func (SourceUnit) String ¶
func (u SourceUnit) String() string
type SourceUnits ¶
type SourceUnits []*SourceUnit
func (SourceUnits) Len ¶
func (v SourceUnits) Len() int
func (SourceUnits) Less ¶
func (v SourceUnits) Less(i, j int) bool
func (SourceUnits) Swap ¶
func (v SourceUnits) Swap(i, j int)
Source Files