20220910A

Author: hugoalh

.eslintrc.yml

@@ -0,0 +1,209 @@
+env:
+  amd: false
+  applescript: false
+  atomtest: false
+  browser: true
+  commonjs: true
+  embertest: false
+  es6: true
+  es2017: true
+  es2020: true
+  es2021: true
+  greasemonkey: false
+  jasmine: false
+  jest: false
+  jquery: false
+  meteor: false
+  mocha: false
+  mongo: false
+  nashorn: false
+  node: true
+  phantomjs: false
+  prototypejs: false
+  protractor: false
+  qunit: false
+  serviceworker: true
+  shared-node-browser: true
+  shelljs: false
+  webextensions: true
+  worker: true
+extends:
+  - "eslint:all"
+parserOptions:
+  ecmaFeatures:
+    arrowFunctions: true
+    classes: true
+    defaultParams: true
+    destructuring: true
+    experimentalObjectRestSpread: true
+    forOf: true
+    generators: true
+    globalReturn: false
+    impliedStrict: true
+    jsx: false
+    modules: true
+    objectLiteralComputedProperties: true
+    objectLiteralDuplicateProperties: true
+    objectLiteralShorthandMethods: true
+    objectLiteralShorthandProperties: true
+    regexUFlag: true
+    regexYFlag: true
+    restParams: true
+    spread: true
+    superInFunctions: false
+    templateStrings: true
+    unicodeCodePointEscapes: true
+  ecmaVersion: "latest"
+  sourceType: "module"
+plugins:
+  - "only-warn"
+rules:
+  array-element-newline:
+    - "warn"
+    - "consistent"
+  arrow-body-style:
+    - "warn"
+    - "always"
+  brace-style:
+    - "warn"
+    - "1tbs"
+    - allowSingleLine: false
+  capitalized-comments: "off"
+  complexity: "off"
+  dot-location: "off"
+  dot-notation: "off"
+  eqeqeq:
+    - "warn"
+    - "always"
+  func-names:
+    - "warn"
+    - "as-needed"
+  func-style:
+    - "warn"
+    - "declaration"
+    - allowArrowFunctions: true
+  function-call-argument-newline:
+    - "warn"
+    - "consistent"
+  function-paren-newline:
+    - "warn"
+    - "multiline-arguments"
+  guard-for-in: "off"
+  id-length:
+    - "warn"
+    - max: 80
+      min: 1
+      properties: "always"
+  indent:
+    - "warn"
+    - "tab"
+    - flatTernaryExpressions: false
+      ImportDeclaration: 1
+      MemberExpression: 1
+      ObjectExpression: 1
+      outerIIFEBody: 1
+      SwitchCase: 1
+      VariableDeclarator: 1
+  init-declarations: "off"
+  line-comment-position: "off"
+  linebreak-style: "off"
+  lines-around-comment: "off"
+  lines-between-class-members: "off"
+  max-classes-per-file: "off"
+  max-depth: "off"
+  max-len: "off"
+  max-lines-per-function: "off"
+  max-lines: "off"
+  max-params:
+    - "warn"
+    - max: 5
+  max-statements: "off"
+  multiline-comment-style: "off"
+  multiline-ternary:
+    - "warn"
+    - "always-multiline"
+  new-cap: "off"
+  no-alert: "off"
+  no-bitwise: "off"
+  no-case-declarations: "off"
+  no-console: "off"
+  no-continue: "off"
+  no-empty:
+    - "warn"
+    - allowEmptyCatch: true
+  no-extra-parens:
+    - "warn"
+    - "all"
+    - conditionalAssign: false
+      ignoreJSX: "multi-line"
+      nestedBinaryExpressions: false
+      returnAssign: false
+  no-inline-comments: "off"
+  no-labels: "off"
+  no-magic-numbers: "off"
+  no-mixed-operators:
+    - "warn"
+    - allowSamePrecedence: true
+  no-new: "off"
+  no-param-reassign: "off"
+  no-plusplus:
+    - "warn"
+    - allowForLoopAfterthoughts: true
+  no-tabs:
+    - "warn"
+    - allowIndentationTabs: true
+  no-ternary: "off"
+  no-undefined: "off"
+  no-var: "off"
+  no-void: "off"
+  object-curly-newline:
+    - "warn"
+    - consistent: true
+      multiline: true
+  object-curly-spacing:
+    - "warn"
+    - "always"
+  object-shorthand:
+    - "warn"
+    - "consistent-as-needed"
+  one-var-declaration-per-line: "off"
+  one-var: "off"
+  padded-blocks:
+    - "warn"
+    - "never"
+  prefer-arrow-callback:
+    - "warn"
+    - allowNamedFunctions: true
+  prefer-const: "off"
+  prefer-destructuring: "off"
+  prefer-exponentiation-operator: "off"
+  prefer-rest-params: "off"
+  quote-props:
+    - "warn"
+    - "consistent"
+  quotes:
+    - "warn"
+    - "double"
+    - allowTemplateLiterals: true
+  semi:
+    - "warn"
+    - "always"
+    - omitLastInOneLineBlock: false
+  sort-imports:
+    - "warn"
+    - allowSeparatedGroups: false
+      ignoreCase: true
+  sort-keys:
+    - "warn"
+    - "asc"
+    - caseSensitive: false
+      natural: true
+  sort-vars:
+    - "warn"
+    - ignoreCase: true
+  space-before-function-paren:
+    - "warn"
+    - anonymous: "always"
+      named: "never"
+      asyncArrow: "always"
+  spaced-comment: "off"

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -18,6 +18,7 @@ body:
       description: "What versions are affected? Versions must be listed as supported in the Security Policy (i.e.: file `SECURITY.md`)."
       multiple: true
       options:
+        - "v1.0.1"
         - "v1.0.0"
         - "v0.5.5"
         - "v0.5.4"

CONTRIBUTING.md

@@ -1,26 +1,43 @@
 # Contributing Guide
 
-## Preface
-
 This Contributing Guide includes the guidelines, methods, and ways to contribute on different categories, items, and types; If this Contributing Guide does not include some of the categories, items, and/or types, maybe:
 
 - those guidelines, methods, and/or ways are separated from this Contributing Guide and exist and/or store in their corresponding places,
 - those categories, items, and/or types are easy to understand how to correctly contributing, or
 - maintainers and/or owners forgot to edit this Contributing Guide.
 
-If you still confused, try to create a discussion or an issue.
+If you have any questions and/or still confused, try to create a discussion.
+
+## Codes
+
+All of the codes in this project and repository are follow the "[hxhS (hugoalh & hugoalh Studio) Coding Guide](https://github.com/hugoalh/hugoalh/blob/main/coding-guide/main.md)".
+
+## Deploys, Releases, Tags & Versions
+
+These are always the works for the maintainers and owners.
 
 ## Discussions
 
 - Before create a discussion, check whether any similar discussions are already exist.
-- For any bug reports, it is better to create an issue.
-- For any security vulnerability reports, please visit the Security Policy (/.github/SECURITY.md).
+- Any reports and requests should create an issue instead.
+
+## Documentations, Documents & Wikis
+
+To improve the documentations and/or documents, clone this repository, edit the documentations and/or documents, and create a pull request.
+
+This project and repository does not have wikis.
+
+## I18ns (Internationalizations) & Translations
+
+This project and repository does not have necessary things to do i18ns and/or translations.
+
+If you want to do i18ns and/or translations on the documentations, documents and/or wikis, please see section "[Documentations, Documents & Wikis](#documentations-documents--wikis)".
 
 ## Issues
 
 - Before create an issue, check whether any similar issues are already exist.
-- For any questions, it is better to create a discussion.
-- For any security vulnerability reports, please visit the Security Policy (/.github/SECURITY.md).
+- Any questions should create a discussion instead.
+- For any security vulnerability reports, please visit the Security Policy (file: `SECURITY.md`).
 
 ## Pull Requests
 
@@ -30,4 +47,4 @@ If you still confused, try to create a discussion or an issue.
 - Try to avoid a pull request with too many changes if possible.
   - A large pull request not only stretches the review time, but also makes it much harder to spot issues.
   - It is better to split the pull request to multiple smaller ones.
-- If your pull request is not ready but want to save it first, you can submit it by mark as draft, and no need to add any identifications to the title (e.g.: `WIP`).
+- If your pull request is not ready but want to save it first, you can submit it by mark as draft, and no need to add any identifications to the title (e.g.: `[WIP]`).

hugoalh.GitHubActionsToolkit/_get-package-commands.ps1

@@ -0,0 +1,20 @@
+#Requires -PSEdition Core
+#Requires -Version 7.2
+<#
+This script is help for copy members to the file `hugoalh.GitHubActionsToolkit.psd1` for best performance, and use for debug.
+#>
+[String]$PackageName = 'hugoalh.GitHubActionsToolkit'
+@(
+	"$PackageName.psm1"
+) |
+	ForEach-Object -Process { Join-Path -Path $PSScriptRoot -ChildPath $_ } |
+	Import-Module -Scope 'Local'
+[PSCustomObject[]]$PackageCommands = Get-Command -Module $PackageName -ListImported
+ForEach ($CommandType In @('Function', 'Alias')) {
+	$PackageCommands |
+		Where-Object -FilterScript { $_.CommandType -ieq $CommandType } |
+		Select-Object -ExpandProperty 'Name' |
+		Sort-Object |
+		Join-String -Separator ",`n" -SingleQuote |
+		Set-Clipboard -Confirm
+}

hugoalh.GitHubActionsToolkit/_get-package-members.ps1

@@ -3,7 +3,7 @@
 	RootModule = 'hugoalh.GitHubActionsToolkit.psm1'
 
 	# Version number of this module.
-	ModuleVersion = '1.0.0'
+	ModuleVersion = '1.0.1'
 
 	# Supported PSEditions
 	# CompatiblePSEditions = @()

hugoalh.GitHubActionsToolkit/hugoalh.GitHubActionsToolkit.psd1

@@ -1,6 +1,5 @@
 #Requires -PSEdition Core
 #Requires -Version 7.2
-[String]$ModuleRoot = Join-Path -Path $PSScriptRoot -ChildPath 'module'
 [String[]]$ModulesNames = @(
 	'command-base',
 	'artifact',
@@ -16,10 +15,14 @@
 	'tool-cache',
 	'utility'
 )
-Import-Module -Name ($ModulesNames | ForEach-Object -Process {
-	Return (Join-Path -Path $ModuleRoot -ChildPath "$_.psm1")
-}) -Scope 'Local'
+$ModulesNames |
+	ForEach-Object -Process { Join-Path -Path $PSScriptRoot -ChildPath 'module' -AdditionalChildPath "$_.psm1" } |
+	Import-Module -Scope 'Local'
 [PSCustomObject[]]$PackageCommands = Get-Command -Module $ModulesNames -ListImported
-[String[]]$PackageCommandsFunctions = ($PackageCommands | Where-Object -FilterScript { Return ($_.CommandType -ieq 'Function') }).Name
-[String[]]$PackageCommandsAliases = ($PackageCommands | Where-Object -FilterScript { Return ($_.CommandType -ieq 'Alias') }).Name
+[String[]]$PackageCommandsFunctions = $PackageCommands |
+	Where-Object -FilterScript { $_.CommandType -ieq 'Function' } |
+	Select-Object -ExpandProperty 'Name'
+[String[]]$PackageCommandsAliases = $PackageCommands |
+	Where-Object -FilterScript { $_.CommandType -ieq 'Alias' } |
+	Select-Object -ExpandProperty 'Name'
 Export-ModuleMember -Function $PackageCommandsFunctions -Alias $PackageCommandsAliases