Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
aalmiray committed Jul 27, 2022
1 parent 9af8340 commit 8c46e91
Show file tree
Hide file tree
Showing 20 changed files with 228 additions and 9 deletions.
1 change: 1 addition & 0 deletions docs/modules/ROOT/pages/distributions/binary.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ Alternatively, you may also configure a xref:configuration:assemble/archive.adoc
[%header, cols="<,^"]
|===
| Packager | Supported
| xref:configuration:packagers/asdf.adoc[] | {icon_req_y}
| xref:configuration:packagers/chocolatey.adoc[] | {icon_req_y}
| xref:configuration:packagers/docker.adoc[] | {icon_req_y}
| xref:configuration:packagers/homebrew.adoc[] | {icon_req_y}
Expand Down
1 change: 1 addition & 0 deletions docs/modules/ROOT/pages/distributions/java-binary.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,7 @@ Alternatively, you may also configure a xref:configuration:assemble/archive.adoc
[%header, cols="<,^"]
|===
| Packager | Supported
| xref:configuration:packagers/asdf.adoc[] | {icon_req_y}
| xref:configuration:packagers/chocolatey.adoc[] | {icon_req_y}
| xref:configuration:packagers/docker.adoc[] | {icon_req_y}
| xref:configuration:packagers/homebrew.adoc[] | {icon_req_y}
Expand Down
1 change: 1 addition & 0 deletions docs/modules/ROOT/pages/distributions/jlink.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -54,6 +54,7 @@ Alternatively, you may also configure a xref:configuration:assemble/jlink.adoc[]
[%header, cols="<,^"]
|===
| Packager | Supported
| xref:configuration:packagers/asdf.adoc[] | {icon_req_y}
| xref:configuration:packagers/chocolatey.adoc[] | {icon_req_y}
| xref:configuration:packagers/docker.adoc[] | {icon_req_y}
| xref:configuration:packagers/homebrew.adoc[] | {icon_req_y}
Expand Down
1 change: 1 addition & 0 deletions docs/modules/ROOT/pages/distributions/native-image.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ Alternatively, you may also configure a xref:configuration:assemble/native-image
[%header, cols="<,^"]
|===
| Packager | Supported
| xref:configuration:packagers/asdf.adoc[] | {icon_req_y}
| xref:configuration:packagers/chocolatey.adoc[] | {icon_req_y}
| xref:configuration:packagers/docker.adoc[] | {icon_req_y}
| xref:configuration:packagers/homebrew.adoc[] | {icon_req_y}
Expand Down
1 change: 1 addition & 0 deletions docs/modules/ROOT/pages/distributions/native-package.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ Alternatively, you may also configure a xref:configuration:assemble/jpackage.ado
[%header, cols="<,^"]
|===
| Packager | Supported
| xref:configuration:packagers/asdf.adoc[] | {icon_req_n}
| xref:configuration:packagers/chocolatey.adoc[] | {icon_req_y}
| xref:configuration:packagers/docker.adoc[] | {icon_req_n}
| xref:configuration:packagers/homebrew.adoc[] | {icon_req_y}
Expand Down
1 change: 1 addition & 0 deletions docs/modules/ROOT/pages/distributions/single-jar.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,7 @@ Make sure the JAR is executable by setting the `Main-Class` manifest entry.
[%header, cols="<,^"]
|===
| Packager | Supported
| xref:configuration:packagers/asdf.adoc[] | {icon_req_n}
| xref:configuration:packagers/chocolatey.adoc[] | {icon_req_n}
| xref:configuration:packagers/docker.adoc[] | {icon_req_y}
| xref:configuration:packagers/homebrew.adoc[] | {icon_req_y}
Expand Down
1 change: 1 addition & 0 deletions docs/modules/ROOT/pages/integrations.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -47,6 +47,7 @@ Artifacts, checksums, signatures may be uploaded to the following services:

xref:distributions/index.adoc[] may be packaged and published with the following tools:

* xref:configuration:packagers/asdf.adoc[]
* xref:configuration:packagers/chocolatey.adoc[]
* xref:configuration:packagers/docker.adoc[]
* xref:configuration:packagers/homebrew.adoc[]
Expand Down
1 change: 1 addition & 0 deletions docs/modules/configuration/nav.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,7 @@
** xref:files.adoc[]
** xref:name-templates.adoc[]
** xref:packagers/index.adoc[]
*** xref:packagers/asdf.adoc[]
*** xref:packagers/chocolatey.adoc[]
*** xref:packagers/docker.adoc[]
*** xref:packagers/gofish.adoc[]
Expand Down
19 changes: 19 additions & 0 deletions docs/modules/configuration/pages/environment.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -484,6 +484,25 @@ The following key/values may be defined as properties or as environment variable
| JRELEASER_ARTIFACTORY_${NAME}_PASSWORD | a password/token matching the named Artifactory instance
|===

=== Asdf

[%header, cols="<1,<1", width="100%"]
|===
| Key | Description
| JRELEASER_HOMEASDF_GITHUB_TOKEN | a GitHub token with `repo` scope
| JRELEASER_HOMEASDF_GITHUB_USERNAME | a GitHub username with commit access
| JRELEASER_HOMEASDF_GITHUB_BRANCH | the branch to use
| JRELEASER_HOMEASDF_GITLAB_TOKEN | a GitLab token with `api` scope
| JRELEASER_HOMEASDF_GITLAB_USERNAME | a GitLab username with commit access
| JRELEASER_HOMEASDF_GITHUB_BRANCH | the branch to use
| JRELEASER_HOMEASDF_GITEA_TOKEN | a Gitea personal token
| JRELEASER_HOMEASDF_GITEA_USERNAME | a Gitea username with commit access
| JRELEASER_HOMEASDF_GITHUB_BRANCH | the branch to use
| JRELEASER_HOMEASDF_CODEBERG_TOKEN | a Codeberg personal token
| JRELEASER_HOMEASDF_CODEBERG_USERNAME | a Codeberg username with commit access
| JRELEASER_HOMEASDF_GITHUB_BRANCH | the branch to use
|===

=== Brew

[%header, cols="<1,<1", width="100%"]
Expand Down
13 changes: 13 additions & 0 deletions docs/modules/configuration/pages/name-templates.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -1058,6 +1058,19 @@ jreleaser {
--
====

== Asdf

The following names are related to xref:configuration:packagers/asdf.adoc[]

[%header, cols="<2,<5", width="100%"]
|===
| Key | Description
| asdfDistributionUrl | the URL required to download the artifact
| asdfDistributionArtifactFile | the name of the artifact file
| asdfDistributionArtifactFileName | the name of the artifact file without extension
|===


== Brew

The following names are related to xref:configuration:packagers/homebrew.adoc[]
Expand Down
179 changes: 179 additions & 0 deletions docs/modules/configuration/pages/packagers/asdf.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,179 @@
= Asdf
:tool_id: asdf
:tool_name: asdf
:tool_env_var: ASDF
:tool_tap: repository
:tool_tap_name: asdf-duke
:tool_manifest: plugin
:tool_package: ${distribution.name}

link:https://asdf-vm.com/[asdf] is a tool version manager.

The following artifact extensions are supported by this packager:

* `.tgz`
* `.txz`
* `.tar.gz`
* `.tar.xz`
* `.tar`
* `.zip`
NOTE: Default templates for `asdf` assume the project relies on xref:configuration:project.adoc#_semver[Semantic Versioning]. You'll have
to adjust the templates or provide your own if your project follows a different versioning scheme.

WARNING: Publication of snapshots is *not* allowed.

include::partial$legend.adoc[]

[tabs]
====
YAML::
+
--
[source,yaml]
[subs="attributes,+macros"]
----
include::partial$packagers/yaml/common-head.adoc[]
include::partial$packagers/yaml/template-directory.adoc[]
include::partial$packagers/yaml/commitauthor.adoc[]
include::partial$packagers/yaml/tap.adoc[]
# Tool verification command.
# Defaults to `{{distributionExecutable}} --version`.
# icon:dot-circle[] icon:file-alt[]
toolCheck: '{{distributionExecutable}} --version'
----
--
TOML::
+
--
[source,toml]
[subs="attributes,+macros"]
----
include::partial$packagers/toml/common-head.adoc[]
include::partial$packagers/toml/template-directory.adoc[]
include::partial$packagers/toml/commitauthor.adoc[]
include::partial$packagers/toml/tap.adoc[]
# Tool verification command.
# Defaults to `{{distributionExecutable}} --version`.
# icon:dot-circle[] icon:file-alt[]
toolCheck = "{{distributionExecutable}} --version"
----
--
JSON::
+
--
[source,json]
[subs="attributes,+macros"]
----
include::partial$packagers/json/common-head.adoc[]
include::partial$packagers/json/template-directory.adoc[]
include::partial$packagers/json/commitauthor.adoc[]
include::partial$packagers/json/tap.adoc[]
// Tool verification command.
// Defaults to `{{distributionExecutable}} --version`.
// icon:dot-circle[] icon:file-alt[]
"toolCheck": "{{distributionExecutable}} --version"
include::partial$packagers/json/common-footer.adoc[]
----
--
Maven::
+
--
[source,xml]
[subs="attributes,verbatim,+macros"]
----
include::partial$packagers/maven/common-head.adoc[]
include::partial$packagers/maven/template-directory.adoc[]
include::partial$packagers/maven/commitauthor.adoc[]
include::partial$packagers/maven/tap.adoc[]
<!--
Tool verification command.
Defaults to `{{distributionExecutable}} --version`.
icon:dot-circle[] icon:file-alt[]
-->
<toolCheck>{{distributionExecutable}} --version</toolCheck>
include::partial$packagers/maven/common-footer.adoc[]
----
--
Gradle::
+
--
[source,groovy]
[subs="attributes,+macros"]
----
include::partial$packagers/gradle/common-head.adoc[]
include::partial$packagers/gradle/template-directory.adoc[]
include::partial$packagers/gradle/commitauthor.adoc[]
include::partial$packagers/gradle/tap.adoc[]
// Tool verification command.
// Defaults to `{{distributionExecutable}} --version`.
// icon:dot-circle[] icon:file-alt[]
toolCheck = '{{distributionExecutable}} --version'
include::partial$packagers/gradle/common-footer.adoc[]
----
--
====

include::partial$packagers/token.adoc[]

include::partial$packagers/downloadUrl.adoc[]

== Skip Artifacts

If there is more than one matching artifact in a given distribution you may add a `skipAsdf` extra property to the target
artifact to mark it as skipped for packaging with asdf.

== Templates

The default location for templates is:

`src/jreleaser/distributions/<distribution-name>/asdf`

The following list shows the filenames that may be used to override default templates:

* `.github/workflows/build.yml.tpl`
* `bin/download.tpl`
* `bin/install.tpl`
* `bin/list-all.tpl`
* `lib/utils.bash.tpl`
* `README.md.tpl`
* `README-github.md.tpl`

Any additional files found in the template directories will be copied as is unless their filename ends with `.tpl` in
which case xref:name-templates.adoc[] substitution will take place.

Templates may be initialized using the `template` command

xref:tools:jreleaser-cli.adoc#_template[{icon_cli_s} template],
xref:tools:jreleaser-maven.adoc#_jreleasertemplate[{icon_maven_s} jreleaser:template],
xref:tools:jreleaser-gradle.adoc#_jreleasertemplate[{icon_gradle_s} jreleaserTemplate],
xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-template]

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
* `README.md`: matches the transformed template name
* `README.*`: matches using a regex
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/chocolatey.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -439,7 +439,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/docker.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -924,7 +924,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/gofish.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -250,7 +250,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/homebrew.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -673,7 +673,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/jbang.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -227,7 +227,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/macports.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -309,7 +309,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/scoop.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -247,7 +247,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/snap.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -730,7 +730,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down
2 changes: 1 addition & 1 deletion docs/modules/configuration/pages/packagers/spec.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -254,7 +254,7 @@ xref:tools:jreleaser-ant.adoc#_jreleaser_template[{icon_ant_s} jreleaser-templat

== Skip Templates

You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example you may use
You may skip any template files by defining a set of skip rules in the `skipTemplates` property. For example, you may use
any of these expressions to skip a template named `README.md.tpl`:

* `README.md.tpl`: matches the full template name
Expand Down

0 comments on commit 8c46e91

Please sign in to comment.