Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 10 additions & 4 deletions .github/workflows/gradle-wrapper-validation.yml
Original file line number Diff line number Diff line change
@@ -1,10 +1,16 @@
name: "Validate Gradle Wrapper"
on: [ push, pull_request ]
on:
push:
branches: [master]
pull_request:

permissions:
contents: read

jobs:
validation:
name: "Validation"
runs-on: ubuntu-latest
runs-on: ubuntu-24.04
steps:
- uses: actions/checkout@v2
- uses: gradle/wrapper-validation-action@v1
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
- uses: gradle/actions/wrapper-validation@9c971963bec38e04b3d30dcc455b5382be2fdbfb # v6.3.0
25 changes: 15 additions & 10 deletions .github/workflows/gradle.yml
Original file line number Diff line number Diff line change
@@ -1,19 +1,24 @@
name: Main

on: [ push, pull_request ]
on:
push:
branches: [master]
pull_request:

permissions:
contents: read

jobs:
build:

runs-on: ubuntu-latest
runs-on: ubuntu-24.04

steps:
- uses: actions/checkout@v1
- name: Set up JDK 1.11
uses: actions/setup-java@v1
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
- name: Set up JDK 21
uses: actions/setup-java@de7274f081f381c8f8158605e0321c36c376e2e6 # v6.0.1
with:
java-version: 1.11
- name: Test
run: ./gradlew test
- name: Build with Gradle
run: ./gradlew buildPlugin
distribution: corretto
java-version: 21
- name: Test, build and verify compatibility
run: xvfb-run -a ./gradlew test build buildPlugin verifyPlugin
5 changes: 5 additions & 0 deletions AGENTS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Development

Use the globally installed `develop-intellij-plugin` skill for every development task.
Read `docs/workflow.md` for repository configuration. Retrieve operational state through the shared skill.
`CHANGES.md` records release history; this repository contains no local task queue.
7 changes: 7 additions & 0 deletions CHANGES.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
## 2026.0 (Unreleased)

* Double-clicking a mapping category leaves its mappings unchanged instead of crashing the settings page.
* Custom mapping values and categories survive saving and loading IDE settings.
* JSON exports retain the plugin version on newer IDEs without using obsolete plugin lookup APIs.
* Source builds use updated build tooling and the latest PyCharm 2025.1 maintenance SDK, including upstream security fixes. Installed IDEs must still receive their own JetBrains updates.

## 2025.2 (September 05, 2025)

* Update dependencies
Expand Down
5 changes: 5 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Development

Use the globally installed `develop-intellij-plugin` skill for every development task.
Read `docs/workflow.md` for repository configuration. Retrieve operational state through the shared skill.
`CHANGES.md` records release history; this repository contains no local task queue.
2 changes: 2 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Prettify Python Plugin

The source branch prepares 2026.0; Marketplace currently provides 2025.2. IDE 2024.3 and later remain supported.

[![JetBrains IntelliJ Plugins](https://img.shields.io/jetbrains/plugin/r/stars/12017?label=JetBrans%20Marketplace)](https://plugins.jetbrains.com/plugin/12017)
[![JetBrains IntelliJ plugins](https://img.shields.io/jetbrains/plugin/d/12017)](https://plugins.jetbrains.com/plugin/12017)
[![Twitter Follow](https://img.shields.io/twitter/follow/meanmaildev?style=plastic)](https://twitter.com/meanmaildev)
Expand Down
19 changes: 18 additions & 1 deletion build.gradle.kts
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,7 @@ repositories {

intellijPlatform {
defaultRepositories()
jetbrainsRuntime()
}
}

Expand All @@ -27,7 +28,10 @@ dependencies {
testImplementation(libs.junit)

intellijPlatform {
create(config("platformType"), config("platformVersion"))
create(config("platformType"), config("platformVersion")) {
useInstaller = false
}
jetbrainsRuntime()
val plugins = providers.gradleProperty("plugins").map { it.split(',') }
if (plugins.isPresent && plugins.get().isNotEmpty()) {
plugins(plugins)
Expand Down Expand Up @@ -57,6 +61,9 @@ intellijPlatform {
buildSearchableOptions = false

pluginVerification.ides {
create("PC", "2024.3.6.1") {
useInstaller = false
}
recommended()
}

Expand Down Expand Up @@ -119,8 +126,18 @@ tasks {
gradleVersion = config("gradleVersion")
}

processResources {
val resourcePluginVersion = project.version.toString()
inputs.property("pluginVersion", resourcePluginVersion)
filesMatching("prettify-python-version.txt") {
expand("pluginVersion" to resourcePluginVersion)
}
}

test {
useJUnit()
systemProperty("java.awt.headless", "false")
testLogging.exceptionFormat = org.gradle.api.tasks.testing.logging.TestExceptionFormat.FULL

maxHeapSize = "1G"
}
Expand Down
34 changes: 34 additions & 0 deletions docs/dependencies-2026-11.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# November 2026 dependency maintenance

| Input | Previous | Selected | Decision |
| --- | --- | --- | --- |
| Gradle Wrapper | 9.0.0 | 9.8.2 | Apply supported Gradle 9 fixes, including worker/daemon deserialization, repository TLS handling, dependency resolution and dependency-alignment reporting fixes. Preserve JVM 21 and configuration-cache settings. |
| IntelliJ Platform Gradle plugin | 2.9.0 | 2.19.0 | Apply current test/classpath, IDE resolution and verifier fixes. In particular, newer plugin versions correctly map Community verification targets to unified PyCharm for 2025.3+. |
| Compilation SDK | PC 2025.1 | PC 2025.1.6.2 | Apply the latest published maintenance release in the existing SDK branch. JetBrains' release metadata includes CVE-2026-59792. This SDK is used for source builds, not shipped as an IDE update. |
| Kotlin | 2.0.21 | 2.0.21 | Preserve the IDE 2024.3 Kotlin runtime boundary rather than unconditionally selecting a newer compiler. |
| kotlinx.serialization | 1.8.1 | 1.8.1 | Preserve the existing JSON format/runtime input during the category-editing repair; a newer runtime must first satisfy the IDE floor. |
| JUnit | 4.13.2 | 4.13.2 | Retain the current JUnit 4 release used by IDE fixtures. |
| actions/checkout | v1 / v2 | v7, immutable SHA | Apply current supported action runtime and authentication handling. |
| actions/setup-java | v1 | v6.0.1, immutable SHA | Apply current action runtime and explicitly select JDK 21, matching the existing JVM target. |
| Wrapper validation | legacy v1 action | gradle/actions v6.3.0, immutable SHA | Apply the maintained validation action. |

The IntelliJ Gradle 2.14 defaults do not change this project's explicit minimum IDE build or verifier
configuration. Its optional signing/publishing environment defaults do not authorize those tasks;
the workflows execute neither. The 2.19 classpath exclusions and per-IDE verifier runtimes are
accepted; explicit Java/Kotlin bytecode targets remain 21. No removed `setupDependencies` task,
GrammarKit generator, native variant or subscription-key feature is used here.

Newer Kotlin and serialization release lines are excluded from this bounded maintenance because
the plugin retains its IDE 2024.3 floor. No new paid feature, user-project dependency or JSON migration
is introduced. The build-only security fixes do not repair vulnerabilities in a user's installed IDE.

The 2025.1.6.2 Community SDK is resolved from the official multi-OS Maven archive with its matching JBR.
The installer resolver could not select this four-component maintenance version even though its official
download and Maven artifact exist. This changes artifact resolution, not the platform version or IDE floor.

Sources: [Gradle 9.8.2 notes](https://docs.gradle.org/9.8.2/release-notes.html),
[Gradle 9 migration guide](https://docs.gradle.org/current/userguide/upgrading_version_9.html),
[IntelliJ Gradle release history](https://github.com/JetBrains/intellij-platform-gradle-plugin/releases),
[PyCharm 2025.1.6.2 notes](https://youtrack.jetbrains.com/articles/PY-A-233538593/PyCharm-2025.1.6.2-251.29188.66-build-Release-Notes),
[JetBrains release metadata](https://data.services.jetbrains.com/products/releases?code=PCC&latest=false&type=release),
[IDE Kotlin requirements](https://plugins.jetbrains.com/docs/intellij/using-kotlin.html).
69 changes: 69 additions & 0 deletions docs/workflow.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
# Workflow configuration

The globally installed `develop-intellij-plugin` skill defines the development process.

## Project

- Prettify Python, a Free Python symbol-folding plugin with configurable mappings.
- Repository: `meanmail-dev/prettify-python-plugin`; authoritative ref: `origin/master`.
- Release authority: `https://plugins.jetbrains.com/plugins/list?pluginId=ru.meanmail.plugins.prettify-python`.
- Product history and notes: `CHANGES.md`; descriptions: `README.md` and `description.html`.
- Version syntax: year.minor; next major after published `2025.2` is `2026.0`.
Update `gradle.properties` and add a top unreleased `CHANGES.md` section for a behavior change.
No paid product descriptor or release date field is configured.
- External portfolio registration: Not configured. Local task queue and roadmap: Not configured.

## Verification

- CI-required: `xvfb-run -a ./gradlew test build buildPlugin verifyPlugin` on GitHub-hosted Ubuntu 24.04,
using JDK 21. Gradle resolves dependencies before executing the gate. This repository is public;
the organization's private runners intentionally do not accept public repositories.
Swing settings tests use a virtual display; the test JVM explicitly disables headless mode.
- CI-required: Gradle Wrapper validation in `gradle-wrapper-validation.yml`.
- Local-diagnostic dependency resolution: `./gradlew dependencies` before a focused local Gradle check.
- Local-diagnostic focused test: `./gradlew test --tests "dev.meanmail.prettifypython.settings.PrettifySettingsComponentTest"`.
- Local-required: `git diff --check`, changed XML parsing, official wrapper distribution/JAR checksum checks.
- Local-required native package: `./gradlew buildPlugin` when CI has no retained distribution.
Use the configured PyCharm 2025.1.6.2 SDK and JDK 21; newer SDKs can require a newer Kotlin compiler.
Record the native package hash. A locally built artifact is not the CI binary.
With a previously running Kotlin daemon on JDK 25, use JDK 21 and
`-Pkotlin.compiler.execution.strategy=in-process` for package preparation.
- The verifier explicitly covers the IDE 243 floor (PC 2024.3.6.1) in addition to recommended current IDEs.
- Separate lint/typecheck commands and generated sources: Not configured.
- Never run `gradlew clean` without the owner's permission.

## Native Remote Development

- Owner: Local-required through the shared `ide-test-mcp` installation. A reviewed isolated installation
of the same implementation can qualify a required adapter while preserving a dirty local checkout.
- Runtime: unmodified IDEA 2025.3.6, build 253.33813.25, bundled JBR 21, macOS arm64;
the controller itself uses the installed JDK 25 and its matching 253 Driver/agent.
- Official PythonCore 253.33813.55 belongs on the backend; Python for JetBrains Client
253.30387.20 (`com.intellij.python.frontend`) belongs on the frontend.
- Product placement: backend. Use isolated localhost monolith/split fixtures with 1024 MiB heaps.
- Fixture: a synthetic Python file with foldable operators and a separate ordinary text file.
Verify native settings category editing, individual mapping editing/cancellation, mapping persistence,
useful folding, repeat use, exact source Save/Undo/Redo, close/reopen and same-client reconnect.
- On macOS IDE 253, open the native Settings menu entry and observe the `Settings` dialog. Locate the
Prettify Python page through its search field. Use `tree_activate` for category double-clicks; individual
mappings can be selected and opened with the actual Edit toolbar button. The runner's `open_dialog`
tree selector sends one click. Confirm applied values in the owned settings XML as well as the UI.
- These Swing tree controls belong to the monolithic UI. The 253 split frontend mirrors the page through
a Lux panel: use an observed `lux_render` image and its fresh one-use token for `lux_click`, and the
Lux `open_dialog` selector for Edit Mapping. Verify the visible remote dialog and cancellation;
backend semantic clicks alone do not establish frontend pointer forwarding.
- Compare the absent-product ordinary-editor control. Warm up for 60 seconds and sample each JVM for
30 seconds; CPU below 20% of one core, backend/monolith RSS below 4 GiB, frontend below 2 GiB.
- Require at least 4 GiB free before package preparation/launch. Retain package hashes, scoped logs,
native operation results and resource observations in the private task evidence.

## Publication and invariants

- Candidate branches may be pushed for approved work. Publish reviewed exact-head-green changes through a PR
into `master`, assigned to the owner. A merge runs the same verification as its PR; these workflows contain
no signing, publication, release, deployment or artifact upload lane. Inspect the actual workflows before
reusing tree-equivalent candidate evidence. Marketplace publication always needs separate approval.
- Preserve the IDE 2024.3 floor, JVM 21, optional Python integration, Free mappings, JSON compatibility,
folding semantics and source bytes. Use `ApplicationManager` scheduling for IDE thread transitions.
- Repository-specific verification improvements belong here and in the existing workflows/tests, using the
same reviewed publication path. Shared-process improvements belong to the globally installed skill source.
6 changes: 3 additions & 3 deletions gradle.properties
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# Gradle
gradleVersion=9.0.0
gradleVersion=9.8.2
org.gradle.parallel=true
# Enable Gradle Configuration Cache -> https://docs.gradle.org/current/userguide/configuration_cache.html
org.gradle.configuration-cache=true
Expand All @@ -12,14 +12,14 @@ jvmVersion=21
group=dev.meanmail
repository=https://github.com/meanmail-dev/prettify-python-plugin
pluginName=Prettify python
version=2025.2
version=2026.0
# https://plugins.jetbrains.com/docs/intellij/kotlin.html#kotlin-standard-library
kotlin.stdlib.default.dependency=false
#
# Platform
platformSinceBuild=243
# Develop platform
platformVersion=2025.1
platformVersion=2025.1.6.2
platformType=PC
#plugins=
platformBundledPlugins=PythonCore
Expand Down
2 changes: 1 addition & 1 deletion gradle/libs.versions.toml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ junit = "4.13.2"
kotlinxSerialization = "1.8.1"

# plugins
intelliJPlatform = "2.9.0"
intelliJPlatform = "2.19.0"
# https://plugins.jetbrains.com/docs/intellij/using-kotlin.html#kotlin-standard-library
kotlin = "2.0.21"

Expand Down
Binary file modified gradle/wrapper/gradle-wrapper.jar
Binary file not shown.
5 changes: 4 additions & 1 deletion gradle/wrapper/gradle-wrapper.properties
Original file line number Diff line number Diff line change
@@ -1,7 +1,10 @@
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-9.0.0-all.zip
distributionSha256Sum=21bd5da2de49b642904077f38c0efdc7778e92b3ed0889392dca61b97e389607
distributionUrl=https\://services.gradle.org/distributions/gradle-9.8.2-bin.zip
networkTimeout=10000
retries=0
retryBackOffMs=500
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
11 changes: 4 additions & 7 deletions gradlew

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading