list

Documentation

Overview

Package list provides a public list of SCALIBR-internal extraction plugins.

Index

• Variables
• func ExtractorFromName(name string) (filesystem.Extractor, error)
• func ExtractorsFromNames(names []string) ([]filesystem.Extractor, error)
• func FilterByCapabilities(exs []filesystem.Extractor, capabs *plugin.Capabilities) []filesystem.Extractor
• func FromCapabilities(capabs *plugin.Capabilities) []filesystem.Extractor
• type InitFn
• type InitMap

Variables

var (

	// C++ extractors.
	Cpp = InitMap{conanlock.Name: {conanlock.New}}
	// Java extractors.
	Java = InitMap{
		gradlelockfile.Name:                {gradlelockfile.New},
		gradleverificationmetadataxml.Name: {gradleverificationmetadataxml.New},
		javaarchive.Name:                   {javaarchive.NewDefault},

		pomxml.Name:    {pomxml.New},
		pomxmlnet.Name: {pomxmlnet.NewDefault},
	}
	// Javascript extractors.
	Javascript = InitMap{
		packagejson.Name:     {packagejson.NewDefault},
		packagelockjson.Name: {packagelockjson.NewDefault},
		pnpmlock.Name:        {pnpmlock.New},
		yarnlock.Name:        {yarnlock.New},
		bunlock.Name:         {bunlock.New},
	}
	// Python extractors.
	Python = InitMap{
		wheelegg.Name:     {wheelegg.NewDefault},
		requirements.Name: {requirements.NewDefault},
		setup.Name:        {setup.NewDefault},
		pipfilelock.Name:  {pipfilelock.New},
		pdmlock.Name:      {pdmlock.New},
		poetrylock.Name:   {poetrylock.New},
		condameta.Name:    {condameta.NewDefault},
		uvlock.Name:       {uvlock.New},
	}
	// Go extractors.
	Go = InitMap{
		gobinary.Name: {gobinary.NewDefault},
		gomod.Name:    {gomod.New},
	}
	// Dart extractors.
	Dart = InitMap{pubspec.Name: {pubspec.New}}
	// Erlang extractors.
	Erlang = InitMap{mixlock.Name: {mixlock.New}}
	// Elixir extractors.
	Elixir = InitMap{elixir.Name: {elixir.NewDefault}}
	// Haskell extractors.
	Haskell = InitMap{
		stacklock.Name: {stacklock.NewDefault},
		cabal.Name:     {cabal.NewDefault},
	}
	// R extractors
	R = InitMap{renvlock.Name: {renvlock.New}}
	// Ruby extractors.
	Ruby = InitMap{
		gemspec.Name:     {gemspec.NewDefault},
		gemfilelock.Name: {gemfilelock.New},
	}
	// Rust extractors.
	Rust = InitMap{
		cargolock.Name:      {cargolock.New},
		cargoauditable.Name: {cargoauditable.NewDefault},
		cargotoml.Name:      {cargotoml.New},
	}
	// SBOM extractors.
	SBOM = InitMap{
		cdx.Name:  {cdx.New},
		spdx.Name: {spdx.New},
	}
	// Dotnet (.NET) extractors.
	Dotnet = InitMap{
		depsjson.Name:         {depsjson.NewDefault},
		packagesconfig.Name:   {packagesconfig.NewDefault},
		packageslockjson.Name: {packageslockjson.NewDefault},
	}
	// PHP extractors.
	PHP = InitMap{composerlock.Name: {composerlock.New}}

	Swift = InitMap{
		packageresolved.Name: {packageresolved.NewDefault},
		podfilelock.Name:     {podfilelock.NewDefault},
	}

	// Containers extractors.
	Containers = InitMap{containerd.Name: {containerd.NewDefault}} // Wordpress extractors.

	// OS extractors.
	OS = InitMap{
		dpkg.Name:     {dpkg.NewDefault},
		apk.Name:      {apk.NewDefault},
		rpm.Name:      {rpm.NewDefault},
		cos.Name:      {cos.NewDefault},
		snap.Name:     {snap.NewDefault},
		nix.Name:      {nix.New},
		module.Name:   {module.NewDefault},
		vmlinuz.Name:  {vmlinuz.NewDefault},
		pacman.Name:   {pacman.NewDefault},
		portage.Name:  {portage.NewDefault},
		flatpak.Name:  {flatpak.NewDefault},
		homebrew.Name: {homebrew.New},
		macapps.Name:  {macapps.NewDefault},
	}

	// Misc extractors.
	Misc = InitMap{
		vscodeextensions.Name: {vscodeextensions.New},
		wordpressplugins.Name: {wordpressplugins.NewDefault},
	}

	// Default extractors that are recommended to be enabled.
	Default = concat(Java, Javascript, Python, Go, OS)
	// All extractors available from SCALIBR.
	All = concat(
		Cpp,
		Java,
		Javascript,
		Python,
		Go,
		Dart,
		Erlang,
		Elixir,
		Haskell,
		PHP,
		R,
		Ruby,
		Rust,
		Dotnet,
		SBOM,
		Swift,
		OS,
		Misc,
		Containers,
	)
)

LINT.IfChange

Functions

func ExtractorFromName

func ExtractorFromName(name string) (filesystem.Extractor, error)

ExtractorFromName returns a single extractor based on its exact name.

func ExtractorsFromNames

func ExtractorsFromNames(names []string) ([]filesystem.Extractor, error)

ExtractorsFromNames returns a deduplicated list of extractors from a list of names.

func FilterByCapabilities

func FilterByCapabilities(exs []filesystem.Extractor, capabs *plugin.Capabilities) []filesystem.Extractor

FilterByCapabilities returns all extractors from the given list that can run under the specified capabilities (OS, direct filesystem access, network access, etc.) of the scanning environment.

func FromCapabilities

func FromCapabilities(capabs *plugin.Capabilities) []filesystem.Extractor

FromCapabilities returns all extractors that can run under the specified capabilities (OS, direct filesystem access, network access, etc.) of the scanning environment.

Types

type InitFn

type InitFn func() filesystem.Extractor

InitFn is the extractor initializer function.

type InitMap

type InitMap map[string][]InitFn

InitMap is a map of extractor names to their initers.