com.facebook.buck.core.macros

Class MacroFinder

java.lang.Object

com.facebook.buck.core.macros.MacroFinder

public final class MacroFinder
extends Object

Replace and extracts macros from input strings.

Examples: $(exe //foo:bar) $(location :bar) $(platform)

Method Summary

Modifier and Type	Method and Description
static com.google.common.collect.ImmutableList<MacroMatchResult>	findAll(com.google.common.collect.ImmutableSet<String> macros, String blob)
static Optional<MacroMatchResult>	match(com.google.common.collect.ImmutableSet<String> macros, String blob)
static <T> T	replace(com.google.common.collect.ImmutableMap<String,MacroReplacer<T>> replacers, String blob, boolean resolveEscaping, MacroCombiner<T> combiner) Expand macros embedded in a string.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

match

public static Optional<MacroMatchResult> match(com.google.common.collect.ImmutableSet<String> macros,
                                               String blob)
                                        throws MacroException

Throws:

MacroException

replace

public static <T> T replace(com.google.common.collect.ImmutableMap<String,MacroReplacer<T>> replacers,
                            String blob,
                            boolean resolveEscaping,
                            MacroCombiner<T> combiner)
                     throws MacroException

Expand macros embedded in a string.

Parameters:

replacers - a map of macro names to MacroReplacer objects used to expand them.

blob - the input string containing macros to be expanded

resolveEscaping - whether to drop characters used to escape literal uses of `$(...)`

Returns:

a copy of the input string with all macros expanded

Throws:

MacroException

findAll

public static com.google.common.collect.ImmutableList<MacroMatchResult> findAll(com.google.common.collect.ImmutableSet<String> macros,
                                                                                String blob)
                                                                         throws MacroException

Throws:

MacroException