Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Allow post/pre hooks to run on upgrade/install/uninstall #1185

Closed
AdmiringWorm opened this issue Mar 5, 2017 · 13 comments · Fixed by #2535 or #2834
Closed

Allow post/pre hooks to run on upgrade/install/uninstall #1185

AdmiringWorm opened this issue Mar 5, 2017 · 13 comments · Fixed by #2535 or #2834
Assignees
Labels
5 - Released FeatureParity Improvement IN REGRESSION TEST SUITE These are things that are handled by tools like Test-Kitchen
Milestone

Comments

@AdmiringWorm
Copy link
Member

The idea for this have been taken from pacman (the main package manager for arch linux).
One usage example on how it is used in pacman would be running reflector after pacman-mirrorlist package is updated: https://wiki.archlinux.org/index.php/Reflector#Pacman_Hook

What I request is similiar: have a directory (either configurable or hard coded to $env:ChocolateyInstall\hook that stores a bunch of powershell scripts that are meant to be run after/before a package update/install (or after choco have completed the full update/install of all packages).

The way I'm thinking this could work is through a naming convention. ie: (pre|post){pacakge-id}-upgrade/install/uninstall.ps1 or (pre|post)global-upgrade/install/uninstall.ps1.

The reason I would like to see something like this implemented is because quite a few times I have a need/want to automatically configure some extra configuration for the package(s) that I'm installing (usually user specific configurations) (could range from anything as easy as removing a shortcut, to full configuration of git, virtualbox, smartgit, or even choco. as well as others).

@ferventcoder
Copy link
Member

ferventcoder commented Mar 5, 2017

Chocolatey does have this concept built-in to it, but it is not consumer based. I think this could be looked at being added as well. Just unsure where this could fall.

Related: chocolatey/chocolatey-licensed-issues#11

@ferventcoder ferventcoder modified the milestone: 0.10.4 Mar 23, 2017
@bcurran3
Copy link

I know this is very "edge case" but I too would welcome this feature. It would allow some pre and post processing when installing packages.

Some examples:

I'm sure people will come up with many creative uses for it.

@TheCakeIsNaOH
Copy link
Member

I am very interested in this feature. It would be very helpful for my workflow, as I like to archive a copy of programs installers.

@jayvdb
Copy link

jayvdb commented Jun 14, 2019

https://github.com/Badgerati/Fudge provides the ability to have pre and post hooks , but they run before and after the set of packages, not before/after each one. I am using the post-install hook , loading the Fudgefile, and dynamically calling scriptlets called deps.<choco-package-name>-postinstall.ps1 for each package in the Fudgefile.

@jayvdb
Copy link

jayvdb commented Jun 14, 2019

https://github.com/Badgerati/Picassio and https://github.com/Badgerati/Picassio2 also provide a way for pre/post hooks.

@ferventcoder ferventcoder added this to the 0.11.0 milestone Apr 15, 2020
@mavaddat
Copy link

This feature would be very useful to me.
I am trying to attach a post-update script to my choco upgrade command whenever it updates my JDK, so that I can update my vscode settings.json to always point to the correct JDK path in the settings.
Background: I use chocolatey to manage my JDK as AdoptOpenJDK. I use vscode for coding in Java. vscode needs to know where my JDK lives. To achieve this, I have this in my settings.json:

[snip]
"java.home": "{$env:ProgramFiles}\\AdoptOpenJDK\\jdk-14.0.2.12-hotspot",
"java.configuration.runtimes": [
        {
            "name": "JavaSE-1.8",
            "path": "{$env:APPDATA}\\java-1.8.0-openjdk-1.8.0.252-2.b09.redhat.windows.x86_64",
            "sources": "{$env:APPDATA}\\java-1.8.0-openjdk-1.8.0.252-2.b09.redhat.windows.x86_64\\src.zip",
            "javadoc": "https://docs.oracle.com/javase/8/docs/api",
            "default": false
        },
        {
            "name": "JavaSE-14",
            "path": "{$env:ProgramFiles}\\AdoptOpenJDK\\jdk-14.0.2.12-hotspot",
            "sources": "{$env:ProgramFiles}\\AdoptOpenJDK\\jdk-14.0.2.12-hotspot\\lib\\src.zip",
            "javadoc": "https://api.adoptopenjdk.net/",
            "default": true
        }
    ],
[snip]

However, the paths can break if AdoptOpenJDK is updated. This isn't too big of a hassle, but it would be neat to automate the json update so that a script ran after each JDK update to correct the settings too.

@TheCakeIsNaOH
Copy link
Member

I have a couple of other examples that I have thought of where this would be useful:

@TheCakeIsNaOH
Copy link
Member

My thoughts on details of a possible implementation:

Create a new package type, the .hook package. Similar to .extension or .template packages. Then in $env:ChocolateyInstall\hook each package gets it's own folder, like $env:ChocolateyInstall\extension has. Then an extension can have a pre-<packageid>-install.ps1, a post-<packageid>-install.ps1, pre-global-uninstall.ps1, etc, as needed for each type of hook. This would not always be quite as flexible as having directly user-editable scripts (ie editable without a package upgrade/reinstall), but if that where an issue, you could always create a package to call a user-editable script elsewhere. Or for security, actually an Admin-editable script.

In regards to the types of hooks:

  • Pre/Post install package specific hooks. Multiple obvious uses, mainly for configuration of the software from the package. Should also run for upgrades, not only for installs.
  • Pre/Post install global hooks. Should these run before/after each package, or before/after the entire list of packages? If before/after the entire list, then a method of listing each package id and version should be made available.
  • Pre/Post uninstall package specific hooks. Cleanup after poorly written uninstallers, remove user configuration, kill process that may use a shared resource.
  • Pre/Post uninstall global hooks. Same as install
  • Pre pack hooks. Useful for validation (à la choco-nuspec-checker), or other testing (pester?). Not sure if a post pack hook would be useful?
  • Upgrade hooks? - IMO the install hooks should just run on upgrade. Maybe there is something I am missing where a upgrade specific hook would be useful, where it shouldn't run on first install.
  • Pre/Post global every command hooks? I'm also not sure about this one.

I can't really think of any other categories of hooks that would be useful.

Any commands that have hooks possible should have a CLI option to skip hooks. Depending on which categories of hooks are chosen, perhaps CLI options to skip specific types of hooks (eg skip the overall global hooks, but don't skip the install hooks).

At least for the individual scripts for install and uninstall, the environment variables should still be set. I'm not %100 what to do for a global hook in regards to the package name+title+version+folder variables, that's something to figure out.

The Chocolatey PowerShell functions, and extensions as well should be pre-imported, as in with normal package scripts. Stuff like install-binfile, install-ChocolateyFileAssociation, and install-chocolateyshortcut all seem like they would be useful, as would things like remove-process from the core extension. It would be good to write up some docs for which helpers should not be used, e.g. Install-ChocolateyPackage.


Re: which edition.

@ferventcoder

Chocolatey does have this concept built-in to it, but it is not consumer based.

I really don't understand what you mean by "comsumer based". Isn't everyone who uses Chocolatey a consumer? I'm not sure what the alternative to a consumer would be in this context. A developer or vendor maybe?

But this is comparatively much less useful to a developer of Chocolatey, as they presumably would have the knowledge and access to create their own packages. While a consumer that just uses Chocolatey would presumably find it much more useful. For example, a developer could make a PR on a package to add a package parameter to remove the desktop shortcut, while a consumer might be stuck asking nicely, in which case a hook that removes desktop icons would come in very useful to the consumer.

I think this could be looked at being added as well. Just unsure where this could fall.

Over at chocolatey/chocolatey-licensed-issues#11, you specified "custom user scripts". Does that mean that you are intending the open source edition to have hooks that run globally, while the licensed edition will have support each windows user account having their own hooks?

@ferventcoder
Copy link
Member

I really don't understand what you mean by "comsumer based". Isn't everyone who uses Chocolatey a consumer? I'm not sure what the alternative to a consumer would be in this context. A developer or vendor maybe?

Consumer versus Business in this case - the alternative here being organizations using Chocolatey having different needs than individual users.

Over at chocolatey/chocolatey-licensed-issues#11, you specified "custom user scripts". Does that mean that you are intending the open source edition to have hooks that run globally, while the licensed edition will have support each windows user account having their own hooks?

@TheCakeIsNaOH note this is in "Triaging" label, which means it is not on the backlog and work has not been committed to putting it in. We have tagged the licensed item to put something very similar (if not the same exact thing) into the commercial editions, starting at Pro.

@TheCakeIsNaOH
Copy link
Member

Alright since this is undecided on if it is going into open source choco, if anyone is interested in an implementation of this available now, see my choco-hooks.extension package:

It only does scripts run pre/post the install/modify/uninstall scripts of each individual package, and not scripts that run pre/post of the entire run of choco.

For that, two options are choco-upgrade-all-at-startup and choco-upgrade-all-at, both of which have an option to run pre/post run scripts and are created by @bcurran3.

@gep13 gep13 modified the milestones: 0.11.x, 0.10.x Sep 17, 2021
TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Jan 17, 2022
This adds the code to run Powershell scripts (hook scripts) before and
after each type of package automation script runs. The hook scripts can
be for all packages, or for a specific package ID. They are put in
$env:ChocolateyInstall\hooks, or subfolders thereof.

The filename determines when they are run:
"<pre|post>-<install|beforemodify|uninstall>-<packageID|all>.ps1"
TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Jan 17, 2022
This adds the ability for choco to install .hook packages that contain
hook scripts. Put the .ps1 scripts in the "hook" directory in the
package, and make the id of the package end in .hook, and they will get
copied to the hook directory
TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Jan 17, 2022
This adds a switch to the install, upgrade and uninstall commands to
skip running hook scripts. It adds a configuration option
SkipHookScripts.
TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Jan 17, 2022
…cript

This allows hooks to run even without a package automation script being
present.
TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Jan 17, 2022
…cript

This allows hooks to run even without a package automation script being
present.
@TheCakeIsNaOH
Copy link
Member

TheCakeIsNaOH commented Jan 18, 2022

After playing around with the .extension based hook implementation, not being able to run hooks on packages that do not have automation scripts makes these scripts much less useful. Therefore, I'm working on an implementation into Chocolatey CLI itself, which is able to run hooks even if the package does not have the appropriate automation script.

It does not do scripts on pack, or global scripts before/after install/uninstall/upgrade, at least not yet.

#2535

TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Mar 21, 2022
This adds the code to run Powershell scripts (hook scripts) before and
after each type of package automation script runs. The hook scripts can
be for all packages, or for a specific package ID. They are put in
$env:ChocolateyInstall\hooks, or subfolders thereof.

The filename determines when they are run:
"<pre|post>-<install|beforemodify|uninstall>-<packageID|all>.ps1"
TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Mar 21, 2022
This adds the ability for choco to install .hook packages that contain
hook scripts. Put the .ps1 scripts in the "hook" directory in the
package, and make the id of the package end in .hook, and they will get
copied to the hook directory
TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Mar 21, 2022
This adds a switch to the install, upgrade and uninstall commands to
skip running hook scripts. It adds a configuration option
SkipHookScripts.
TheCakeIsNaOH added a commit to TheCakeIsNaOH/choco that referenced this issue Mar 21, 2022
…cript

This allows hooks to run even without a package automation script being
present.
AdmiringWorm added a commit to AdmiringWorm/choco that referenced this issue Sep 23, 2022
Changing the interface or public methods are breaking changes which
we need to wait with implementing before the next major release.
As such, this commit adds back the old way of running the powershell
host by adding an overload with the original contract for the interface
that could possibly be used in other projects that makes use of the
Chocolatey.Lib library.

This overload has been made obsolete and will just call the new method
while setting any hook scripts as empty enumerables.
corbob added a commit to corbob/choco that referenced this issue Sep 23, 2022
Add tests that hook scripts execute in scenarios where they're expected
to run.
corbob added a commit to corbob/choco that referenced this issue Sep 23, 2022
With the upgrade package used in the tests, it currently exits with -1
even though it is successful. Instead of blindly accepting 0 and -1 for
all the tests, be explicit about which one we expect so we can catch
changes to this exit code.
corbob added a commit to corbob/choco that referenced this issue Sep 24, 2022
Add tests that hook scripts execute in scenarios where they're expected
to run.
corbob added a commit to corbob/choco that referenced this issue Sep 24, 2022
With the upgrade package used in the tests, it currently exits with -1
even though it is successful. Instead of blindly accepting 0 and -1 for
all the tests, be explicit about which one we expect so we can catch
changes to this exit code.
corbob added a commit to corbob/choco that referenced this issue Sep 24, 2022
With the upgrade package used in the tests, it currently exits with -1
even though it is successful. Instead of blindly accepting 0 and -1 for
all the tests, be explicit about which one we expect so we can catch
changes to this exit code.
corbob added a commit that referenced this issue Sep 24, 2022
(#1185) Add original powershell host run as deprecated method
corbob added a commit to corbob/choco that referenced this issue Sep 24, 2022
Add tests that hook scripts execute in scenarios where they're expected
to run.
corbob added a commit to corbob/choco that referenced this issue Sep 24, 2022
With the upgrade package used in the tests, it currently exits with -1
even though it is successful. Instead of blindly accepting 0 and -1 for
all the tests, be explicit about which one we expect so we can catch
changes to this exit code.
corbob added a commit to corbob/choco that referenced this issue Sep 26, 2022
Add tests that hook scripts execute in scenarios where they're expected
to run.
corbob added a commit to corbob/choco that referenced this issue Sep 26, 2022
With the upgrade package used in the tests, it currently exits with -1
even though it is successful. Instead of blindly accepting 0 and -1 for
all the tests, be explicit about which one we expect so we can catch
changes to this exit code.
corbob added a commit to corbob/choco that referenced this issue Sep 27, 2022
When passing package parameters into chocolateyScriptRunner.ps1, if
there are quotes, PowerShell can get confused. This ensures that we're
specifying the new hook arguments and passing nothing if there should be
nothing.
AdmiringWorm pushed a commit to corbob/choco that referenced this issue Sep 27, 2022
When passing package parameters into chocolateyScriptRunner.ps1, if
there are quotes, PowerShell can get confused. This ensures that we're
specifying the new hook arguments and passing nothing if there should be
nothing.
@AdmiringWorm AdmiringWorm changed the title [Feature Request] Allow post/pre hooks to run on upgrade/install/uninstall Allow post/pre hooks to run on upgrade/install/uninstall Oct 19, 2022
@TheCakeIsNaOH
Copy link
Member

There is an open documentation PR here: chocolatey/docs#564

It's ready for review, but in draft to prevent merging until the Chocolatey CLI release goes out.

AdmiringWorm added a commit to AdmiringWorm/choco that referenced this issue Oct 19, 2022
* release/1.2.0: (374 commits)
  (maint) Add incoming arguments available in Licensed Extension
  (chocolatey#798) Add missing pin option in tab completion
  (chocolatey#2860) Add e2e tests for new PS cmdlet
  (maint) Fix Chocolatey path in docs generation
  (chocolatey#2860) Add new PS helper to get maintainer specific paths
  (chocolatey#2816) Update to latest Chocolatey NuGet.Core
  (chocolatey#2693) Re-add old resolve or load method
  (chocolatey#886) Update packages.config install logging
  (chocolatey#1185) Always pass in hook scripts event if empty
  Update tests/chocolatey-tests/commands/choco-outdated.Tests.ps1
  (chocolatey#2801) Pin Chocolatey packages for outdated tests
  (chocolatey#886) Use specific strings for configurations
  (chocolatey#886) Add Pester tests for packages.config
  (chocolatey#886) Debug log Package configuration
  (chocolatey#1185) Be explicit with expected exit codes
  (maint) Pester test directory structure shuffle
  (chocolatey#1185) Add tests for hook scripts
  (maint) Minor formatting change
  (chocolatey#798) Add tests for pinning package on install
  (chocolatey#2787) Restore Chocolatey snapshot before sxs
  ...
@AdmiringWorm
Copy link
Member Author

🎉 This issue has been resolved in version 1.2.0 🎉

The release is available on:

Your GitReleaseManager bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
5 - Released FeatureParity Improvement IN REGRESSION TEST SUITE These are things that are handled by tools like Test-Kitchen
Projects
None yet
9 participants