jurand - Man Page

remove dependency declarations or annotations from Java source files

Synopsis

jurand [-i] [-s] [-a] [-n <name>] [-p|-m <pattern>] [<paths>...]

Description

This tool removes annotations, corresponding import statements and modular requires statements from Java source files.

The tool can be used for patching Java sources in cases where using sed is insufficient due to Java language syntax. It follows Java language rules rather than applying simple regular expressions on the source code.

The tool matches all non-whitespace content following the 'import [static]' statement against all patterns provided via the -p flag and all simple class names against names provided by the -n flag.

In module-info.java files, all content following 'requires [static] [transitive]' is matched against all patterns provided via the -m flag.

File path arguments are handled the following way:

Symlinks are ignored.
Regular files are handled regardless of the file name.
Directories are traversed recursively and all .java files are handled.
Files named module-info.java are handled specifically.

Arguments can be specified in arbitrary order.

Options

*-n <name>: Simple (not fully-qualified) class name.
*-p <pattern>: Regex pattern to match names used in code.
*-m <pattern>: Regex pattern to match module name requires fields used in module-info.java files.
-a: Also remove annotations used in code.
-i, --in-place: Replace the contents of files.
-s, --strict: Fail if any of the specified options was redundant and no changes associated with the option were made. This option is only applicable together with -i.

Examples

Examples of usage in a .spec file:

jurand -i -s -a module-api module-impl module-tests -n Nullable
jurand -i -s -a src -p org[.]jspecify[.]annotations -m org[.]jspecify

Import patterns

Import statements present in Java source file:

1) import java.lang.Runnable;
2) import java.util.List;
3) import static java.util.*;
4) import static java.lang.String.valueOf;
5) import com.google.common.util.concurrent.Service;

Names used to match:

Name 'Runnable' matches 1)
Name 'String' matches 4)

Name 'util' does not match anything.
Name '*' does not match anything.
Name 'valueOf' does not match anything.

Patterns used to match:

Pattern 'Runnable' matches 1).
Pattern '[*]' matches 3).
Pattern 'java[.]util' matches 2), 3).
Pattern 'util' matches 2), 3), 5).
Patterns 'java', 'java.*' match 1) - 4).

Pattern 'static' does not match anything.

Annotations

Annotations present in Java source file:

1) @SuppressWarnings
2) @SuppressFBWarnings(value = {"EI_EXPOSE_REP", "EI_EXPOSE_REP2"})
3) @org.junit.Test
4) @org.junit.jupiter.api.Test