Skip to content

Contract tests: use gephi-plugins-tests 1.2.0 and report its warnings - #374

Merged
mbastian merged 1 commit into
gephi-0.11.4from
contract-warnings
Nov 8, 2026
Merged

mbastian merged 1 commit into
gephi-0.11.4from
contract-warnings

Conversation

@mbastian

@mbastian mbastian commented Nov 8, 2026

Copy link
Copy Markdown
Member

Stacked on #354 (base is its branch gephi-0.11.4).

gephi-plugins-tests 1.2.0 (on Central) has advisory checks: findings about a plugin that works but does something reviewers should know about (a layout adding nodes or edges, an existing column of another type, a report that changes when saved and reloaded, a statistics without a user interface). They no longer fail the run, they're written to a file by the tests.

  • pom.xml: gephi-plugins-tests.version 1.1.0 → 1.2.0, and the gephi.plugins.tests.warnings system property pointing at target/contract-warnings.tsv.
  • run.sh reads that file after each plugin, prints each warning as a ::warning:: annotation, and on GitHub Actions appends a table to the job summary. Plugin names and messages come from the plugin's code, so they are escaped for the annotation and the markdown.
  • run.sh puts the jars of the modules that depend on the tested one on the test classpath (maven.test.additionalClasspath). A plugin split in modules keeps its user interface in a module that depends on the main one (BoundingDiameters → BoundingDiametersUI), and the tests look the UI up.
  • AGENTS.md: one line about the warnings.

Needs Gephi 0.11.4 as the root gephi.version: the tests use GraphLock methods that graphstore only has since 0.8.11. That is #373 for master-forge (master is already on 0.11.4).

Verified locally on a master-forge checkout at 0.11.4 with the real plugins: BoundingDiameters, BoundingDiametersUI, HairballBuster and LinkPrediction pass; the warnings show up as annotations and as a table in the summary; BoundingDiameters finds its UI, with no "has no StatisticsUI" warning.

🤖 Generated with Claude Code

Checks that only warn (a layout adding nodes, a statistics without a user interface...) don't fail the run: run.sh turns the warnings the tests write to contract-warnings.tsv into ::warning:: annotations and, on GitHub Actions, a table in the job summary. The jars of the modules that depend on the tested one are put on the test classpath, so a plugin whose user interface is in another module (e.g. BoundingDiameters) has it found.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@mbastian
mbastian merged commit c69241e into gephi-0.11.4 Nov 8, 2026
1 check passed
mbastian added a commit that referenced this pull request Nov 8, 2026
Checks that only warn (a layout adding nodes, a statistics without a user interface...) don't fail the run: run.sh turns the warnings the tests write to contract-warnings.tsv into ::warning:: annotations and, on GitHub Actions, a table in the job summary. The jars of the modules that depend on the tested one are put on the test classpath, so a plugin whose user interface is in another module (e.g. BoundingDiameters) has it found.

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>
mbastian added a commit that referenced this pull request Nov 8, 2026
* Upgrade to Gephi 0.11.4 and gephi-maven-plugin 1.4.1 (#355)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* Run gephi-plugins-tests SPI contract tests in CI (#354)

* Upgrade to Gephi 0.11.4 and gephi-maven-plugin 1.4.1

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Run gephi-plugins-tests SPI contract tests in CI

Adds a standalone harness (.github/contract-tests) that runs gephi-plugins-tests' contract tests against installed plugin modules, without plugins or gephi-plugin-parent having to declare anything. build.yml tests every module of the branch, pr.yml (moved here from master-forge) tests the modules a master-forge PR changes, and test-generation.yml checks the harness still resolves for the current gephi.version.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Pin Surefire 3.6.1 in the contract-test harness and keep docs SPI-agnostic

gephi-plugins-tests will cover more SPIs than layouts, so the docs describe the contract tests generically instead of naming LayoutContractTest.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Harden the SPI contract-test harness

- pr.yml tests every module when the root pom.xml or the harness changes, and passes changed folders as a quoted array (no word splitting, no path quoting)
- run.sh fails loudly when listing the reactor fails or gephi.version can't be read, warns about folders that aren't reactor modules, refuses to test a module that isn't installed or was rebuilt since its install, and fails if no contract test class ran at all
- the harness only tests implementations from the plugin's own jar (gephi.plugins.tests.jar, honored by gephi-plugins-tests 1.1.0) and runs headless with the module access Gephi's launcher grants
- test-generation.yml adds a positive control against core layout-plugin so a harness that silently tests nothing fails
- build.yml skips the contract-test step on branches without plugin modules

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Use gephi-plugins-tests 1.1.0 in the contract-test harness

1.1.0 only tests the implementations from the plugin's own jar (the
harness already passes gephi.plugins.tests.jar), and adds the Statistics
and Layout lifecycle contract tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* Use gephi-plugins-tests 1.2.0 and report its warnings (#374) (#375)

Checks that only warn (a layout adding nodes, a statistics without a user interface...) don't fail the run: run.sh turns the warnings the tests write to contract-warnings.tsv into ::warning:: annotations and, on GitHub Actions, a table in the job summary. The jars of the modules that depend on the tested one are put on the test classpath, so a plugin whose user interface is in another module (e.g. BoundingDiameters) has it found.

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
mbastian added a commit that referenced this pull request Nov 8, 2026
* Add Gephi AI plugin 1.3.3

* Update Gephi AI plugin to 1.5.0

Requires Gephi 0.11.3. Appearance, layout, screenshot and PNG/PDF export go
through Gephi's controllers and exporters. The JDK HTTP server replaces
NanoHTTPD. PDFs are US Letter. 160 tests.

* Report the running Gephi's version in /health

* Update Gephi AI plugin to 1.5.1

Writes no longer pause the renderer; measured on Gephi 0.11.3 the pause
made no difference. The busy message names a running statistic rather
than the renderer. Source reformatted to Gephi core's checkstyle, with
SourceRulesTest for lock release, live iterators and the interface
thread. README states the Gephi 0.11.3 requirement. 170 tests.

* Keep the Gephi AI unit tests off port 8080 and headless

NetBeans runs the module's installer inside the test JVM, which started
the API server on 8080. With a Gephi on the same machine holding that
port, the bind failure opened an error dialog mid-run. Surefire now sets
java.awt.headless=true and gephi.mcp.port=0, pinned by TestEnvironmentTest.
172 tests.

* Gephi AI: one run per statistic, filters select under the lock, log failures

A second request for a statistic already running is refused. The degree
and edge-weight filters choose what to remove after taking the write lock.
Requests that fail with an exception log the stack trace. 181 tests.

* Update Gephi AI plugin to 1.5.2

Statistics no longer hang when the Statistics window has not set up the
workspace; the column and new-workspace filter actions do what they report;
node ids work after importing integer ids; preview settings report unknown
and unapplied names; GML and Pajek export work; regex columns warn when
nothing matches. Adds API routing and workspace tool tests (296 in all),
with io-exporter-plugin and preview-plugin as test dependencies.

* Upgrade to Gephi 0.11.4 and gephi-maven-plugin 1.4.1 (#355)

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* Use gephi-plugin-parent 0.11.4 for Gephi AI

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Require Gephi 0.11.4 in Gephi AI README

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

* Update Gephi AI to 1.6.1

* Run gephi-plugins-tests SPI contract tests in CI (#354)

* Upgrade to Gephi 0.11.4 and gephi-maven-plugin 1.4.1

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Run gephi-plugins-tests SPI contract tests in CI

Adds a standalone harness (.github/contract-tests) that runs gephi-plugins-tests' contract tests against installed plugin modules, without plugins or gephi-plugin-parent having to declare anything. build.yml tests every module of the branch, pr.yml (moved here from master-forge) tests the modules a master-forge PR changes, and test-generation.yml checks the harness still resolves for the current gephi.version.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Pin Surefire 3.6.1 in the contract-test harness and keep docs SPI-agnostic

gephi-plugins-tests will cover more SPIs than layouts, so the docs describe the contract tests generically instead of naming LayoutContractTest.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Harden the SPI contract-test harness

- pr.yml tests every module when the root pom.xml or the harness changes, and passes changed folders as a quoted array (no word splitting, no path quoting)
- run.sh fails loudly when listing the reactor fails or gephi.version can't be read, warns about folders that aren't reactor modules, refuses to test a module that isn't installed or was rebuilt since its install, and fails if no contract test class ran at all
- the harness only tests implementations from the plugin's own jar (gephi.plugins.tests.jar, honored by gephi-plugins-tests 1.1.0) and runs headless with the module access Gephi's launcher grants
- test-generation.yml adds a positive control against core layout-plugin so a harness that silently tests nothing fails
- build.yml skips the contract-test step on branches without plugin modules

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Use gephi-plugins-tests 1.1.0 in the contract-test harness

1.1.0 only tests the implementations from the plugin's own jar (the
harness already passes gephi.plugins.tests.jar), and adds the Statistics
and Layout lifecycle contract tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>

* Use gephi-plugins-tests 1.2.0 and report its warnings (#374) (#375)

Checks that only warn (a layout adding nodes, a statistics without a user interface...) don't fail the run: run.sh turns the warnings the tests write to contract-warnings.tsv into ::warning:: annotations and, on GitHub Actions, a table in the job summary. The jars of the modules that depend on the tested one are put on the test classpath, so a plugin whose user interface is in another module (e.g. BoundingDiameters) has it found.

Co-authored-by: Claude Sonnet 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Mathieu Bastian <mathieu.bastian@gmail.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant