Skip to content

Commit

Permalink
Add LatexPackageUpdateInspection
Browse files Browse the repository at this point in the history
  • Loading branch information
PHPirates committed Dec 27, 2024
1 parent 6d7b1c2 commit 0cfbaa2
Show file tree
Hide file tree
Showing 6 changed files with 178 additions and 0 deletions.
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@
### Added
* Add option to disable automatic compilation in power save mode
* Convert automatic compilation settings to a combobox
* Add inspection to check for LaTeX package updates
* Add checkboxes to graphic insertion wizard for relative width or height

### Fixed
Expand Down
7 changes: 7 additions & 0 deletions Writerside/topics/Packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,13 @@ This inspection is for TeX Live only, MiKTeX automatically installs packages on
When using `\usepackage` or `\RequirePackage`, TeXiFy checks if the packages is installed.
If it isn’t installed, it provides a quick fix to install the package.

## Package update available
_Since b0.9.10_

When a package has an update available on CTAN, this inspection will provide a quickfix to update the package.
Currently, it only works when tlmgr (TeX Live manager) is installed.
The list of available package updates is cached until IntelliJ is restarted or the quickfix is used.

## Package name does not match file name
_Since b0.6.10_

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,10 @@
groupPath="LaTeX" groupName="Probable bugs" displayName="Package is not installed"
enabledByDefault="true"
level="WARNING" />
<localInspection language="Latex" implementationClass="nl.hannahsten.texifyidea.inspections.latex.probablebugs.packages.LatexPackageUpdateInspection"
groupPath="LaTeX" groupName="Probable bugs" displayName="Package has an update available"
enabledByDefault="true"
level="WARNING" />
<localInspection language="Latex" implementationClass="nl.hannahsten.texifyidea.inspections.latex.probablebugs.packages.LatexPackageNameDoesNotMatchFileNameInspection"
groupPath="LaTeX" groupName="Probable bugs" displayName="Package name does not match file name"
enabledByDefault="true"
Expand Down
8 changes: 8 additions & 0 deletions resources/inspectionDescriptions/LatexPackageUpdate.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@

<html>
<body>
The package given in a <tt>\usepackage</tt> or <tt>\RequirePackage</tt> has an update available.
<!-- tooltip end -->
This inspection only checks installed packages on texlive systems (with tlmgr).
</body>
</html>
Original file line number Diff line number Diff line change
@@ -0,0 +1,130 @@
package nl.hannahsten.texifyidea.inspections.latex.probablebugs.packages

import com.intellij.codeInsight.daemon.DaemonCodeAnalyzer
import com.intellij.codeInsight.intention.preview.IntentionPreviewInfo
import com.intellij.codeInspection.InspectionManager
import com.intellij.codeInspection.LocalQuickFix
import com.intellij.codeInspection.ProblemDescriptor
import com.intellij.codeInspection.ProblemHighlightType
import com.intellij.notification.Notification
import com.intellij.notification.NotificationType
import com.intellij.openapi.progress.ProgressIndicator
import com.intellij.openapi.progress.ProgressManager
import com.intellij.openapi.progress.Task.Backgroundable
import com.intellij.openapi.project.Project
import com.intellij.psi.PsiFile
import com.intellij.psi.SmartPointerManager
import com.intellij.psi.SmartPsiElementPointer
import nl.hannahsten.texifyidea.inspections.InsightGroup
import nl.hannahsten.texifyidea.inspections.TexifyInspectionBase
import nl.hannahsten.texifyidea.psi.LatexCommands
import nl.hannahsten.texifyidea.settings.sdk.LatexSdkUtil
import nl.hannahsten.texifyidea.settings.sdk.TexliveSdk
import nl.hannahsten.texifyidea.util.magic.CommandMagic
import nl.hannahsten.texifyidea.util.parser.childrenOfType
import nl.hannahsten.texifyidea.util.parser.requiredParameter
import nl.hannahsten.texifyidea.util.runCommand
import nl.hannahsten.texifyidea.util.runCommandWithExitCode

/**
* Check for available updates for LaTeX packages.
* Also see [LatexPackageNotInstalledInspection].
*/
class LatexPackageUpdateInspection : TexifyInspectionBase() {

object Cache {
/** Map package name to old and new revision number */
var availablePackageUpdates = mapOf<String, Pair<String?, String?>>()
}

override val inspectionGroup = InsightGroup.LATEX

override val inspectionId = "PackageUpdate"

override fun getDisplayName() = "Package has an update available"

override fun inspectFile(file: PsiFile, manager: InspectionManager, isOntheFly: Boolean): List<ProblemDescriptor> {
if (!LatexSdkUtil.isTlmgrAvailable(file.project) || !TexliveSdk.Cache.isAvailable) return emptyList()

if (Cache.availablePackageUpdates.isEmpty()) {
val tlmgrExecutable = LatexSdkUtil.getExecutableName("tlmgr", file.project)
val result = runCommand(tlmgrExecutable, "update", "--list") ?: return emptyList()
Cache.availablePackageUpdates = """update:\s*(?<package>[^ ]+).*local:\s*(?<local>\d+), source:\s*(?<source>\d+)""".toRegex()
.findAll(result)
.mapNotNull { Pair(it.groups["package"]?.value ?: return@mapNotNull null, Pair(it.groups["local"]?.value, it.groups["source"]?.value)) }
.associate { it }
}

return file.childrenOfType<LatexCommands>()
.filter { it.name in CommandMagic.packageInclusionCommands }
.filter { it.requiredParameter(0) in Cache.availablePackageUpdates.keys }
.mapNotNull {
val packageName = it.requiredParameter(0) ?: return@mapNotNull null
val packageVersions = Cache.availablePackageUpdates[packageName] ?: return@mapNotNull null
manager.createProblemDescriptor(
it,
"Update available for package $packageName",
UpdatePackage(SmartPointerManager.getInstance(file.project).createSmartPsiElementPointer(file), packageName, packageVersions.first, packageVersions.second),
ProblemHighlightType.GENERIC_ERROR_OR_WARNING,
isOntheFly
)
}
}

private class UpdatePackage(val filePointer: SmartPsiElementPointer<PsiFile>, val packageName: String, val old: String?, val new: String?) : LocalQuickFix {

override fun getFamilyName(): String = if (old != null && new != null) "Update $packageName from revision $old to revision $new" else "Update $packageName"

override fun generatePreview(project: Project, previewDescriptor: ProblemDescriptor): IntentionPreviewInfo {
// Nothing is modified
return IntentionPreviewInfo.EMPTY
}

override fun applyFix(project: Project, descriptor: ProblemDescriptor) {
ProgressManager.getInstance().run(object : Backgroundable(project, "Updating $packageName...") {
override fun run(indicator: ProgressIndicator) {
val tlmgrExecutable = LatexSdkUtil.getExecutableName("tlmgr", project)

var (output, exitCode) = runCommandWithExitCode(tlmgrExecutable, "update", packageName, returnExceptionMessage = true, timeout = 10)
if (output?.contains("tlmgr update --self") == true) {
val (tlmgrOutput, tlmgrExitCode) = runCommandWithExitCode(tlmgrExecutable, "update", "--self", returnExceptionMessage = true, timeout = 10)
if (tlmgrExitCode != 0) {
Notification(
"LaTeX",
"Package $packageName not updated",
"Could not update tlmgr: $tlmgrOutput",
NotificationType.ERROR
).notify(project)
indicator.cancel()
}
title = "Updating $packageName..."
val (secondOutput, secondExitCode) = runCommandWithExitCode(tlmgrExecutable, "update", packageName, returnExceptionMessage = true, timeout = 10)
output = secondOutput
exitCode = secondExitCode
}

if (exitCode != 0) {
Notification(
"LaTeX",
"Package $packageName not updated",
"Could not update $packageName: $output",
NotificationType.ERROR
).notify(project)
indicator.cancel()
}
}

override fun onSuccess() {
// Clear cache, since we changed something
Cache.availablePackageUpdates = mapOf()
// Rerun inspections
DaemonCodeAnalyzer.getInstance(project)
.restart(
filePointer.containingFile
?: return
)
}
})
}
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
package nl.hannahsten.texifyidea.inspections.latex.probablebugs.packages

import io.mockk.every
import io.mockk.mockkObject
import nl.hannahsten.texifyidea.inspections.TexifyInspectionTestBase
import nl.hannahsten.texifyidea.settings.sdk.LatexSdkUtil
import nl.hannahsten.texifyidea.settings.sdk.TexliveSdk
import nl.hannahsten.texifyidea.util.TexLivePackages

class LatexPackageUpdateInspectionTest : TexifyInspectionTestBase(LatexPackageUpdateInspection()) {

fun testWarning() {
texliveWithTlmgr()

mockkObject(TexLivePackages)
LatexPackageUpdateInspection.Cache.availablePackageUpdates = mapOf(Pair("amsmath", Pair("71408", "72779")))

testHighlighting("<warning descr=\"Update available for package amsmath\">\\usepackage{amsmath}</warning>")
}

private fun texliveWithTlmgr(texlive: Boolean = true, tlmgr: Boolean = true) {
mockkObject(TexliveSdk.Cache)
every { TexliveSdk.Cache.isAvailable } returns texlive

mockkObject(LatexSdkUtil)
every { LatexSdkUtil.isTlmgrInstalled } returns tlmgr
}
}

0 comments on commit 0cfbaa2

Please sign in to comment.