explaingit

fieldju/token-macro-plugin

Analysis updated 2026-07-17 · repo last pushed 2015-11-18

JavaAudience · developerComplexity · 3/5DormantSetup · moderate

TLDR

A Jenkins plugin that lets other plugins swap placeholder text like {JOB_NAME} or {BUILD_NUMBER} for real values in job configs, notifications, and file paths.

Mindmap

mindmap
  root((repo))
    What it does
      Token replacement
      Shared plugin service
      Placeholder substitution
    Tech stack
      Java
      Jenkins
    Use cases
      Dynamic filenames
      Email notifications
      Build URLs
    Audience
      Jenkins admins
      Plugin developers
    Notable
      Brief README
      Links to Jenkins wiki

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Insert job name or build number into email notification templates.

USE CASE 2

Generate dynamic artifact filenames using build tokens.

USE CASE 3

Build plugin-specific templating features without writing custom substitution logic.

USE CASE 4

Construct URLs that reference git commit IDs or other job metadata.

What is it built with?

JavaJenkins

How does it compare?

fieldju/token-macro-pluginabhishek-kumar09/configurateabhishek-kumar09/orekit
LanguageJavaJavaJava
Last pushed2015-11-182020-09-302020-11-15
MaintenanceDormantDormantDormant
Setup difficultymoderateeasymoderate
Complexity3/52/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires a working Jenkins instance and familiarity with plugin dependencies.

Copy-paste prompts

Prompt 1
Show me how to use the Token Macro Plugin to insert {BUILD_NUMBER} into a Jenkins email notification.
Prompt 2
Write a Jenkins plugin that depends on Token Macro to support custom tokens.
Prompt 3
Explain how to register a new token type with the Token Macro Plugin.
Prompt 4
Help me use Token Macro to generate a dynamic artifact path with the git commit ID.

Frequently asked questions

What is token-macro-plugin?

A Jenkins plugin that lets other plugins swap placeholder text like {JOB_NAME} or {BUILD_NUMBER} for real values in job configs, notifications, and file paths.

What language is token-macro-plugin written in?

Mainly Java. The stack also includes Java, Jenkins.

Is token-macro-plugin actively maintained?

Dormant — no commits in 2+ years (last push 2015-11-18).

How hard is token-macro-plugin to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is token-macro-plugin for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.

Alternatives & similar repos