Pants BUILD Dictionary

A BUILD file defines one or more build targets. A target represents a set of source files, dependencies or other 'nouns' that build commands can act on. The type of a target determines what actions apply to it. For example, a jvm_binary target can be compiled and run.

[ Expand All | Collapse All ]

Target Types

alias: A target that gets replaced by its dependencies.
- dependencies = ..., (default: [])
  
  description = ..., (default: None)
  
  name = ...,
  
  no_cache = ..., (default: False)
  
  tags = ..., (default: None)

annotation_processor: A Java library containing annotation processors.

:API: public

= ...,	class:`pants.backend.jvm.artifact.Artifact` provides: (default: None)
*args = ...,	None
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
processors = ...,	A list of the fully qualified class names of the annotation processors this library exports. (default: None)
provides = ...,	(default: None)
resources = ...,	An optional list of file paths (DEPRECATED) or ``resources`` targets (which in turn point to file paths). The paths indicate text file resources to place in this module's jar. (default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

benchmark: A caliper benchmark.

Run it with the ``bench`` goal.

dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

contrib_plugin: A contributed pants plugin published by pantsbuild.

additional_classifiers = ...,	Any additional trove classifiers that apply to the plugin, see: https://pypi.python.org/pypi?%3Aaction=list_classifiers (default: None)
build_file_aliases = ...,	If `True`, register.py:build_file_aliases must be defined and registers the 'build_file_aliases' 'pantsbuild.plugin' entrypoint. (default: False)
compatibility = ...,	either a string that represents interpreter compatibility for this target using the Requirement-style format, e.g. ``'CPython>=2.7,<3'`` (Select a CPython interpreter with version ``>=2.7`` AND version ``<3``) or a list of Requirement-style strings which will be OR'ed together. If the compatibility requirement is agnostic to interpreter class, using the example above, a Requirement-style compatibility constraint like '>=2.7,<3' (N.B.: not prefixed with CPython) can be used. (default: None)
dependencies = ...,	The addresses of targets that this target depends on. These dependencies may be ``python_library``-like targets (``python_library``, ``python_thrift_library``, ``python_antlr_library`` and so forth) or ``python_requirement_library`` targets. (default: None)
description = ...,	A brief description of what the plugin provides. (default: None)
distribution_name = ...,	The name of the plugin package; must start with 'pantsbuild.pants.'. (default: None)
global_subsystems = ...,	If `True`, register.py:global_subsystems must be defined and registers the 'global_subsystems' 'pantsbuild.plugin' entrypoint. (default: False)
name = ...,
no_cache = ...,	(default: False)
provides = ...,	The `setup_py <#setup_py>`_ to publish that represents this target outside the repo. (default: None)
register_goals = ...,	If `True`, register.py:register_goals must be defined and registers the 'register_goals' 'pantsbuild.plugin' entrypoint. (default: False)
sources = ...,	Files to "include". Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

cpp_binary: A C++ binary.

dependencies = ...,	(default: [])
description = ...,	(default: None)
libraries = ...,	Libraries that this target depends on that are not pants targets. For example, 'm' or 'rt' that are expected to be installed on the local system. (default: None)
name = ...,
no_cache = ...,	(default: False)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

cpp_library: A statically linked C++ library.

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

credentials: <Add description>

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,	The name of these credentials. (default: None)
no_cache = ...,	(default: False)
password = ...,	A constant password value. (default: None)
tags = ...,	(default: None)
username = ...,	A constant username value. (default: None)

files: A collection of loose files.

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
sources = ...,	Files to "include". Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

go_binary: A local Go main package.
- dependencies = ..., (default: [])
  
  description = ..., (default: None)
  
  name = ...,
  
  no_cache = ..., (default: False)
  
  sources = ..., (default: None)
  
  tags = ..., (default: None)

go_library: A local Go package.
- dependencies = ..., (default: [])
  
  description = ..., (default: None)
  
  name = ...,
  
  no_cache = ..., (default: False)
  
  sources = ..., (default: None)
  
  tags = ..., (default: None)

go_remote_libraries: A remote Go package.

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
pkg = ...,	The package import path within the remote library; by default the root package path (equivalent to passing `pkg='.'` or `pkg=''`). (default: )
rev = ...,	Identifies which version of the remote library to download. This could be a commit SHA (git), node id (hg), etc. If left unspecified the version will default to the latest available. It's highly recommended to not accept the default and instead pin the rev explicitly for repeatable builds. (default: )
tags = ...,	(default: None)

go_remote_library: A remote Go package.

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
pkg = ...,	The package import path within the remote library; by default the root package path (equivalent to passing `pkg='.'` or `pkg=''`). (default: )
rev = ...,	Identifies which version of the remote library to download. This could be a commit SHA (git), node id (hg), etc. If left unspecified the version will default to the latest available. It's highly recommended to not accept the default and instead pin the rev explicitly for repeatable builds. (default: )
tags = ...,	(default: None)

go_thrift_library: A Go library generated from Thrift IDL files.

dependencies = ...,	(default: [])
description = ...,	(default: None)
import_path = ...,	Deprecated: unused. (default: None)
name = ...,
no_cache = ...,	(default: False)
sources = ...,	thrift source files (default: None)
tags = ...,	(default: None)

jar_library: A set of external JAR files.

:API: public

dependencies = ...,	(default: [])
description = ...,	(default: None)
jars = ...,	List of `jar <#jar>`_\s to depend upon. (default: None)
managed_dependencies = ...,	Address of a managed_jar_dependencies() target to use. If omitted, uses the default managed_jar_dependencies() target set by --jar-dependency-management-default-target. (default: None)
name = ...,
no_cache = ...,	(default: False)
tags = ...,	(default: None)

java_agent: A Java agent entrypoint.

= ...,	class:`pants.backend.jvm.artifact.Artifact` provides: (default: None)
*args = ...,	None
agent_class = ...,	If an implementation supports a mechanism to start agents sometime after the VM has started then this attribute specifies the agent class. Exactly one of ``premain`` or ``agent_class`` must be specified. (default: None)
can_redefine = ...,	`True` if the ability to redefine classes is needed by this agent; `False` by default. (default: False)
can_retransform = ...,	`True` if the ability to retransform classes is needed by this agent; `False` by default. (default: False)
can_set_native_method_prefix = ...,	`True` if the ability to set he native method prefix is needed by this agent; `False` by default. (default: False)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	(default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
premain = ...,	When an agent is specified at JVM launch time this attribute specifies the agent class. Exactly one of ``premain`` or ``agent_class`` must be specified. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	(default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_antlr_library: A Java library generated from Antlr grammar files.

compiler = ...,	The name of the compiler used to compile the ANTLR files. Currently only supports 'antlr3' and 'antlr4' (default: antlr3)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	(default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,	(default: None)
no_cache = ...,	(default: False)
package = ...,	(antlr4 only) A string which specifies the package to be used on the dependent sources. If unset, the package will be based on the path to the sources. Note that if the sources are spread among different files, this must be set as the package cannot be inferred. (default: None)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	The ``artifact`` to publish that represents this target outside the repo. (default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	(default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_avro_library: Defines a target that builds Java code from Avro schema, protocol, or IDL files.

dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_library: A Java library.

Normally has conceptually-related sources; invoking the ``compile`` goal on this target compiles Java and generates classes. Invoking the ``jar`` goal on this target creates a ``.jar``; but that's an unusual thing to do. Instead, a ``jvm_binary`` might depend on this library; that binary is a more sensible thing to bundle. :API: public

= ...,	class:`pants.backend.jvm.artifact.Artifact` provides: (default: None)
*args = ...,	None
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_protobuf_library: A Java library generated from Protocol Buffer IDL files.

buildflags = ...,	Unused, and will be removed in a future release. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
imports = ...,	List of addresses of `jar_library <#jar_library>`_ targets which contain .proto definitions. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_ragel_library: A Java library generated from a Ragel file.

dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_tests: <Add description>

*args = ...,	None
concurrency = ...,	One of 'SERIAL', 'PARALLEL_CLASSES', 'PARALLEL_METHODS', or 'PARALLEL_CLASSES_AND_METHODS'. Overrides the setting of --test-junit-default-concurrency. (default: None)
cwd = ...,	working directory (relative to the build root) for the tests under this target. If unspecified (None), the working directory will be controlled by junit_run's --cwd and --chroot options. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
extra_env_vars = ...,	A map of environment variables to set when running the tests, e.g. { 'FOOBAR': 12 }. Using `None` as the value will cause the variable to be unset. (default: None)
extra_jvm_options = ...,	A list of key value pairs of jvm options to use when running the tests. Example: ['-Dexample.property=1'] If unspecified, no extra jvm options will be added. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
test_platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for running tests (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the same one used for compilation. (default: None)
threads = ...,	Use the specified number of threads when running the test. Overrides the setting of --test-junit-parallel-threads. (default: None)
timeout = ...,	A timeout (in seconds) which covers the total runtime of all tests in this target. Only applied if `--test-junit-timeouts` is set to True. (default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_thrift_library: A Java library generated from Thrift IDL files.

:API: public

compiler = ...,	The compiler used to compile the thrift files. The default is defined in the global options under ``--thrift-default-compiler``. (default: None)
compiler_args = ...,	Extra arguments to the compiler. (default: None)
default_java_namespace = ...,	The namespace used for Java generated code when a Java namespace is not explicitly specified in the IDL. The default is defined in the global options under ``--thrift-default-default-java-namespace``. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
include_paths = ...,	(default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
language = ...,	The language used to generate the output files. The default is defined in the global options under ``--thrift-default-language``. (default: None)
name = ...,
namespace_map = ...,	An optional dictionary of namespaces to remap {old: new} (default: None)
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
thrift_linter_strict = ...,	If True, fail if thrift linter produces any warnings. (default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_thrifty_library: An Android-optimized Java library generated by the Microsoft Thrifty thrift compiler.

Says Thrifty, "Thrifty is an implementation of the Apache Thrift software stack for Android, which uses 1/4 of the method count taken by the Apache Thrift compiler." For details, see https://github.com/Microsoft/thrifty

dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

java_wire_library: A Java library generated from Wire IDL files.

Supports Wire 1.x only. For an example Wire 2.x interface that generates service stubs see: https://github.com/ericzundel/mvn2pants/tree/master/src/python/squarepants/plugins/sake_wire_codegen But note this requires you to write a custom wire code generator with a command line interface. :API: public

dependencies = ...,	(default: [])
description = ...,	(default: None)
enum_options = ...,	list of enums to pass to as the --enum-enum_options option, # optional (default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
no_options = ...,	boolean that determines if --no_options flag is passed (default: None)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
registry_class = ...,	fully qualified class name of RegistryClass to create. If in doubt, specify com.squareup.wire.SimpleServiceWriter (default: None)
roots = ...,	passed through to the --roots option of the Wire compiler (default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
service_writer = ...,	the name of the class to pass as the --service_writer option to the Wire compiler (For wire 1.0 only) (default: None)
service_writer_options = ...,	A list of options to pass to the service writer (For wire 1.x only) (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

javac_plugin: A Java compiler plugin.

= ...,	class:`pants.backend.jvm.artifact.Artifact` provides: (default: None)
*args = ...,	None
classname = ...,	The fully qualified plugin class name - required. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
plugin = ...,	The name of the plugin. Defaults to name if not supplied. These are the names passed to javac's -Xplugin flag. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

jax_ws_library: Generates a Java library from JAX-WS wsdl files.

dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
extra_args = ...,	Additional arguments for the CLI. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
xjc_args = ...,	Additional arguments to xjc. (default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

jaxb_library: A Java library generated from JAXB xsd files.

dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
language = ...,	only 'java' is supported. Default: 'java' (default: java)
name = ...,
no_cache = ...,	(default: False)
package = ...,	java package (com.company.package) in which to generate the output java files. If unspecified, Pants guesses it from the file path leading to the schema (xsd) file. This guess is accurate only if the .xsd file is in a path like ``.../com/company/package/schema.xsd``. Pants looks for packages that start with 'com', 'org', or 'net'. (default: None)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

junit_tests: JUnit tests.

:API: public

concurrency = ...,	One of 'SERIAL', 'PARALLEL_CLASSES', 'PARALLEL_METHODS', or 'PARALLEL_CLASSES_AND_METHODS'. Overrides the setting of --test-junit-default-concurrency. (default: None)
cwd = ...,	working directory (relative to the build root) for the tests under this target. If unspecified (None), the working directory will be controlled by junit_run's --cwd and --chroot options. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
extra_env_vars = ...,	A map of environment variables to set when running the tests, e.g. { 'FOOBAR': 12 }. Using `None` as the value will cause the variable to be unset. (default: None)
extra_jvm_options = ...,	A list of key value pairs of jvm options to use when running the tests. Example: ['-Dexample.property=1'] If unspecified, no extra jvm options will be added. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
test_platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for running tests (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the same one used for compilation. (default: None)
threads = ...,	Use the specified number of threads when running the test. Overrides the setting of --test-junit-parallel-threads. (default: None)
timeout = ...,	A timeout (in seconds) which covers the total runtime of all tests in this target. Only applied if `--test-junit-timeouts` is set to True. (default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

jvm_app: A deployable JVM application.

Invoking the ``bundle`` goal on one of these targets creates a self-contained artifact suitable for deployment on some other machine. The artifact contains the executable jar, its dependencies, and extra files like config files, startup scripts, etc. :API: public

archive = ...,	Create an archive of this type from the bundle. (default: None)
basename = ...,	Name of this application, if different from the ``name``. Optionally pants uses this in the ``bundle`` goal to name the distribution artifact. Note this is unsafe because of the possible conflict when multiple bundles are built. (default: None)
binary = ...,	Target spec of the ``jvm_binary`` that contains the app main. (default: None)
bundles = ...,	One or more ``bundle``\s describing "extra files" that should be included with this app (e.g.: config files, startup scripts). (default: None)
dependencies = ...,	(default: [])
deployjar = ...,	If True, pack all 3rdparty and internal jar classfiles into a single deployjar in the bundle's root dir. If unset, all jars will go into the bundle's libs directory, the root will only contain a synthetic jar with its manifest's Class-Path set to those jars. (default: None)
description = ...,	(default: None)
name = ...,	(default: None)
no_cache = ...,	(default: False)
tags = ...,	(default: None)

jvm_binary: A JVM binary.

Below are a summary of how key goals affect targets of this type: * ``bundle`` - Creates a self-contained directory with the binary and all its dependencies, optionally archived, suitable for deployment. * ``binary`` - Create an executable jar of the binary. On the JVM this means the jar has a manifest specifying the main class. * ``run`` - Executes the main class of this binary locally. :API: public

basename = ...,	Base name for the generated ``.jar`` file, e.g., ``'hello'``. (By default, uses ``name`` param) Note this is unsafe because of the possible conflict when multiple binaries are built. (default: None)
dependencies = ...,	Targets (probably ``java_library`` and ``scala_library`` targets) to "link" in. (default: None)
deploy_excludes = ...,	List of `exclude <#exclude>`_\s to apply at deploy time. If you, for example, deploy a java servlet that has one version of ``servlet.jar`` onto a Tomcat environment that provides another version, they might conflict. ``deploy_excludes`` gives you a way to build your code but exclude the conflicting ``jar`` when deploying. (default: None)
deploy_jar_rules = ...,	`Jar rules <#jar_rules>`_ for packaging this binary in a deploy jar. (default: None)
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
main = ...,	The name of the ``main`` class, e.g., ``'org.pantsbuild.example.hello.main.HelloMain'``. This class may be present as the source of this target or depended-upon library. (default: None)
manifest_entries = ...,	dict that specifies entries for `ManifestEntries <#manifest_entries>`_ for adding to MANIFEST.MF when packaging this binary. (default: None)
name = ...,	(default: None)
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
shading_rules = ...,	Optional list of shading rules to apply when building a shaded (aka monolithic aka fat) binary jar. The order of the rules matters: the first rule which matches a fully-qualified class name is used to shade it. See shading_relocate(), shading_exclude(), shading_relocate_package(), and shading_exclude_package(). (default: None)
source = ...,	Name of one ``.java`` or ``.scala`` file (a good place for a ``main``). (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

jvm_prep_command: A command (defined in a Java target) that must be run before other tasks in a goal.

For example, you can use `jvm_prep_command()` to execute a script that sets up tunnels to database servers. These tunnels could then be leveraged by integration tests. You can define a jvm_prep_command() target as follows: jvm_prep_command( name='foo', goal='test', mainclass='com.example.myproject.BeforeTestMain', args=['--foo', 'bar'], jvm_options=['-Xmx256M', '-Dmy.property=baz'], dependencies=[ 'myproject/src/main/java:lib', ], ) Pants will execute the `jvm_prep_command()` when processing the specified goal. They will be triggered when running targets that depend on the `prep_command()` target or when the target is referenced from the command line. See also prep_command for running shell commands. :API: public

args = ...,	A list of command-line args to the excutable. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
goal = ...,	Pants goal to run this command in [test, binary or compile]. If not specified, runs in 'test' (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
jvm_options = ...,	extra options to pass the JVM (default: None)
mainclass = ...,	The path to the executable that should be run. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

managed_jar_dependencies: A set of pinned external artifact versions to apply transitively.

artifacts = ...,	List of `jar <#jar>`_\s or specs to jar_library targets with pinned versions. Versions are pinned per (org, name, classifier, ext) artifact coordinate (excludes, etc are ignored for the purposes of pinning). (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
tags = ...,	(default: None)

netrc_credentials: A Credentials subclass that uses a Netrc file to compute credentials.
- dependencies = ..., (default: [])
  
  description = ..., (default: None)
  
  name = ...,
  
  no_cache = ..., (default: False)
  
  tags = ..., (default: None)

node_bundle: A bundle of node modules.

archive = ...,	a string, select from tar, tgz, tbz2, default to tgz (default: tgz)
dependencies = ...,	a list of node_modules (default: None)
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
node_module = ...,	(default: None)
package_name = ...,	The remote module package name, if not supplied the target name is used. (default: None)
tags = ...,	(default: None)

node_module: A Node module.

build_script = ...,	build script name as defined in package.json. All files that are needed for the build script must be included in sources. The script should output build results in the directory specified by output_dir. If build_script is not supplied, the node installation results will be considered as output. The output can be archived or included as resources for JVM target. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
dev_dependency = ...,	boolean value. Default is False. If a node_module is used as parts of devDependencies and thus should not be included in the final bundle or JVM binaries, set this value to True. (default: False)
name = ...,
no_cache = ...,	(default: False)
output_dir = ...,	relative path to assets generated by build script. The path will be preserved in the created JAR if the target is used as a JVM target dependency. (default: dist)
package_manager = ...,	choose among supported package managers (npm or yarn). (default: None)
package_name = ...,	The remote module package name, if not supplied the target name is used. (default: None)
sources = ...,	Javascript and other source code files that make up this module; paths are relative to the BUILD file's directory. (default: None)
style_ignore_path = ...,	relative path to file specifying patterns of files to ignore. The syntax supported is the same as the .eslintignore/.gitignore syntax. (default: .eslintignore)
tags = ...,	(default: None)

node_preinstalled_module: A NodeModule which resolves deps by downloading an archived node_modules directory.

This is basically an example, to demonstrate how additional types of NodeModule targets with their own resolvers (in this case NodePreinstalledModuleResolver), which still work with NodeTest, can be registered. To be generallly correct, this target type and associated resolver would have to use platform- and Node-version-specific node_modules archives, rather than just a single dependencies_archive_url used verbatim. Consider NodePreinstalledModule and NodePreinstalledModuleResolver subject to future change or removal for now.

build_script = ...,	build script name as defined in package.json. All files that are needed for the build script must be included in sources. The script should output build results in the directory specified by output_dir. If build_script is not supplied, the node installation results will be considered as output. The output can be archived or included as resources for JVM target. (default: None)
dependencies = ...,	(default: [])
dependencies_archive_url = ...,	(default: None)
description = ...,	(default: None)
dev_dependency = ...,	boolean value. Default is False. If a node_module is used as parts of devDependencies and thus should not be included in the final bundle or JVM binaries, set this value to True. (default: False)
name = ...,
no_cache = ...,	(default: False)
output_dir = ...,	relative path to assets generated by build script. The path will be preserved in the created JAR if the target is used as a JVM target dependency. (default: dist)
package_manager = ...,	choose among supported package managers (npm or yarn). (default: None)
package_name = ...,	The remote module package name, if not supplied the target name is used. (default: None)
sources = ...,	(default: None)
style_ignore_path = ...,	relative path to file specifying patterns of files to ignore. The syntax supported is the same as the .eslintignore/.gitignore syntax. (default: .eslintignore)
tags = ...,	(default: None)
url = ...,	The location of a tar.gz file containing containing a node_modules directory. (default: None)

node_remote_module: A remote Node module.

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
package_name = ...,	The remote module package name, if not supplied the target name is used. (default: None)
tags = ...,	(default: None)
version = ...,	The version constraint for the remote node module. Any of the forms accepted by npm including '' or '*' for unconstrained (the default) are acceptable. See: https://docs.npmjs.com/files/package.json#dependencies (default: None)

node_test: Javascript tests run via a script specified in a package.json file.

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
script_name = ...,	The tests script name in package.json. Defaults to "test". (default: None)
tags = ...,	(default: None)
timeout = ...,	The test target timeout. (default: None)

page: A documentation page.

Here is an example, that shows a markdown page providing a wiki page on an Atlassian Confluence wiki: :: page(name='mypage', source='mypage.md', provides=[ wiki_artifact(wiki=Wiki('foozle', <url builder>), space='my_space', title='my_page', parent='my_parent'), ], ) A ``page`` can have more than one ``wiki_artifact`` in its ``provides`` (there might be more than one place to publish it).

dependencies = ...,	(default: [])
description = ...,	(default: None)
format = ...,	Page's format, ``md`` or ``rst``. By default, Pants infers from ``source`` file extension: ``.rst`` is ReStructured Text; anything else is Markdown. (default: None)
links = ...,	Other ``page`` targets that this `page` links to. (default: None)
name = ...,
no_cache = ...,	(default: False)
provides = ...,	Optional "Addresses" at which this page is published. E.g., a wiki location. (default: None)
source = ...,	Path to page source file. (default: None)
tags = ...,	(default: None)

pants_plugin: A pants plugin published by pantsbuild.

additional_classifiers = ...,	Any additional trove classifiers that apply to the plugin, see: https://pypi.python.org/pypi?%3Aaction=list_classifiers (default: None)
build_file_aliases = ...,	If `True`, register.py:build_file_aliases must be defined and registers the 'build_file_aliases' 'pantsbuild.plugin' entrypoint. (default: False)
compatibility = ...,	either a string that represents interpreter compatibility for this target using the Requirement-style format, e.g. ``'CPython>=2.7,<3'`` (Select a CPython interpreter with version ``>=2.7`` AND version ``<3``) or a list of Requirement-style strings which will be OR'ed together. If the compatibility requirement is agnostic to interpreter class, using the example above, a Requirement-style compatibility constraint like '>=2.7,<3' (N.B.: not prefixed with CPython) can be used. (default: None)
dependencies = ...,	The addresses of targets that this target depends on. These dependencies may be ``python_library``-like targets (``python_library``, ``python_thrift_library``, ``python_antlr_library`` and so forth) or ``python_requirement_library`` targets. (default: None)
description = ...,	A brief description of what the plugin provides. (default: None)
distribution_name = ...,	The name of the plugin package; must start with 'pantsbuild.pants.'. (default: None)
global_subsystems = ...,	If `True`, register.py:global_subsystems must be defined and registers the 'global_subsystems' 'pantsbuild.plugin' entrypoint. (default: False)
name = ...,
no_cache = ...,	(default: False)
provides = ...,	The `setup_py <#setup_py>`_ to publish that represents this target outside the repo. (default: None)
register_goals = ...,	If `True`, register.py:register_goals must be defined and registers the 'register_goals' 'pantsbuild.plugin' entrypoint. (default: False)
sources = ...,	Files to "include". Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

prep_command: A shell command to be run prior to running a goal.

For example, you can use `prep_command()` to execute a script that sets up tunnels to database servers. These tunnels could then be leveraged by integration tests. Pants will only execute the `prep_command()` under the specified goal, when processing targets that depend on the `prep_command()` target. If not otherwise specified, prep_commands execute in the test goal. See also jvm_prep_command for running tasks defined by a JVM language. :API: public

dependencies = ...,	(default: [])
description = ...,	(default: None)
goals = ...,	One or more pants goals to run this command in [test, binary or compile]. If not specified, runs in the 'test' goal. (default: None)
name = ...,
no_cache = ...,	(default: False)
prep_args = ...,	A list of command-line args to the excutable. (default: None)
prep_environ = ...,	If True, the output of the command will be treated as a \\0-separated list of key=value pairs to insert into the environment. Note that this will pollute the environment for all future tests, so avoid it if at all possible. (default: False)
prep_executable = ...,	The path to the executable that should be run. (default: None)
tags = ...,	(default: None)

python_antlr_library: A Python library generated from Antlr grammar files.

*args = ...,	None
antlr_version = ...,	(default: 3.1.3)
compatibility = ...,	either a string that represents interpreter compatibility for this target using the Requirement-style format, e.g. ``'CPython>=2.7,<3'`` (Select a CPython interpreter with version ``>=2.7`` AND version ``<3``) or a list of Requirement-style strings which will be OR'ed together. If the compatibility requirement is agnostic to interpreter class, using the example above, a Requirement-style compatibility constraint like '>=2.7,<3' (N.B.: not prefixed with CPython) can be used. (default: None)
dependencies = ...,	The addresses of targets that this target depends on. These dependencies may be ``python_library``-like targets (``python_library``, ``python_thrift_library``, ``python_antlr_library`` and so forth) or ``python_requirement_library`` targets. (default: None)
description = ...,	(default: None)
module = ...,	everything beneath module is relative to this module name, None if root namespace (default: None)
name = ...,
no_cache = ...,	(default: False)
provides = ...,	The `setup_py <#setup_py>`_ to publish that represents this target outside the repo. (default: None)
sources = ...,	Files to "include". Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

python_binary: A Python binary.

Python binaries are pex files, self-contained executable shell scripts that contain a complete Python environment capable of running the target. For more information about pex files see http://pantsbuild.github.io/python-readme.html#how-pex-files-work. :API: public

always_write_cache = ...,	whether or not the .deps cache of this PEX file should always be written to disk. (default: False)
compatibility = ...,	either a string or list of strings that represents interpreter compatibility for this target, using the Requirement-style format, e.g. ``'CPython>=3', or just ['>=2.7','<3']`` for requirements agnostic to interpreter class. (default: None)
dependencies = ...,	The addresses of targets that this target depends on. These dependencies may be ``python_library``-like targets (``python_library``, ``python_thrift_library``, ``python_antlr_library`` and so forth) or ``python_requirement_library`` targets. (default: None)
description = ...,	(default: None)
entry_point = ...,	the default entry point for this binary. if None, drops into the entry point that is defined by source. Something like "pants.bin.pants_exe:main", where "pants.bin.pants_exe" is the package name and "main" is the function name (if ommitted, the module is executed directly, presuming it has a ``__main.py__``). (default: None)
ignore_errors = ...,	should we ignore inability to resolve dependencies? (default: False)
indices = ...,	a list of indices to use for packages. (default: None)
inherit_path = ...,	inherit the sys.path of the environment that this binary runs in (default: False)
name = ...,
no_cache = ...,	(default: False)
platforms = ...,	extra platforms to target when building this binary. If this is, e.g., ``['current', 'linux-x86_64', 'macosx-10.4-x86_64']``, then when building the pex, then for any platform-dependent modules, Pants will include ``egg``\s for Linux (64-bit Intel), Mac OS X (version 10.4 or newer), and the current platform (whatever is being used when making the PEX). (default: ())
provides = ...,	The `setup_py <#setup_py>`_ to publish that represents this target outside the repo. (default: None)
repositories = ...,	a list of repositories to query for dependencies. (default: None)
shebang = ...,	(default: None)
source = ...,	relative path to one python source file that becomes this binary's __main__. If None specified, drops into an interpreter by default. (default: None)
sources = ...,	Overridden by source. To specify more than one source file, use a python_library and have the python_binary depend on that library. (default: None)
tags = ...,	(default: None)
zip_safe = ...,	whether or not this binary is safe to run in compacted (zip-file) form (default: True)

python_dist: A Python distribution target that accepts a user-defined setup.py.

compatibility = ...,	either a string or list of strings that represents interpreter compatibility for this target, using the Requirement-style format, e.g. ``'CPython>=3', or just ['>=2.7','<3']`` for requirements agnostic to interpreter class. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
sources = ...,	Files to "include". Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

python_library: A Python library.

:API: public

compatibility = ...,	either a string that represents interpreter compatibility for this target using the Requirement-style format, e.g. ``'CPython>=2.7,<3'`` (Select a CPython interpreter with version ``>=2.7`` AND version ``<3``) or a list of Requirement-style strings which will be OR'ed together. If the compatibility requirement is agnostic to interpreter class, using the example above, a Requirement-style compatibility constraint like '>=2.7,<3' (N.B.: not prefixed with CPython) can be used. (default: None)
dependencies = ...,	The addresses of targets that this target depends on. These dependencies may be ``python_library``-like targets (``python_library``, ``python_thrift_library``, ``python_antlr_library`` and so forth) or ``python_requirement_library`` targets. (default: None)
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
provides = ...,	The `setup_py <#setup_py>`_ to publish that represents this target outside the repo. (default: None)
sources = ...,	Files to "include". Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

python_requirement_library: A set of pip requirements.

:API: public

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
requirements = ...,	pip requirements as `python_requirement <#python_requirement>`_\s. (default: None)
tags = ...,	(default: None)

python_tests: Python tests.

:API: public

compatibility = ...,	either a string that represents interpreter compatibility for this target using the Requirement-style format, e.g. ``'CPython>=2.7,<3'`` (Select a CPython interpreter with version ``>=2.7`` AND version ``<3``) or a list of Requirement-style strings which will be OR'ed together. If the compatibility requirement is agnostic to interpreter class, using the example above, a Requirement-style compatibility constraint like '>=2.7,<3' (N.B.: not prefixed with CPython) can be used. (default: None)
coverage = ...,	the module(s) whose coverage should be generated, e.g. 'twitter.common.log' or ['twitter.common.log', 'twitter.common.http'] (default: None)
dependencies = ...,	The addresses of targets that this target depends on. These dependencies may be ``python_library``-like targets (``python_library``, ``python_thrift_library``, ``python_antlr_library`` and so forth) or ``python_requirement_library`` targets. (default: None)
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
provides = ...,	The `setup_py <#setup_py>`_ to publish that represents this target outside the repo. (default: None)
sources = ...,	Files to "include". Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)
timeout = ...,	A timeout (in seconds) which covers the total runtime of all tests in this target. Only applied if `--test-pytest-timeouts` is set to True. (default: None)

python_thrift_library: A Python library generated from Thrift IDL files.

:API: public

compatibility = ...,	either a string that represents interpreter compatibility for this target using the Requirement-style format, e.g. ``'CPython>=2.7,<3'`` (Select a CPython interpreter with version ``>=2.7`` AND version ``<3``) or a list of Requirement-style strings which will be OR'ed together. If the compatibility requirement is agnostic to interpreter class, using the example above, a Requirement-style compatibility constraint like '>=2.7,<3' (N.B.: not prefixed with CPython) can be used. (default: None)
dependencies = ...,	The addresses of targets that this target depends on. These dependencies may be ``python_library``-like targets (``python_library``, ``python_thrift_library``, ``python_antlr_library`` and so forth) or ``python_requirement_library`` targets. (default: None)
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
provides = ...,	The `setup_py <#setup_py>`_ to publish that represents this target outside the repo. (default: None)
resources = ...,	non-Python resources, e.g. templates, keys, other data (it is recommended that your application uses the pkgutil package to access these resources in a .zip-module friendly way.) (default: None)
sources = ...,	thrift source files (If more than one tries to use the same namespace, beware https://issues.apache.org/jira/browse/THRIFT-515) (default: None)
tags = ...,	(default: None)

remote_sources: A target that generates a synthetic target using deferred sources.

This provides a mechanism for using the contents of a jar as sources for another target. The jar where the sources are specified from is given via the `sources_target` parameter, and the type for the target that should be created with those sources is given via the `dest` parameter. Any additional arguments for the new target go into the `args` parameter.

args = ...,	Any additional arguments necessary to construct the synthetic destination target (sources and dependencies are supplied automatically). (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
dest = ...,	The target type of the synthetic target to generate (eg, java_library). (default: None)
name = ...,
no_cache = ...,	(default: False)
sources_target = ...,	The address of the (typically unpacked_jars) target to get sources from. (default: None)
tags = ...,	(default: None)

resources: Resource files.

Looking for loose files in your JVM application bundle? Those are `bundle <#bundle>`_\s. Resources are files included in deployable units like Java jars or Python wheels and accessible via language-specific APIs. :API: public

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
sources = ...,	Files to "include". Paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

scala_js_binary: A binary javascript blob built from a collection of ScalaJSLibrary targets.

Extends NodeModule to allow consumption by NPM and node.

build_script = ...,	build script name as defined in package.json. All files that are needed for the build script must be included in sources. The script should output build results in the directory specified by output_dir. If build_script is not supplied, the node installation results will be considered as output. The output can be archived or included as resources for JVM target. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
dev_dependency = ...,	boolean value. Default is False. If a node_module is used as parts of devDependencies and thus should not be included in the final bundle or JVM binaries, set this value to True. (default: False)
name = ...,
no_cache = ...,	(default: False)
output_dir = ...,	relative path to assets generated by build script. The path will be preserved in the created JAR if the target is used as a JVM target dependency. (default: dist)
package_manager = ...,	choose among supported package managers (npm or yarn). (default: None)
package_name = ...,	The remote module package name, if not supplied the target name is used. (default: None)
sources = ...,	Javascript and other source code files that make up this module; paths are relative to the BUILD file's directory. (default: None)
style_ignore_path = ...,	relative path to file specifying patterns of files to ignore. The syntax supported is the same as the .eslintignore/.gitignore syntax. (default: .eslintignore)
tags = ...,	(default: None)

scala_js_library: A library with scala sources, intended to be compiled to Javascript.

Linking multiple libraries together into a shippable blob additionally requires a ScalaJSBinary target.

dependencies = ...,	(default: [])
description = ...,	(default: None)
name = ...,
no_cache = ...,	(default: False)
sources = ...,	Scala source that makes up this module; paths are relative to the BUILD file's directory. (default: None)
tags = ...,	(default: None)

scala_library: A Scala library.

Normally has conceptually-related sources; invoking the ``compile`` goal on this target compiles scala and generates classes. Invoking the ``bundle`` goal on this target creates a ``.jar``; but that's an unusual thing to do. Instead, a ``jvm_binary`` might depend on this library; that binary is a more sensible thing to bundle. :API: public

= ...,	class:`pants.backend.jvm.artifact.Artifact` provides: (default: None)
*args = ...,	None
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
java_sources = ...,	Java libraries this library has a circular dependency on. If you don't have the particular problem of circular dependencies forced by splitting interdependent java and scala into multiple targets, don't use this at all. Prefer using ``dependencies`` to express non-circular dependencies. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
provides = ...,	(default: None)
resources = ...,	An optional list of paths (DEPRECATED) or ``resources`` targets containing resources that belong on this library's classpath. (default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

scalac_plugin: A Scala compiler plugin.

= ...,	class:`pants.backend.jvm.artifact.Artifact` provides: (default: None)
*args = ...,	None
classname = ...,	The fully qualified plugin class name - required. (default: None)
dependencies = ...,	(default: [])
description = ...,	(default: None)
excludes = ...,	List of `exclude <#exclude>`_\s to filter this target's transitive dependencies against. (default: None)
exports = ...,	A list of exported targets, which will be accessible to dependents even with strict_deps turned on. A common use case is for library targets to to export dependencies that it knows its dependents will need. Then any dependents of that library target will have access to those dependencies even when strict_deps is True. Note: exports is transitive, which means dependents have access to the closure of exports. An example will be that if A exports B, and B exports C, then any targets that depends on A will have access to both B and C. (default: None)
fatal_warnings = ...,	Whether to turn warnings into errors for this target. If present, takes priority over the language's fatal-warnings option. (default: None)
java_sources = ...,	Java libraries this library has a circular dependency on. If you don't have the particular problem of circular dependencies forced by splitting interdependent java and scala into multiple targets, don't use this at all. Prefer using ``dependencies`` to express non-circular dependencies. (default: None)
javac_plugin_args = ...,	Map from javac plugin name to list of arguments for that plugin. (default: None)
javac_plugins = ...,	names of compiler plugins to use when compiling this target with javac. (default: None)
name = ...,
no_cache = ...,	(default: False)
platform = ...,	The name of the platform (defined under the jvm-platform subsystem) to use for compilation (that is, a key into the --jvm-platform-platforms dictionary). If unspecified, the platform will default to the first one of these that exist: (1) the default_platform specified for jvm-platform, (2) a platform constructed from whatever java version is returned by DistributionLocator.cached().version. (default: None)
plugin = ...,	The name of the plugin. Defaults to name if not supplied. (default: None)
provides = ...,	(default: None)
resources = ...,	An optional list of paths (DEPRECATED) or ``resources`` targets containing resources that belong on this library's classpath. (default: None)
scalac_plugin_args = ...,	Map from scalac plugin name to list of arguments for that plugin. (default: None)
scalac_plugins = ...,	names of compiler plugins to use when compiling this target with scalac. (default: None)
services = ...,	A dict mapping service interface names to the classes owned by this target that implement them. Keys are fully qualified service class names, values are lists of strings, each string the fully qualified class name of a class owned by this target that implements the service interface and should be discoverable by the jvm service provider discovery mechanism described here: https://docs.oracle.com/javase/6/docs/api/java/util/ServiceLoader.html (default: None)
sources = ...,	Source code files to build. Paths are relative to the BUILD file's directory. (default: None)
strict_deps = ...,	When True, only the directly declared deps of the target will be used at compilation time. This enforces that all direct deps of the target are declared, and can improve compilation speed due to smaller classpaths. Transitive deps are always provided at runtime. (default: None)
tags = ...,	(default: None)
zinc_file_manager = ...,	Whether to use zinc provided file manager that allows transactional rollbacks, but in certain cases may conflict with user libraries. (default: None)

target: A generic target used to group dependencies.
- dependencies = ..., (default: [])
  
  description = ..., (default: None)
  
  name = ...,
  
  no_cache = ..., (default: False)
  
  tags = ..., (default: None)

unpacked_jars: A set of sources extracted from JAR files.

:API: public

dependencies = ...,	(default: [])
description = ...,	(default: None)
exclude_patterns = ...,	fileset patterns to exclude from the archive. Exclude patterns are processed before include_patterns. (default: None)
include_patterns = ...,	fileset patterns to include from the archive (default: None)
intransitive = ...,	Whether to unpack all resolved dependencies of the jars, or just the jars themselves. (default: False)
libraries = ...,	addresses of jar_library targets that specify the jars you want to unpack (default: None)
name = ...,
no_cache = ...,	(default: False)
tags = ...,	(default: None)

Other BUILD Symbols

DirectoryReMapper: A mapper that maps files relative to a base directory into a destination directory.
- base = ..., the relative path to get_buildroot()
  
  dest = ..., the dest path in the bundle

Duplicate: A rule that indicates how duplicate entries should be handled when building a jar.

apply_pattern = ...,	A regular expression that matches duplicate jar entries this rule applies to.
action = ...,	An action to take to handle one or more duplicate entries. Must be one of: ``Duplicate.SKIP``, ``Duplicate.REPLACE``, ``Duplicate.CONCAT``, ``Duplicate.CONCAT_TEXT``, or ``Duplicate.FAIL``.

Skip: A rule that skips adding matched entries to a jar.
- apply_pattern = ...,
  
  payload = ..., (default: None)

Wiki: Identifies a wiki where pages can be published.
- name = ...,
  
  url_builder = ..., Function that accepts a page target and an optional wiki config dict.

artifact: Represents a publishable jvm artifact ala maven or ivy.

Used in the ``provides`` parameter to *jvm*\_library targets. :API: public

org = ...,	Organization of this artifact, or groupId in maven parlance.
name = ...,	Name of the artifact, or artifactId in maven parlance.
repo = ...,	The ``repo`` this artifact is published to.
publication_metadata = ...,	Optional extra publication metadata required by the ``repo``. (default: None)

buildfile_path: <Add description>

bundle: A set of files to include in an application bundle.

To learn about application bundles, see `bundles <JVMProjects.html#jvm-bundles>`_. Looking for Java-style resources accessible via the ``Class.getResource`` API? Those are `resources <build_dictionary.html#resources>`_. Files added to the bundle will be included when bundling an application target. By default relative paths are preserved. For example, to include ``config`` and ``scripts`` directories: :: bundles=[ bundle(fileset=[rglobs('config/*', 'scripts/*'), 'my.cfg']), ] To include files relative to some path component use the ``relative_to`` parameter. The following places the contents of ``common/config`` in a ``config`` directory in the bundle. :: bundles=[ bundle(relative_to='common', fileset=globs('common/config/*')) ]

rel_path = ...,	Base path of the "source" file paths. By default, path of the BUILD file. Useful for assets that don't live in the source code repo. (default: None)
mapper = ...,	Function that takes a path string and returns a path string. Takes a path in the source tree, returns a path to use in the resulting bundle. By default, an identity mapper. (default: None)
relative_to = ...,	Set up a simple mapping from source path to bundle path. (default: None)
fileset = ...,	The set of files to include in the bundle. A string filename, or list of filenames, or a Fileset object (e.g. globs()). E.g., ``relative_to='common'`` removes that prefix from all files in the application bundle. (default: None)

contrib_setup_py: Creates the setup_py for a pants contrib plugin artifact.

name = ...,	The name of the package; must start with 'pantsbuild.pants.contrib.'.
description = ...,	A brief description of what the plugin provides.
additional_classifiers = ...,	Any additional trove classifiers that apply to the plugin, see: https://pypi.python.org/pypi?%3Aaction=list_classifiers (default: None)
kwargs = ...,	Any additional keyword arguments to be passed to `setuptools.setup <https://pythonhosted.org/setuptools/setuptools.html>`_. (default: None)

developer: Corresponds to the maven POM <developer/> element.

Refer to the schema here: http://maven.apache.org/maven-v4_0_0.xsd

user_id = ...,	The user id of the developer; typically the one used to access the scm. (default: None)
name = ...,	The developer's full name. (default: None)
email = ...,	the developer's email address. (default: None)
url = ...,	An optional url pointing to more information about the developer. (default: None)
organization = ...,	An optional name for the organization the developer works on the library for. (default: None)
organization_url = ...,	An optional url pointing to more information about the developer's organization. (default: None)
roles = ...,	An optional list of role names that apply to this developer on this project. (default: None)

exclude: Represents a dependency exclude pattern to filter transitive dependencies against.
- org = ..., Organization of the artifact to filter, known as groupId in Maven parlance.
  
  name = ..., Name of the artifact to filter in the org, or filter everything if unspecified. (default: None)

get_buildroot: Returns the pants build root, calculating it if needed.

github: Creates an `Scm` for a github repo.
- user = ..., The github user or organization name the repo is hosted under.
  
  repo = ..., The repository name.

globs: Matches files in the BUILD file's directory.
- *patterns = ..., None

intransitive: Creates a dependency which is intransitive.
- address = ...,

jar: A pre-built Maven repository dependency.

Examples: # The typical use case. jar('com.puppycrawl.tools', 'checkstyle', '1.2') # Test external dependency locally. jar('org.foobar', 'foobar', '1.2-SNAPSHOT', url='file:///Users/pantsdev/workspace/project/jars/checkstyle/checkstyle.jar') # Test external dependency locally using relative path (with respect to the path # of the belonging BUILD file) jar('org.foobar', 'foobar', '1.2-SNAPSHOT', url='file:../checkstyle/checkstyle.jar')

org = ...,	The Maven ``groupId`` of this dependency.
name = ...,	The Maven ``artifactId`` of this dependency.
rev = ...,	The Maven ``version`` of this dependency. If unspecified the latest available version is used. (default: None)
force = ...,	Force this specific artifact revision even if other transitive dependencies specify a different revision. This requires specifying the ``rev`` parameter. (default: False)
ext = ...,	Extension of the artifact if different from the artifact type. This is sometimes needed for artifacts packaged with Maven bundle type but stored as jars. (default: None)
url = ...,	URL of this artifact, if different from the Maven repo standard location (specifying this parameter is unusual). Path of file URL can be either absolute or relative to the belonging BUILD file. (default: None)
apidocs = ...,	URL of existing javadocs, which if specified, pants-generated javadocs will properly hyperlink {\ @link}s. (default: None)
classifier = ...,	Classifier specifying the artifact variant to use. (default: None)
mutable = ...,	Inhibit caching of this mutable artifact. A common use is for Maven -SNAPSHOT style artifacts in an active development/integration cycle. (default: None)
intransitive = ...,	Declares this Dependency intransitive, indicating only the jar for the dependency itself should be downloaded and placed on the classpath (default: False)
excludes = ...,	Transitive dependencies of this jar to exclude. (default: None)

jar_rules: A set of rules for packaging up a deploy jar.

Deploy jars are executable jars with fully self-contained classpaths and as such, assembling them presents problems given jar semantics. One issue is signed jars that must be included on the classpath. These have a signature that depends on the jar contents and assembly of the deploy jar changes the content of the jar, breaking the signatures. For cases like these the signed jars must be verified and then the signature information thrown away. The `Skip <#Skip>`_ rule supports this sort of issue by allowing outright entry exclusion in the final deploy jar. Another issue is duplicate jar entries. Although the underlying zip format supports these, the java jar tool and libraries do not. As such some action must be taken for each duplicate entry such that there are no duplicates in the final deploy jar. The four `Duplicate <#Duplicate>`_ rules support resolution of these cases by allowing 1st wins, last wins, concatenation of the duplicate entry contents or raising an exception. :API: public

rules = ...,	One or more rules that will be applied in order to jar entries being packaged in a deploy jar. `Skip <#Skip>`_ rules can go here. (default: None)
default_dup_action = ...,	The default action to take when a duplicate entry is encountered and no explicit rules apply to the entry. (default: SKIP)

license: Corresponds to the maven POM <license/> element.
- name = ..., The full official name of the license.
  
  url = ..., An url pointing to the license text.
  
  comments = ..., Optional comments clarifying the license. (default: None)

managed_jar_libraries: Creates a managed_jar_dependencies(), and also generates a jar_library for each artifact.

Using this factory saves a lot of duplication. For example, this: :: managed_jar_libraries(name='managed', artifacts=[ jar('org.foobar', 'foobar', '1.2'), jar('com.example', 'example', '8'), ], ) Is equivalent to: :: managed_jar_dependencies(name='managed', artifacts=[ jar('org.foobar', 'foobar', '1.2'), jar('com.example', 'example', '8'), ], ) jar_library(name='org.foobar.foobar', jars=[jar('org.foobar', 'foobar')], managed_dependencies=':managed', ) jar_library(name='com.example.example', jars=[jar('com.example', 'example')], managed_dependencies=':managed', ) Which is also equivalent to: :: managed_jar_dependencies(name='managed', artifacts=[ ':org.foobar.foobar', ':com.example.example', ], ) jar_library(name='org.foobar.foobar', jars=[jar('org.foobar', 'foobar')], managed_dependencies=':managed', ) jar_library(name='com.example.example', jars=[jar('com.example', 'example')], managed_dependencies=':managed', )

name = ...,	The optional name of the generated managed_jar_dependencies() target. (default: None)
artifacts = ...,	List of `jar <#jar>`_\s or specs to jar_library targets with pinned versions. Versions are pinned per (org, name, classifier, ext) artifact coordinate (excludes, etc are ignored for the purposes of pinning). (default: None)

netrc: Fetches username and password from ~/.netrc for logged in user.

ossrh: Corresponds to the Sonatype required fields for jars published to OSSRH.

See: http://central.sonatype.org/pages/requirements.html#sufficient-metadata

description = ...,	A description of the library.
url = ...,	An url pointing to more information about the library.
licenses = ...,	The licenses that apply to the library.
developers = ...,	The developers who work on the library.
scm = ...,	The primary scm system hosting the library source code.
name = ...,	The optional full name of the library. If not supplied an appropriate name will be synthesized. (default: None)

pants_library: <Add description>
- description = ...,

pants_requirement: Exports a `python_requirement_library` pointing at the active pants' corresponding sdist.
- name = ..., The name to use for the target, defaults to the parent dir name. (default: None)

pants_setup_py: Creates the setup_py for a pants artifact.

name = ...,	The name of the package.
description = ...,	A brief description of what the package provides.
additional_classifiers = ...,	Any additional trove classifiers that apply to the package, see: https://pypi.python.org/pypi?%3Aaction=list_classifiers (default: None)
kwargs = ...,	Any additional keyword arguments to be passed to `setuptools.setup <https://pythonhosted.org/setuptools/setuptools.html>`_. (default: None)

pants_version: Returns the pants semantic version number as a string: http://semver.org/

provided: Creates an intransitive dependency with scope='compile test'.
- address = ...,

public: An artifact repository, such as a maven repo.

python_artifact: Represents a Python setup.py-based project.
- kwargs = ..., Passed to `setuptools.setup <https://pythonhosted.org/setuptools/setuptools.html>`_. (default: None)

python_requirement: Pants wrapper around pkg_resources.Requirement
- requirement = ...,
  
  name = ..., (default: None)
  
  repository = ..., (default: None)
  
  use_2to3 = ..., (default: False)
  
  compatibility = ..., (default: None)

python_requirements: Translates a pip requirements file into an equivalent set of python_requirements
- requirements_relpath = ..., The relpath from this BUILD file to the requirements file. Defaults to a `requirements.txt` file sibling to the BUILD file. (default: requirements.txt)

repository: An artifact repository, such as a maven repo.
- name = ..., (default: None)
  
  url = ..., Optional URL of the repository. (default: None)
  
  push_db_basedir = ..., Push history file base directory. (default: None)

rglobs: Matches files recursively under the BUILD file's directory.
- *patterns = ..., None

scala_artifact: Extends Artifact to append the configured Scala version.

:API: public

org = ...,	Organization of this artifact, or groupId in maven parlance.
name = ...,	Name of the artifact, or artifactId in maven parlance.
repo = ...,	The ``repo`` this artifact is published to.
publication_metadata = ...,	Optional extra publication metadata required by the ``repo``. (default: None)

scala_jar: A JarDependency with the configured 'scala-compile: platform-version' automatically appended.

This allows for more natural consumption of cross-published scala libraries, which have their scala version/platform appended to the artifact name.

org = ...,
name = ...,
rev = ...,	(default: None)
force = ...,	(default: False)
ext = ...,	(default: None)
url = ...,	(default: None)
apidocs = ...,	(default: None)
classifier = ...,	(default: None)
mutable = ...,	(default: None)
intransitive = ...,	(default: False)
excludes = ...,	(default: None)
base_path = ...,	base path that's relative to the build root. (default: None)

scm: Corresponds to the maven POM <scm/> element.

Refer to the schema here: http://maven.apache.org/maven-v4_0_0.xsd

connection = ...,	The scm connection string for read-only access to the scm.
developer_connection = ...,	The scm connection string for read-write access to the scm.
url = ...,	An url pointing to a browseable web interface for the scm.
tag = ...,	An optional tag corresponding to the published release. This will be populated by pants during publish runs. (default: None)

scoped: Creates a dependency with the given scope.
- address = ..., A target address.
  
  scope = ..., The scope of this dependency. (default: None)

setup_py: Represents a Python setup.py-based project.
- kwargs = ..., Passed to `setuptools.setup <https://pythonhosted.org/setuptools/setuptools.html>`_. (default: None)

shading_exclude: Creates a rule which excludes the given pattern from shading.

Examples: :: # Don't shade the org.foobar.example.Main class shading_exclude('org.foobar.example.Main') # Don't shade anything under org.foobar.example shading_exclude('org.foobar.example.**')

pattern = ...,

Any fully-qualified classname which matches this pattern will NOT be shaded. '*' is a wildcard that matches any individual package component, and '**' is a wildcard that matches any trailing pattern (ie the rest of the string).

shading_exclude_package: Convenience constructor for a package exclusion rule.

Essentially equivalent to just using ``shading_exclude('package_name.**')``.

package_name = ...,	Package name to exclude (eg, ``org.pantsbuild.example``).
recursive = ...,	Whether to exclude everything under any subpackage of ``package_name``, or just direct children of the package. (Defaults to True). (default: True)

shading_keep: Creates a rule which marks classes matching the given pattern as roots.

If any keep rules are set, all classes that are not reachable from roots are removed from the jar. Examples: :: # Only include classes reachable from Main. shading_keep('org.foobar.example.Main') # Only keep classes reachable from the example package. shading_keep('org.foobar.example.*')

pattern = ...,

Any fully-qualified classname which matches this pattern will be kept as a root. '*' is a wildcard that matches any individual package component, and '**' is a wildcard that matches any trailing pattern (ie the rest of the string).

shading_keep_package: Convenience constructor for a package keep rule.

Essentially equivalent to just using ``shading_keep('package_name.**')``.

package_name = ...,	Package name to keep (eg, ``org.pantsbuild.example``).
recursive = ...,	Whether to keep everything under any subpackage of ``package_name``, or just direct children of the package. (Defaults to True). (default: True)

shading_relocate: Creates a rule which shades jar entries from one pattern to another.

Examples: :: # Rename everything in the org.foobar.example package # to __shaded_by_pants__.org.foobar.example. shading_relocate('org.foobar.example.**') # Rename org.foobar.example.Main to __shaded_by_pants__.org.foobar.example.Main shading_relocate('org.foobar.example.Main') # Rename org.foobar.example.Main to org.foobar.example.NotMain shading_relocate('org.foobar.example.Main', 'org.foobar.example.NotMain') # Rename all 'Main' classes under any direct subpackage of org.foobar. shading_relocate('org.foobar.*.Main') # Rename org.foobar package to com.barfoo package shading_relocate('org.foobar.**', 'com.barfoo.@1') # Rename everything in org.foobar.example package to __hello__.org.foobar.example shading_relocate('org.foobar.example.**', shade_prefix='__hello__')

from_pattern = ...,	Any fully-qualified classname which matches this pattern will be shaded. '' is a wildcard that matches any individual package component, and '*' is a wildcard that matches any trailing pattern (ie the rest of the string).
shade_pattern = ...,	The shaded pattern to use, where ``@1``, ``@2``, ``@3``, etc are references to the groups matched by wildcards (groups are numbered from left to right). If omitted, this pattern is inferred from the input pattern, prefixed by the ``shade_prefix`` (if provided). (Eg, a ``from_pattern`` of ``com..foo.bar.*`` implies a default ``shade_pattern`` of ``__shaded_by_pants__.com.@1.foo.@2``) (default: None)
shade_prefix = ...,	Prefix to prepend when generating a ``shade_pattern`` (if a ``shade_pattern`` is not provided by the user). Defaults to '``__shaded_by_pants__.``'. (default: None)

shading_relocate_package: Convenience constructor for a package relocation rule.

Essentially equivalent to just using ``shading_relocate('package_name.**')``.

package_name = ...,	Package name to shade (eg, ``org.pantsbuild.example``).
shade_prefix = ...,	Optional prefix to apply to the package. Defaults to ``__shaded_by_pants__.``. (default: None)
recursive = ...,	Whether to rename everything under any subpackage of ``package_name``, or just direct children of the package. (Defaults to True). (default: True)

shading_zap: Creates a rule which removes matching classes from the jar.

Examples: :: # Remove the main class. shading_zap('org.foobar.example.Main') # Remove everything in the example package. shading_keep('org.foobar.example.*')

pattern = ...,

Any fully-qualified classname which matches this pattern will removed from the jar. '*' is a wildcard that matches any individual package component, and '**' is a wildcard that matches any trailing pattern (ie the rest of the string).

shading_zap_package: Convenience constructor for a package zap rule.

Essentially equivalent to just using ``shading_zap('package_name.**')``.

package_name = ...,	Package name to remove (eg, ``org.pantsbuild.example``).
recursive = ...,	Whether to remove everything under any subpackage of ``package_name``, or just direct children of the package. (Defaults to True). (default: True)

testing: An artifact repository, such as a maven repo.

wiki_artifact: Binds a single documentation page to a wiki instance.

This object allows you to specify which wiki a page should be published to, along with additional wiki-specific parameters, such as the title, parent page, etc.

wiki = ...,	target spec of a ``wiki``.
kwargs = ...,	a dictionary that may contain configuration directives for your particular wiki. For example, the following keys are supported for Atlassian's Confluence: * ``space`` -- A wiki space in which to place the page (used in Confluence) * ``title`` -- A title for the wiki page * ``parent`` -- The title of a wiki page that will denote this page as a child. (default: None)

zglobs: Matches files in the BUILD file's dir using zsh-style globs, including ``**/`` to recurse.
- *patterns = ..., None

Generated by publish_docs from dist/reference/build_dictionary_body.html 2018-05-03T17:02:30.712832

base = ...,	the relative path to get_buildroot()
dest = ...,	the dest path in the bundle

name = ...,
url_builder = ...,	Function that accepts a page target and an optional wiki config dict.

org = ...,	Organization of the artifact to filter, known as groupId in Maven parlance.
name = ...,	Name of the artifact to filter in the org, or filter everything if unspecified. (default: None)

user = ...,	The github user or organization name the repo is hosted under.
repo = ...,	The repository name.

name = ...,	The full official name of the license.
url = ...,	An url pointing to the license text.
comments = ...,	Optional comments clarifying the license. (default: None)

requirement = ...,
name = ...,	(default: None)
repository = ...,	(default: None)
use_2to3 = ...,	(default: False)
compatibility = ...,	(default: None)

address = ...,	A target address.
scope = ...,	The scope of this dependency. (default: None)