Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
teknowledgist committed Oct 10, 2024
2 parents 616cad3 + f7be676 commit 408dabc
Show file tree
Hide file tree
Showing 884 changed files with 5,042 additions and 3,503 deletions.
17 changes: 7 additions & 10 deletions .appveyor.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,14 +25,10 @@ environment:
github_api_key:
secure: kp3pFdeqA90uVX4Yy2F5obA/O+P1428LrtCiuYZQYUMkSYi6yWTdmv35tOoce1k8

# Gitter Integration
gitter_webhook:
secure: x42idfQsl++Vm+HZbKkU/jfa0TJcXFuZz45TMlevdnA/si/dz3B3GoGE0ZhdI1uVcfvOHKPteiTlcqpRZXJ5SQ==

# Mail credentials - for error notifications
mail_user: [email protected]
mail_pass:
secure: 5PmhObpDGICgHcaw+xElQOUbl4w6ouQ49lE8lGjFCW9MDNJxNsts7xN7nkidFEjZhCyyYbycXR6rsQhqlDbJkw==
secure: w2Cf0E/uiMSr5o1r6zvr6VFsscTlqee+AdWHRF5+Tn4=
mail_server: smtp.gmail.com
mail_port: 587
mail_enablessl: true
Expand All @@ -48,8 +44,8 @@ environment:
secure: zPuYvdxGda6DUGRCwTJL5FQCWF3U+1bSLE2mEr+VfpfV08NXlXX2uFLizkhQuJYW

#Chocolatey version we want to use when checking for updates (usually latest).
choco_version: '2.0.0'
choco_version_pr: '1.1.0' # Should be kept to the version available one year ago
choco_version: '2.3.0'
choco_version_pr: '2.0.0' # Should be kept to the version available one year ago
nupkg_cache_path: C:\packages

init:
Expand All @@ -66,10 +62,11 @@ install:
'wormies-au-helpers' = '0.4.1'
'chocolatey-core.extension' = '1.4.0'
'autohotkey.install' = '1.1.35.00'
'chocolatey-community-validation.extension' = '0.1.0'
}.GetEnumerator() | % {
if (!(Test-Path "${env:nupkg_cache_path}\$($_.Key).$($_.Value).nupkg")) { rm "${env:nupkg_cache_path}\$($_.Key).*.nupkg" ; iwr "https://chocolatey.org/api/v2/package/$($_.Key)/$($_.Value)" -OutFile "${env:nupkg_cache_path}\$($_.Key).$($_.Value).nupkg" }
if ($_.Key -eq 'chocolatey') { cup $_.Key --version $_.Value --source ${env:nupkg_cache_path} --allow-downgrade --pre }
else { cinst $_.Key --version $_.Value --source ${env:nupkg_cache_path} --ignore-dependencies }
if (!(Test-Path "${env:nupkg_cache_path}\$($_.Key).$($_.Value).nupkg")) { rm "${env:nupkg_cache_path}\$($_.Key).*.nupkg" ; Invoke-WebRequest "https://chocolatey.org/api/v2/package/$($_.Key)/$($_.Value)" -OutFile "${env:nupkg_cache_path}\$($_.Key).$($_.Value).nupkg" }
if ($_.Key -eq 'chocolatey') { choco upgrade $_.Key --version $_.Value --source ${env:nupkg_cache_path} --allow-downgrade --pre }
else { choco install $_.Key --version $_.Value --source ${env:nupkg_cache_path} --ignore-dependencies }
}
rm "$env:ChocolateyInstall\logs\*.log"
- ps: 'Get-CimInstance win32_operatingsystem -Property Caption, OSArchitecture, Version | fl Caption, OSArchitecture, Version'
Expand Down
3 changes: 3 additions & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,9 @@
# Possibly have crlf for this as well (believe AU uses Windows Line Endings and utf-8-bom)
*.nuspec text eol=lf

*.ps1 text eol=crlf
*.psm1 text eol=crlf

*.png binary
*.jpg binary
*.exe binary
Expand Down
10 changes: 7 additions & 3 deletions .github/CODEOWNERS
Validating CODEOWNERS rules …
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,7 @@
*/transifex* @chocolatey-community/chocolatey-team-maintainers
*/waterfox* @AdmiringWorm
*/composer* @johnstevenson
*/k9s* @danielkoek
*/krew* @jetersen
*/kubelogin* @jetersen
*/ffmpeg-full* @VuiMuich
Expand All @@ -35,12 +36,15 @@
*/es* @TheCakeIsNaOH
*/selenium-chrome-driver* @chocolatey-community/chocolatey-team-maintainers
*/intunewinapputil* @chocolatey-community/chocolatey-team-maintainers
*/freecad* @redbaron2
*/selenium-chromium-edge-driver* @chocolatey-community/chocolatey-team-maintainers @AdmiringWorm
*/jenkins* @chocolatey-community/chocolatey-team-maintainers
*/jenkins* @chocolatey-community/chocolatey-team-maintainers @chocolatey-community/chocolatey-community-solutions
*/brave* @AdmiringWorm
*/nexus-repository* @chocolatey-community/chocolatey-team-maintainers
*/nexus-repository* @chocolatey-community/chocolatey-team-maintainers @chocolatey-community/chocolatey-community-solutions
*/totalcommander* @pauby
*/kubescape* @HollowMan6
*/googlechromebeta* @tunisiano187
*/krita* @tunisiano187
*/selenium.powershell* @chocolatey-community/chocolatey-team-maintainers

# Other
# This can be any file other that won't be matched as a package
Expand Down
18 changes: 9 additions & 9 deletions .github/ISSUE_TEMPLATE/bug-report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,14 @@ body:
**Do NOT report Security related issues here, instead use the Report Abuse on the package page instead. See https://docs.chocolatey.org/en-us/information/security#report-issue**.
Thank you for taking the time to fill out this bug report! Please fill out out the necessary information as complete as you can. Remember, it is better to include too much information, than too little. Additionally, make sure that the issue title starts with the name of the package you were seeing the issue with inside paranthesis (e.g. `(putty)`).
- type: checkboxes
attributes:
label: Checklist
description: Before continuing, make sure that you have done the following.
options:
- label: I have verified that this is the correct repository, and the package is maintained by the chocolatey-community user.
required: true
- label: I have verified that this is happening in the latest available version of the package.
- type: dropdown
id: choco-version
attributes:
Expand All @@ -18,16 +26,8 @@ body:
Do mind that versions older than the latest version that was available 1 year ago will not be supported.
multiple: true
options:
- 2.3.0
- 2.2.2
- 2.2.0
- 2.1.0
- 2.0.0
- 1.4.0
- 1.3.1
- 1.3.0
- 1.2.1
- 1.2.0
- 1.1.0
- Other (note in the comments)
validations:
required: true
Expand Down
2 changes: 2 additions & 0 deletions .github/ISSUE_TEMPLATE/outdated-report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,8 @@ body:
required: true
- label: I have verified the new version has a Windows binary (EXE or MSI installer, Zip or other archive, etc).
required: true
- label: I have verified that this is the correct repository, and the package is maintained by the chocolatey-community user.
required: true
- type: input
id: package-version
attributes:
Expand Down
2 changes: 1 addition & 1 deletion .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@
- [ ] I have updated the documentation accordingly (this usually means the notes in the description of a package).
- [ ] I have updated the package description and it is less than 4000 characters.
- [ ] All files are up to date with the latest [Contributing Guidelines](https://github.com/chocolatey-community/chocolatey-packages/blob/master/CONTRIBUTING.md)
- [ ] The added/modified package passed install/uninstall in the chocolatey test environment.
- [ ] The added/modified package passed install/uninstall in the Chocolatey Test Environment(https://github.com/chocolatey-community/chocolatey-test-environment/). _Note that we don't support the use of any other environment_.
- [ ] The changes only affect a single package (not including meta package).

<!-- The following section can be removed if the package has not been migrated from another location -->
Expand Down
5 changes: 4 additions & 1 deletion .github/workflows/stale.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,10 +27,13 @@ jobs:
close-pr-label: 'Unresolved'
exempt-issue-labels: 'Security / CVE,0 - Backlog,1 - Ready for work,2 - Working, 3 - Review, 5 - Push required'
exempt-pr-labels: 'Security / CVE'
labels-to-remove-when-unstale: '0 - Wating on User,Pending closure'
labels-to-remove-when-unstale: '0 - Waiting on User,Pending closure'
stale-issue-message: |
Is this still relevant? If so, what is blocking it? Is there anything you can do to help move it forward?
This issue will be closed in 14 days if it continues to be inactive.
Please do not add a comment to circumvent automatic closure unless **you** plan to help move it forward.
Doing this may lead to the issue being closed immediately instead.
close-issue-message: |
Dear contributor,
Expand Down
4 changes: 2 additions & 2 deletions .github/workflows/toc.yml
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,12 @@ jobs:
runs-on: ubuntu-latest

steps:
- uses: technote-space/toc-generator@v4.0.0
- uses: technote-space/toc-generator@v4.3.1

with:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
CREATE_PR: true
TARGET_PATHS: "README*.md,CONTRIBUTING*.md"
TARGET_PATHS: "README*.md,CONTRIBUTING*.md,COMMITTERS*.md"
FOLDING: true
COMMIT_MESSAGE: '(docs) Update TOC'
PR_TITLE: '(docs) Update TOC (${PR_MERGE_REF})'
52 changes: 52 additions & 0 deletions COMMITTERS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,52 @@
# Committers Guidelines

This file details what is needed for different operations in the repository that can not be handled by opening pull requests.

<!-- markdownlint-disable -->
<!-- START doctoc generated TOC please keep comment here to allow auto update -->
<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
<details>
<summary>Table of Contents</summary>

- [Providing A Fixed Version](#providing-a-fixed-version)
- [Request A Standard Fix Version Creation](#request-a-standard-fix-version-creation)
- [Request A Standard Fix Version Creation For A Stream](#request-a-standard-fix-version-creation-for-a-stream)
- [Request A Fixed Version Update](#request-a-fixed-version-update)
- [Requesting A Fix For A Package Using 4 Part Version Number](#requesting-a-fix-for-a-package-using-4-part-version-number)

</details>
<!-- END doctoc generated TOC please keep comment here to allow auto update -->

<!-- markdownlint-enable -->

## Providing A Fixed Version

Before providing a fixed package version, you need to determine the existing version specified in the repository, what type of version it uses, and whether the package contains additional handling for creating fixed versions.

### Request A Standard Fix Version Creation

A standard fix version creation is intended for packages that do not use streams and does not use a 4-part version number - usually determined by whether there is no JSON file available in the package directory and the package metadata file uses a 2 or 3-part version number.

To request a fixed version, create an empty commit with the message `[AU packageName]`. This can be done by using the following command line call: `git commit --allow-empty-commit -m "[AU packageName]"` (replace packageName with the actual name of the package). Ensure you don't make any changes, as this can prevent your ability to push the commit.

### Request A Standard Fix Version Creation For A Stream

To request a standard fixed version for a stream, you need to figure out the name of the stream you want to force the fixed version of. All packages that support streams are expected to have a JSON file next to their metadata file that contains a list of the different streams and the last version found for that stream. Find the stream in this file, and make sure that the stream uses a 2 or 3-part version number.
Commonly, the highest version is located in the stream name `latest` (however, not always). It is also not guaranteed that all streams listed in the file are available.

To request a fixed version, in this case, you create an empty commit with the message `[AU packageName\streamName]`. This can be done by using the following command line call: `git commit --allow-empty-commit -m "[AU packageName\streamName]` (replace packageName with the actual name of the package, and streamName with the name of the stream). Ensure you don't make any changes, as this can prevent your ability to push the commit.

#### Request A Fixed Version Update

If you need to update the same version the updater had previously submitted, or if the package you want uses a 4-part version number, you may need to specify the exact version you want to push.
It is crucial to note here that the version used will only change the version specified in the metadata file of the pushed package and not decide which version of the software will be pulled down from any upstream location.

To create a fixed version update, you may use `[AU packageName:packageVersion]` for standard packages and `[AU packageName\streamVersion:packageVersion]` for stream packages using the same git command mentioned previously. Ensure you don't make any changes, as this can prevent your ability to push the commit.

#### Requesting A Fix For A Package Using 4 Part Version Number

If you need to create a fixed version for a package that already uses four parts of the version number, you must first add or update the updater script.
Before setting the `Version` parameter to the returned object in `au_GetLatest`, add a call to the function `Get-FixVersion`. This call should also include the parameter `-OnlyFixBelowVersion` that it set to the next patch version of the package.
See [gom-player](https://github.com/chocolatey-community/chocolatey-packages/blob/1849e4d17c66ff11cd48f4b8c9bf861add15bb68/automatic/gom-player/update.ps1#L38) for an example of this. Do note that you may need to create these changes as part of a PR if you cannot bypass the required checks in the repository.

After committing this change, you can do a standard fix version creation.
Loading

0 comments on commit 408dabc

Please sign in to comment.