{* ../../docs_src/metadata/tutorial004_py39.py hl[3:16,18] *}

Notice that you can use Markdown inside of the descriptions, for example "login" will be shown in bold (**login**) and "fancy" will be shown in italics (_fancy_).

/// tip

You don't have to add metadata for all the tags that you use.

///

### Use your tags { #use-your-tags }

/**
 * Implementation of {@link ShellOptions} (base + shell).
 */
public class CommonsCliShellOptions extends CommonsCliOptions implements ShellOptions {
    public static CommonsCliShellOptions parse(String[] args) throws ParseException {
        CLIManager cliManager = new CLIManager();
        return new CommonsCliShellOptions(Options.SOURCE_CLI, cliManager, cliManager.parse(args));
    }

    }

    @Nested
    @DisplayName("Execution")
    class ExecutionTests {

        @Test
        @DisplayName("should log appropriate header message")
        void shouldLogAppropriateHeaderMessage() throws Exception {
            UpgradeContext context = createMockContext();

            // Create a temporary directory with a POM file for the test
            Path tempDir = Files.createTempDirectory("apply-test");

        }
    }

    /**
     * Parse jvm.config file and return formatted arguments.
     * Package-private for testing.
     */
    static String parseJvmConfig(Path jvmConfigPath, String mavenProjectBasedir) throws IOException {
        StringBuilder result = new StringBuilder();

        for (String line : Files.readAllLines(jvmConfigPath, StandardCharsets.UTF_8)) {
            line = processLine(line, mavenProjectBasedir);

        Objects.requireNonNull(extensionRealm, "extensionRealm cannot be null");

        if (cache.containsKey(key)) {
            throw new IllegalStateException("Duplicate extension realm for extension " + key);
        }

        CacheRecord record = new CacheRecord(extensionRealm, extensionDescriptor, artifacts);

        cache.put(key, record);

    protected Options parseCliOptions(LocalContext context) {
        try {
            return CommonsCliEncryptOptions.parse(context.parserRequest.args().toArray(new String[0]));
        } catch (ParseException e) {
            throw new IllegalArgumentException("Failed to parse command line options: " + e.getMessage(), e);
        }
    }

     *
     * @param <T> the type of the model object
     * @param object the model object to process
     * @return the processed object (may be the same instance, a pooled instance, or a modified instance)
     * @throws IllegalArgumentException if the object cannot be processed
     */
    <T> T process(T object);

    /**
     * Process a model object using the first available processor implementation.
     *

    /**
     * Package name can end with '.**' to exclude subpackages as well.
     */
    @Input
    public abstract SetProperty<String> getExcludedPackages();

    @TaskAction
    public void generate() throws IOException {
        final Set<String> packages = new LinkedHashSet<>();

    public Decrypt(MessageBuilderFactory messageBuilderFactory, SecDispatcher secDispatcher) {
        super(messageBuilderFactory, secDispatcher);
    }

    @Override
    protected int doExecute(EncryptContext context) throws Exception {
        String encrypted = context.reader.readLine("Enter the password to decrypt: ");
        if (secDispatcher.isAnyEncryptedString(encrypted)) {

     * @return The {@link Artifact} to relocate to, or {@code null} if no relocation wanted.
     */
    Artifact relocatedTarget(RepositorySystemSession session, ArtifactDescriptorResult result, Model model)
            throws ArtifactDescriptorException;