From c78169e4850aaada14b8c5cc8a76edda557ecfea Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Mon, 11 Nov 2024 16:06:01 +0000
Subject: [PATCH 01/15] bump: update dependencies

---
 CHANGELOG.md | 4 ++++
 MODULE.bazel | 4 ++--
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 9ad1b78..b18d31a 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -67,6 +67,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [NEXT.VERSION]
 
+### Changed
+
+- Update dependencies (stardoc 0.6.2 -> 0.7.1, platforms 0.0.5 -> 0.0.10)
+
 [1.0.0]: https://github.com/TendTo/rules_doxygen/tree/1.0.0
 [1.1.0]: https://github.com/TendTo/rules_doxygen/compare/1.0.0...1.1.0
 [1.1.1]: https://github.com/TendTo/rules_doxygen/compare/1.1.0...1.1.1
diff --git a/MODULE.bazel b/MODULE.bazel
index da26679..e98e7de 100644
--- a/MODULE.bazel
+++ b/MODULE.bazel
@@ -1,5 +1,5 @@
 """rules_doxygen module"""
 module(name = "rules_doxygen", version = "1.2.0", compatibility_level = 1)
 
-bazel_dep(name = "platforms", version = "0.0.5")
-bazel_dep(name = "stardoc", version = "0.6.2", dev_dependency = True)
+bazel_dep(name = "platforms", version = "0.0.10")
+bazel_dep(name = "stardoc", version = "0.7.1", dev_dependency = True)

From 00df5b41abd051a8ac62d8944f3dd5ddf7dabef4 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 14:43:22 +0000
Subject: [PATCH 02/15] chore: move doxygen repository files in subfolder

---
 BUILD.bazel                                    | 6 +++---
 doxygen.BUILD.bazel => doxygen/BUILD.bazel     | 8 ++------
 Doxyfile.template => doxygen/Doxyfile.template | 0
 doxygen.bzl => doxygen/doxygen.bzl             | 0
 4 files changed, 5 insertions(+), 9 deletions(-)
 rename doxygen.BUILD.bazel => doxygen/BUILD.bazel (57%)
 rename Doxyfile.template => doxygen/Doxyfile.template (100%)
 rename doxygen.bzl => doxygen/doxygen.bzl (100%)

diff --git a/BUILD.bazel b/BUILD.bazel
index 6971a21..b82ee54 100644
--- a/BUILD.bazel
+++ b/BUILD.bazel
@@ -1,8 +1,8 @@
 """rules_doxygen BUILD file"""
 
 exports_files([
-    "Doxyfile.template",
-    "doxygen.BUILD.bazel",
-    "doxygen.bzl",
+    "doxygen/Doxyfile.template",
+    "doxygen/doxygen.BUILD.bazel",
+    "doxygen/doxygen.bzl",
     "extensions.bzl",
 ])
diff --git a/doxygen.BUILD.bazel b/doxygen/BUILD.bazel
similarity index 57%
rename from doxygen.BUILD.bazel
rename to doxygen/BUILD.bazel
index 695f370..f93e97a 100644
--- a/doxygen.BUILD.bazel
+++ b/doxygen/BUILD.bazel
@@ -1,15 +1,11 @@
 """Doxygen BUILD file"""
 
-filegroup(
-    name = "Doxyfile.template",
-    srcs = ["@rules_doxygen//:Doxyfile.template"],
-    visibility = ["//visibility:public"],
-)
+exports_files(["Doxyfile.template"])
 
 filegroup(
     name = "executable",
     srcs = select({
-        "@platforms//os:linux": ["bin/doxygen"],
+        "@platforms//os:linux": ["doxygen"],
         "@platforms//os:macos": ["doxygen"],
         "@platforms//os:windows": ["doxygen.exe"],
     }, "Unsupported platform"),
diff --git a/Doxyfile.template b/doxygen/Doxyfile.template
similarity index 100%
rename from Doxyfile.template
rename to doxygen/Doxyfile.template
diff --git a/doxygen.bzl b/doxygen/doxygen.bzl
similarity index 100%
rename from doxygen.bzl
rename to doxygen/doxygen.bzl

From 429574a8576def02d7412fbc5f5ef797768ab8f4 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 14:44:14 +0000
Subject: [PATCH 03/15] feat: refactor repository to add macos support

---
 extensions.bzl | 147 ++++++++++++++++++++++++++++++++-----------------
 1 file changed, 98 insertions(+), 49 deletions(-)

diff --git a/extensions.bzl b/extensions.bzl
index dec84a9..8348242 100644
--- a/extensions.bzl
+++ b/extensions.bzl
@@ -1,8 +1,9 @@
 """Repository rule for downloading the correct version of doxygen using module extensions."""
 
-load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
+load("@bazel_tools//tools/build_defs/repo:cache.bzl", "get_default_canonical_id")
+load("@bazel_tools//tools/build_defs/repo:utils.bzl", "get_auth")
 
-def _local_repository_doxygen(ctx):
+def _doxygen_repository(ctx):
     """
     Repository rule for doxygen.
 
@@ -18,31 +19,103 @@ def _local_repository_doxygen(ctx):
     ctx.file("BUILD.bazel", ctx.read(ctx.attr.build))
     ctx.file("Doxyfile.template", ctx.read(ctx.attr.doxyfile_template))
 
-    # Copy the doxygen executable to the repository
-    doxygen_content = ctx.read(ctx.attr.executable or ctx.which("doxygen"))
+    doxygen_version = ctx.attr.version
+
+    # If the version is set to 0.0.0 use the installed version of doxygen from the PATH
+    if doxygen_version == "0.0.0":
+        if ctx.os.name.startswith("windows"):
+            ctx.file("doxygen.exe", ctx.read(ctx.which("doxygen")), legacy_utf8 = False)
+        else:
+            ctx.file("doxygen", ctx.read(ctx.which("doxygen")), legacy_utf8 = False)
+        return
+
+    doxygen_version_dash = doxygen_version.replace(".", "_")
+
+    url = "https://github.com/doxygen/doxygen/releases/download/Release_%s/doxygen-%s.%s"
+
     if ctx.os.name.startswith("windows"):
-        ctx.file("doxygen.exe", doxygen_content, legacy_utf8 = False)
+        # For windows, download the zip file and extract the executable
+        url = url % (doxygen_version_dash, doxygen_version, "windows.x64.bin.zip")
+        ctx.download_and_extract(
+            url = url,
+            sha256 = ctx.attr.sha256,
+            type = "zip",
+            canonical_id = get_default_canonical_id(ctx, [url]),
+            auth = get_auth(ctx, [url]),
+        )
+
     elif ctx.os.name.startswith("mac"):
-        ctx.file("doxygen", doxygen_content, legacy_utf8 = False)
+        # For mac, download the dmg file, mount it and copy the executable
+        url = url % (doxygen_version_dash, doxygen_version, "dmg")
+        ctx.download(
+            url = url,
+            sha256 = ctx.attr.sha256,
+            canonical_id = get_default_canonical_id(ctx, [url]),
+            auth = get_auth(ctx, [url]),
+        )
+
+        # Mount the dmg file
+        ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mouontpoint", "Doxygen", "doxygen-%s.dmg" % doxygen_version])
+
+        # Copy the doxygen executable to the repository
+        ctx.file("doxygen", ctx.read("Doxygen/Applications/Doxygen.app/Contents/Resources/doxygen"), legacy_utf8 = False)
+
+        # Unmount the dmg file
+        ctx.execute(["hdiutil", "detach", "Doxygen"])
+
+        # Delete the temporary files
+        ctx.delete("doxygen-%s.dmg" % doxygen_version)
+
     elif ctx.os.name == "linux":
-        ctx.file("bin/doxygen", doxygen_content, legacy_utf8 = False)
+        # For linux, download the tar.gz file and extract the executable
+        url = url % (doxygen_version_dash, doxygen_version, "linux.bin.tar.gz")
+        ctx.download_and_extract(
+            url = url,
+            sha256 = ctx.attr.sha256,
+            type = "tar.gz",
+            canonical_id = get_default_canonical_id(ctx, [url]),
+            auth = get_auth(ctx, [url]),
+            stripPrefix = "doxygen-%s" % doxygen_version,
+        )
+
+        # Copy the doxygen executable to the repository
+        ctx.file("doxygen", ctx.read("bin/doxygen"), legacy_utf8 = False)
+
+        # Delete other temporary files
+        for file in ("bin", "examples", "html", "man"):
+            ctx.delete(file)
     else:
         fail("Unsuppported OS: %s" % ctx.os.name)
 
-local_repository_doxygen = repository_rule(
-    implementation = _local_repository_doxygen,
+doxygen_repository = repository_rule(
+    implementation = _doxygen_repository,
     doc = """
 Repository rule for doxygen.
 
-Used to create a local repository for doxygen, containing the installed doxygen binary and all the necessary files to run the doxygen macro.
-In order to use this rule, you must have doxygen installed on your system and the binary (named doxygen) must available in the PATH.
-Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
+Depending on the version, the behavior will change:
+- If the version is set to `0.0.0`, the repository will use the installed version of doxygen, getting the binary from the PATH.
+- If a version is specified, the repository will download the correct version of doxygen and make it available to the requesting module.
+
+> [!Note]  
+> The local installation version of the rules needs doxygen to be installed on your system and the binary (named doxygen) must available in the PATH.
+> Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
+
+You can further customize the repository by specifying the `doxygen_bzl`, `build`, and `doxyfile_template` attributes, but the default values should be enough for most use cases.
 
 ### Example
 
 ```starlark
-local_repository_doxygen(
+# Download the os specific version 1.12.0 of doxygen
+doxygen_repository(
     name = "doxygen",
+    version = "1.12.0",
+    sha256 = "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138",
+)
+
+# Use the system installed version of doxygen
+doxygen_repository(
+    name = "doxygen",
+    version = "0.0.0",
 )
 ```
 """,
@@ -50,23 +123,25 @@ local_repository_doxygen(
         "doxygen_bzl": attr.label(
             doc = "The starlark file containing the doxygen macro",
             allow_single_file = True,
-            default = Label("@rules_doxygen//:doxygen.bzl"),
+            default = Label("@rules_doxygen//doxygen:doxygen.bzl"),
         ),
         "build": attr.label(
             doc = "The BUILD file of the repository",
             allow_single_file = True,
-            default = Label("@rules_doxygen//:doxygen.BUILD.bazel"),
+            default = Label("@rules_doxygen//doxygen:BUILD.bazel"),
         ),
         "doxyfile_template": attr.label(
             doc = "The Doxyfile template to use",
             allow_single_file = True,
-            default = Label("@rules_doxygen//:Doxyfile.template"),
+            default = Label("@rules_doxygen//doxygen:Doxyfile.template"),
         ),
-        "executable": attr.label(
-            executable = True,
-            cfg = "exec",
-            allow_single_file = True,
-            doc = "The doxygen executable to use. Must refer to an executable file. Defaults to the doxygen executable in the PATH.",
+        "sha256": attr.string(
+            doc = "The sha256 hash of the doxygen archive. If not specified, an all-zero hash will be used.",
+            default = "0" * 64,
+        ),
+        "version": attr.string(
+            doc = "The version of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH",
+            mandatory = True,
         ),
     },
 )
@@ -83,7 +158,6 @@ def _doxygen_extension_impl(ctx):
         if len(mod.tags.version) > 1:
             fail("Only one version of doxygen can be specified")
         doxygen_version = "1.12.0"
-        strip_prefix = ""
         if ctx.os.name.startswith("windows"):
             doxygen_sha256 = "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138"
         elif ctx.os.name.startswith("mac"):
@@ -97,35 +171,10 @@ def _doxygen_extension_impl(ctx):
             doxygen_version = attr.version if attr.version != "" else fail("Version must be specified")
             doxygen_sha256 = attr.sha256 if attr.sha256 != "" else "0" * 64
 
-        if doxygen_version == "0.0.0":
-            local_repository_doxygen(
-                name = "doxygen",
-            )
-            return
-
-        doxygen_version_dash = doxygen_version.replace(".", "_")
-
-        url = "https://github.com/doxygen/doxygen/releases/download/Release_%s/doxygen-%s.%s"
-        if ctx.os.name.startswith("windows"):
-            url = url % (doxygen_version_dash, doxygen_version, "windows.x64.bin.zip")
-        elif ctx.os.name.startswith("mac"):  # TODO: support macos for hermetic build
-            url = url % (doxygen_version_dash, doxygen_version, "dmg")
-            fail("Unsuppported OS: %s" % ctx.os.name)
-        elif ctx.os.name == "linux":
-            url = url % (doxygen_version_dash, doxygen_version, "linux.bin.tar.gz")
-            strip_prefix = "doxygen-%s" % doxygen_version
-        else:
-            fail("Unsuppported OS: %s" % ctx.os.name)
-
-        doxygen_bzl_content = ctx.read(Label("@rules_doxygen//:doxygen.bzl"))
-        http_archive(
+        doxygen_repository(
             name = "doxygen",
-            build_file = "@rules_doxygen//:doxygen.BUILD.bazel",
-            url = url,
             sha256 = doxygen_sha256,
-            patch_cmds = ["cat > 'doxygen.bzl' <<- EOF\n%s\nEOF" % doxygen_bzl_content],
-            patch_cmds_win = ["Set-Content -Path 'doxygen.bzl' -Value '%s'" % doxygen_bzl_content],
-            strip_prefix = strip_prefix,
+            version = doxygen_version,
         )
 
 _doxygen_version = tag_class(attrs = {

From c702f29cf09215920360bbd082a252a76f2cbb74 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 14:45:47 +0000
Subject: [PATCH 04/15] ci: add macos tests

---
 .bcr/presubmit.yml       | 2 +-
 .github/workflows/ci.yml | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/.bcr/presubmit.yml b/.bcr/presubmit.yml
index 55c56ed..04023f7 100644
--- a/.bcr/presubmit.yml
+++ b/.bcr/presubmit.yml
@@ -1,7 +1,7 @@
 bcr_test_module:
   module_path: "examples"
   matrix:
-    platform: ["fedora40", "ubuntu2204", "windows"]
+    platform: ["fedora40", "ubuntu2204", "windows", "macos"]
     bazel: [7.x]
   tasks:
     run_tests:
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 313f386..4a6f47a 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -10,7 +10,7 @@ jobs:
   tests:
     strategy:
       matrix:
-        os: [ubuntu-latest, windows-latest] # No macOS for now
+        os: [ubuntu-latest, windows-latest, macos-latest]
         subdir: [base, kwargs, doxyfile, latex, nested, custom, awesome]
     runs-on: ${{ matrix.os }}
 

From 51deb8eae9bd4bd8404a3069181a0fc2be54da5b Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 14:51:44 +0000
Subject: [PATCH 05/15] fix: add missing output in ctx.download

---
 extensions.bzl | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/extensions.bzl b/extensions.bzl
index 8348242..d6e145a 100644
--- a/extensions.bzl
+++ b/extensions.bzl
@@ -49,13 +49,14 @@ def _doxygen_repository(ctx):
         url = url % (doxygen_version_dash, doxygen_version, "dmg")
         ctx.download(
             url = url,
+            output = "doxygen.dmg",
             sha256 = ctx.attr.sha256,
             canonical_id = get_default_canonical_id(ctx, [url]),
             auth = get_auth(ctx, [url]),
         )
 
         # Mount the dmg file
-        ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mouontpoint", "Doxygen", "doxygen-%s.dmg" % doxygen_version])
+        ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mouontpoint", "Doxygen", "doxygen.dmg"])
 
         # Copy the doxygen executable to the repository
         ctx.file("doxygen", ctx.read("Doxygen/Applications/Doxygen.app/Contents/Resources/doxygen"), legacy_utf8 = False)

From 52492c08d1992d4210ffdf75367f0cc4583af664 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 14:55:32 +0000
Subject: [PATCH 06/15] fix: dmg mounted doxygen path

---
 extensions.bzl | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/extensions.bzl b/extensions.bzl
index d6e145a..2c26112 100644
--- a/extensions.bzl
+++ b/extensions.bzl
@@ -56,16 +56,16 @@ def _doxygen_repository(ctx):
         )
 
         # Mount the dmg file
-        ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mouontpoint", "Doxygen", "doxygen.dmg"])
+        ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mountpoint", "doxygen-mount", "doxygen.dmg"])
 
         # Copy the doxygen executable to the repository
-        ctx.file("doxygen", ctx.read("Doxygen/Applications/Doxygen.app/Contents/Resources/doxygen"), legacy_utf8 = False)
+        ctx.file("doxygen", ctx.read("doxygen-mount/Doxygen.app/Contents/Resources/doxygen"), legacy_utf8 = False)
 
         # Unmount the dmg file
-        ctx.execute(["hdiutil", "detach", "Doxygen"])
+        ctx.execute(["hdiutil", "detach", "doxygen-mount"])
 
         # Delete the temporary files
-        ctx.delete("doxygen-%s.dmg" % doxygen_version)
+        ctx.delete("doxygen.dmg")
 
     elif ctx.os.name == "linux":
         # For linux, download the tar.gz file and extract the executable

From 1e7111f85c1c74d762da825d3d789abdb6c7f1ff Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 15:33:17 +0000
Subject: [PATCH 07/15] fix: exported files miss-match

---
 BUILD.bazel         |  7 +------
 doxygen/BUILD.bazel | 18 ++++++++++++------
 2 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/BUILD.bazel b/BUILD.bazel
index b82ee54..0f95292 100644
--- a/BUILD.bazel
+++ b/BUILD.bazel
@@ -1,8 +1,3 @@
 """rules_doxygen BUILD file"""
 
-exports_files([
-    "doxygen/Doxyfile.template",
-    "doxygen/doxygen.BUILD.bazel",
-    "doxygen/doxygen.bzl",
-    "extensions.bzl",
-])
+exports_files(["extensions.bzl"])
diff --git a/doxygen/BUILD.bazel b/doxygen/BUILD.bazel
index f93e97a..8f39cf4 100644
--- a/doxygen/BUILD.bazel
+++ b/doxygen/BUILD.bazel
@@ -1,13 +1,19 @@
 """Doxygen BUILD file"""
 
-exports_files(["Doxyfile.template"])
+exports_files([
+    "Doxyfile.template",
+    "doxygen.bzl",
+])
 
 filegroup(
     name = "executable",
-    srcs = select({
-        "@platforms//os:linux": ["doxygen"],
-        "@platforms//os:macos": ["doxygen"],
-        "@platforms//os:windows": ["doxygen.exe"],
-    }, "Unsupported platform"),
+    srcs = select(
+        {
+            "@platforms//os:linux": ["doxygen"],
+            "@platforms//os:macos": ["doxygen"],
+            "@platforms//os:windows": ["doxygen.exe"],
+        },
+        "Unsupported platform",
+    ),
     visibility = ["//visibility:public"],
 )

From 835d725ced3cdd4aa81bc1c8b9402eb93cbe03ce Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 15:34:59 +0000
Subject: [PATCH 08/15] bump: version 1.3.0

---
 CHANGELOG.md | 11 +++++++++--
 MODULE.bazel |  2 +-
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b18d31a..d41f494 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -65,11 +65,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Default doxygen version is now `1.12.0`
 
-## [NEXT.VERSION]
+## [1.3.0]
+
+### Added
+
+- Support hermetic build for `macos` platform
 
 ### Changed
 
 - Update dependencies (stardoc 0.6.2 -> 0.7.1, platforms 0.0.5 -> 0.0.10)
+- Refactor of internal repository and extension rules
+- Updated documentation
 
 [1.0.0]: https://github.com/TendTo/rules_doxygen/tree/1.0.0
 [1.1.0]: https://github.com/TendTo/rules_doxygen/compare/1.0.0...1.1.0
@@ -77,4 +83,5 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [1.1.2]: https://github.com/TendTo/rules_doxygen/compare/1.1.1...1.1.2
 [1.1.3]: https://github.com/TendTo/rules_doxygen/compare/1.1.2...1.1.3
 [1.2.0]: https://github.com/TendTo/rules_doxygen/compare/1.1.3...1.2.0
-[NEXT.VERSION]: https://github.com/TendTo/rules_doxygen/compare/1.2.0...HEAD
+[1.3.0]: https://github.com/TendTo/rules_doxygen/compare/1.2.0...1.3.0
+[NEXT.VERSION]: https://github.com/TendTo/rules_doxygen/compare/1.3.0...HEAD
diff --git a/MODULE.bazel b/MODULE.bazel
index e98e7de..a49350f 100644
--- a/MODULE.bazel
+++ b/MODULE.bazel
@@ -1,5 +1,5 @@
 """rules_doxygen module"""
-module(name = "rules_doxygen", version = "1.2.0", compatibility_level = 1)
+module(name = "rules_doxygen", version = "1.3.0", compatibility_level = 1)
 
 bazel_dep(name = "platforms", version = "0.0.10")
 bazel_dep(name = "stardoc", version = "0.7.1", dev_dependency = True)

From f428bdeda3b875e6ddc54900806f62e498c25e9b Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 15:36:16 +0000
Subject: [PATCH 09/15] docs: update documentation

---
 CHANGELOG.md           |  2 ++
 README.md              | 14 +++++++++++--
 docs/doxygen_doc.md    |  2 ++
 docs/extensions_doc.md | 46 ++++++++++++++++++++++++++++++------------
 doxygen/doxygen.bzl    |  2 +-
 extensions.bzl         |  2 ++
 6 files changed, 52 insertions(+), 16 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index d41f494..eb32dd6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -77,6 +77,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Refactor of internal repository and extension rules
 - Updated documentation
 
+## [NEXT.VERSION]
+
 [1.0.0]: https://github.com/TendTo/rules_doxygen/tree/1.0.0
 [1.1.0]: https://github.com/TendTo/rules_doxygen/compare/1.0.0...1.1.0
 [1.1.1]: https://github.com/TendTo/rules_doxygen/compare/1.1.0...1.1.1
diff --git a/README.md b/README.md
index 98e5474..601bd9a 100644
--- a/README.md
+++ b/README.md
@@ -9,13 +9,17 @@ This repository contains a [Starlark](https://github.com/bazelbuild/starlark) im
 Add the following to your _MODULE.bazel_:
 
 ```bzl
-bazel_dep(name = "rules_doxygen", version = "1.2.0", dev_dependency = True)
+# MODULE.bazel file
+
+bazel_dep(name = "rules_doxygen", version = "1.3.0", dev_dependency = True)
 ```
 
 If you don't want to depend on the [Bazel package registry](https://bazel.build/external/bazelbuild/rules_pkg) or you want to use a not-yet-published version of this module, you can use an archive override by adding the following lines below the `bazel_dep` rule in your _MODULE.bazel_ file:
 
 ```bzl
-bazel_dep(name = "rules_doxygen", version = "1.2.0", dev_dependency = True)
+# MODULE.bazel file
+
+bazel_dep(name = "rules_doxygen", version = "1.3.0", dev_dependency = True)
 archive_override(
     module_name = "rules_doxygen",
     urls = "https://github.com/TendTo/rules_doxygen/archive/refs/heads/main.tar.gz",
@@ -30,6 +34,8 @@ archive_override(
 To select a doxygen version to use, use the `doxygen_extension` module extension below the `bazel_dep` rule in your MODULE.bazel file.
 
 ```bzl
+# MODULE.bazel file
+
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
 use_repo(doxygen_extension, "doxygen")
 ```
@@ -37,6 +43,8 @@ use_repo(doxygen_extension, "doxygen")
 By default, version `1.12.0` of Doxygen is used. To select a different version, indicate it in the `version` module:
 
 ```bzl
+# MODULE.bazel file
+
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
 # Using the 1.10.0 version of Doxygen on Windows instead of the default 1.12.0
 doxygen_extension.version(version = "1.10.0", sha256 = "2135c1d5bdd6e067b3d0c40a4daac5d63d0fee1b3f4d6ef1e4f092db0d632d5b")
@@ -65,6 +73,7 @@ Only the sources are required, the rest of the parameters are optional.
 
 ```bzl
 # My BUILD.bazel file
+
 doxygen(
     name = "doxygen",   # Name of the rule, can be anything
     srcs = glob([       # List of sources to document.
@@ -100,6 +109,7 @@ For example, if the _BUILD.bazel_ file is in the root of the repository, and the
 
 ```bzl
 # BUILD.bazel file in the root of the repository
+
 doxygen(
     name = "doxygen",
     srcs = glob([
diff --git a/docs/doxygen_doc.md b/docs/doxygen_doc.md
index bd24a90..1eb23d3 100755
--- a/docs/doxygen_doc.md
+++ b/docs/doxygen_doc.md
@@ -7,6 +7,8 @@ Doxygen rule for Bazel.
 ## doxygen
 
 <pre>
+load("@doxygen//:doxygen.bzl", "doxygen")
+
 doxygen(<a href="#doxygen-name">name</a>, <a href="#doxygen-srcs">srcs</a>, <a href="#doxygen-project_name">project_name</a>, <a href="#doxygen-project_brief">project_brief</a>, <a href="#doxygen-project_number">project_number</a>, <a href="#doxygen-project_logo">project_logo</a>, <a href="#doxygen-project_icon">project_icon</a>,
         <a href="#doxygen-use_mdfile_as_mainpage">use_mdfile_as_mainpage</a>, <a href="#doxygen-extract_private">extract_private</a>, <a href="#doxygen-html_footer">html_footer</a>, <a href="#doxygen-html_header">html_header</a>, <a href="#doxygen-filter_patterns">filter_patterns</a>,
         <a href="#doxygen-use_mathjax">use_mathjax</a>, <a href="#doxygen-html_extra_stylesheet">html_extra_stylesheet</a>, <a href="#doxygen-html_extra_files">html_extra_files</a>, <a href="#doxygen-html_colorstyle">html_colorstyle</a>, <a href="#doxygen-aliases">aliases</a>, <a href="#doxygen-have_dot">have_dot</a>,
diff --git a/docs/extensions_doc.md b/docs/extensions_doc.md
index 6ca2066..c1bba0a 100755
--- a/docs/extensions_doc.md
+++ b/docs/extensions_doc.md
@@ -2,25 +2,42 @@
 
 Repository rule for downloading the correct version of doxygen using module extensions.
 
-<a id="local_repository_doxygen"></a>
+<a id="doxygen_repository"></a>
 
-## local_repository_doxygen
+## doxygen_repository
 
 <pre>
-local_repository_doxygen(<a href="#local_repository_doxygen-name">name</a>, <a href="#local_repository_doxygen-build">build</a>, <a href="#local_repository_doxygen-doxyfile_template">doxyfile_template</a>, <a href="#local_repository_doxygen-doxygen_bzl">doxygen_bzl</a>, <a href="#local_repository_doxygen-executable">executable</a>, <a href="#local_repository_doxygen-repo_mapping">repo_mapping</a>)
+load("@rules_doxygen//:extensions.bzl", "doxygen_repository")
+
+doxygen_repository(<a href="#doxygen_repository-name">name</a>, <a href="#doxygen_repository-build">build</a>, <a href="#doxygen_repository-doxyfile_template">doxyfile_template</a>, <a href="#doxygen_repository-doxygen_bzl">doxygen_bzl</a>, <a href="#doxygen_repository-repo_mapping">repo_mapping</a>, <a href="#doxygen_repository-sha256">sha256</a>, <a href="#doxygen_repository-version">version</a>)
 </pre>
 
 Repository rule for doxygen.
 
-Used to create a local repository for doxygen, containing the installed doxygen binary and all the necessary files to run the doxygen macro.
-In order to use this rule, you must have doxygen installed on your system and the binary (named doxygen) must available in the PATH.
-Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
+Depending on the version, the behavior will change:
+- If the version is set to `0.0.0`, the repository will use the installed version of doxygen, getting the binary from the PATH.
+- If a version is specified, the repository will download the correct version of doxygen and make it available to the requesting module.
+
+> [!Note]
+> The local installation version of the rules needs doxygen to be installed on your system and the binary (named doxygen) must available in the PATH.
+> Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
+
+You can further customize the repository by specifying the `doxygen_bzl`, `build`, and `doxyfile_template` attributes, but the default values should be enough for most use cases.
 
 ### Example
 
 ```starlark
-local_repository_doxygen(
+# Download the os specific version 1.12.0 of doxygen
+doxygen_repository(
     name = "doxygen",
+    version = "1.12.0",
+    sha256 = "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138",
+)
+
+# Use the system installed version of doxygen
+doxygen_repository(
+    name = "doxygen",
+    version = "0.0.0",
 )
 ```
 
@@ -29,12 +46,13 @@ local_repository_doxygen(
 
 | Name  | Description | Type | Mandatory | Default |
 | :------------- | :------------- | :------------- | :------------- | :------------- |
-| <a id="local_repository_doxygen-name"></a>name |  A unique name for this repository.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
-| <a id="local_repository_doxygen-build"></a>build |  The BUILD file of the repository   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//:doxygen.BUILD.bazel"`  |
-| <a id="local_repository_doxygen-doxyfile_template"></a>doxyfile_template |  The Doxyfile template to use   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//:Doxyfile.template"`  |
-| <a id="local_repository_doxygen-doxygen_bzl"></a>doxygen_bzl |  The starlark file containing the doxygen macro   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//:doxygen.bzl"`  |
-| <a id="local_repository_doxygen-executable"></a>executable |  The doxygen executable to use. Must refer to an executable file. Defaults to the doxygen executable in the PATH.   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `None`  |
-| <a id="local_repository_doxygen-repo_mapping"></a>repo_mapping |  In `WORKSPACE` context only: a dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.<br><br>For example, an entry `"@foo": "@bar"` declares that, for any time this repository depends on `@foo` (such as a dependency on `@foo//some:target`, it should actually resolve that dependency within globally-declared `@bar` (`@bar//some:target`).<br><br>This attribute is _not_ supported in `MODULE.bazel` context (when invoking a repository rule inside a module extension's implementation function).   | <a href="https://bazel.build/rules/lib/dict">Dictionary: String -> String</a> | optional |  |
+| <a id="doxygen_repository-name"></a>name |  A unique name for this repository.   | <a href="https://bazel.build/concepts/labels#target-names">Name</a> | required |  |
+| <a id="doxygen_repository-build"></a>build |  The BUILD file of the repository   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//doxygen:BUILD.bazel"`  |
+| <a id="doxygen_repository-doxyfile_template"></a>doxyfile_template |  The Doxyfile template to use   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//doxygen:Doxyfile.template"`  |
+| <a id="doxygen_repository-doxygen_bzl"></a>doxygen_bzl |  The starlark file containing the doxygen macro   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//doxygen:doxygen.bzl"`  |
+| <a id="doxygen_repository-repo_mapping"></a>repo_mapping |  In `WORKSPACE` context only: a dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.<br><br>For example, an entry `"@foo": "@bar"` declares that, for any time this repository depends on `@foo` (such as a dependency on `@foo//some:target`, it should actually resolve that dependency within globally-declared `@bar` (`@bar//some:target`).<br><br>This attribute is _not_ supported in `MODULE.bazel` context (when invoking a repository rule inside a module extension's implementation function).   | <a href="https://bazel.build/rules/lib/dict">Dictionary: String -> String</a> | optional |  |
+| <a id="doxygen_repository-sha256"></a>sha256 |  The sha256 hash of the doxygen archive. If not specified, an all-zero hash will be used.   | String | optional |  `"0000000000000000000000000000000000000000000000000000000000000000"`  |
+| <a id="doxygen_repository-version"></a>version |  The version of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH   | String | required |  |
 
 
 <a id="doxygen_extension"></a>
@@ -68,6 +86,8 @@ Keep in mind that this will break the hermeticity of your build, as it will now
 ### Example
 
 ```starlark
+# MODULE.bazel file
+
 bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
 
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
diff --git a/doxygen/doxygen.bzl b/doxygen/doxygen.bzl
index b5329fd..733b37d 100644
--- a/doxygen/doxygen.bzl
+++ b/doxygen/doxygen.bzl
@@ -183,7 +183,7 @@ def doxygen(
         hide_in_body_docs: Whether to hide in body docs.
         exclude_symbols: A list of symbols to exclude.
         example_path: The path to the examples. They must be added to the source files.
-        dot_executable: Label of the doxygen executable. Make sure it is also added to the `srcs` of the macro 
+        dot_executable: Label of the doxygen executable. Make sure it is also added to the `srcs` of the macro
         configurations: A list of additional configuration parameters to pass to Doxygen.
         doxyfile_template: The template file to use to generate the Doxyfile.
             The following substitutions are available:<br>
diff --git a/extensions.bzl b/extensions.bzl
index 2c26112..2016e12 100644
--- a/extensions.bzl
+++ b/extensions.bzl
@@ -209,6 +209,8 @@ Keep in mind that this will break the hermeticity of your build, as it will now
 ### Example
 
 ```starlark
+# MODULE.bazel file
+
 bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
 
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")

From bb87c8cf8fe968093550a8ab84656fd6a406fdd6 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 15:41:51 +0000
Subject: [PATCH 10/15] docs: fix wrong target, swap parameter order

---
 docs/BUILD.bazel |  2 +-
 extensions.bzl   | 16 ++++++++--------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/BUILD.bazel b/docs/BUILD.bazel
index ef22604..4fbf878 100644
--- a/docs/BUILD.bazel
+++ b/docs/BUILD.bazel
@@ -13,7 +13,7 @@ bzl_library(
 stardoc(
     name = "doxygen_doc",
     out = "doxygen_doc.md",
-    input = "@rules_doxygen//:doxygen.bzl",
+    input = "@rules_doxygen//doxygen:doxygen.bzl",
 )
 
 stardoc(
diff --git a/extensions.bzl b/extensions.bzl
index 2016e12..5089443 100644
--- a/extensions.bzl
+++ b/extensions.bzl
@@ -121,6 +121,14 @@ doxygen_repository(
 ```
 """,
     attrs = {
+        "version": attr.string(
+            doc = "The version of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH",
+            mandatory = True,
+        ),
+        "sha256": attr.string(
+            doc = "The sha256 hash of the doxygen archive. If not specified, an all-zero hash will be used.",
+            default = "0" * 64,
+        ),
         "doxygen_bzl": attr.label(
             doc = "The starlark file containing the doxygen macro",
             allow_single_file = True,
@@ -136,14 +144,6 @@ doxygen_repository(
             allow_single_file = True,
             default = Label("@rules_doxygen//doxygen:Doxyfile.template"),
         ),
-        "sha256": attr.string(
-            doc = "The sha256 hash of the doxygen archive. If not specified, an all-zero hash will be used.",
-            default = "0" * 64,
-        ),
-        "version": attr.string(
-            doc = "The version of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH",
-            mandatory = True,
-        ),
     },
 )
 

From 6d13c633401fb10d71828dfe613854fa10810cc1 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 15:45:57 +0000
Subject: [PATCH 11/15] chore: proper attribution

---
 CHANGELOG.md | 2 +-
 README.md    | 1 -
 2 files changed, 1 insertion(+), 2 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index eb32dd6..5a89fec 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -69,7 +69,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-- Support hermetic build for `macos` platform
+- Support hermetic build for `macos` platform (thanks to @kaycebasques)
 
 ### Changed
 
diff --git a/README.md b/README.md
index 601bd9a..88c6ac4 100644
--- a/README.md
+++ b/README.md
@@ -145,5 +145,4 @@ tar -czvf doxygen.tar.gz bazel-bin/<subpackage>/html
 
 ## TODO
 
-- [ ] Add support for macos other than the system-wide doxygen installation (I can't be bothered :D)
 - [ ] Add more easy-to-use common configuration for the Doxyfile

From 15a66464c7b7cfee4097f729d586b442d395bc69 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 17:14:54 +0000
Subject: [PATCH 12/15] chore: shorten README snippets

---
 README.md | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index 88c6ac4..a0b84b6 100644
--- a/README.md
+++ b/README.md
@@ -24,7 +24,7 @@ archive_override(
     module_name = "rules_doxygen",
     urls = "https://github.com/TendTo/rules_doxygen/archive/refs/heads/main.tar.gz",
     strip_prefix = "rules_doxygen-main",
-    # The SHA256 checksum of the archive file, based on the rules' version, for reproducibility
+    # The SHA256 checksum of the archive file, based on the rules' version
     # integrity = "sha256-0SCaZuAerluoDs6HXMb0Bj9FttZVieM4+Dpd9gnMM+o=", # Example
 )
 ```
@@ -47,7 +47,10 @@ By default, version `1.12.0` of Doxygen is used. To select a different version,
 
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
 # Using the 1.10.0 version of Doxygen on Windows instead of the default 1.12.0
-doxygen_extension.version(version = "1.10.0", sha256 = "2135c1d5bdd6e067b3d0c40a4daac5d63d0fee1b3f4d6ef1e4f092db0d632d5b")
+doxygen_extension.version(
+    version = "1.10.0",
+    sha256 = "2135c1d5bdd6e067b3d0c40a4daac5d63d0fee1b3f4d6ef1e4f092db0d632d5b",
+)
 use_repo(doxygen_extension, "doxygen")
 ```
 
@@ -82,12 +85,13 @@ doxygen(
     ]) + ["README.md"],
     project_brief = "Example project for doxygen",  # Brief description of the project
     project_name = "base",                          # Name of the project
-    configurations = [                              # Additional configurations to add to the Doxyfile
-        "GENERATE_HTML = YES",                      # They are the same as the Doxyfile options,
-        "GENERATE_LATEX = NO",                      # and will override the default values
+    configurations = [                              # Customizable configurations
+        "GENERATE_HTML = YES",                      # that override the default ones
+        "GENERATE_LATEX = NO",                      # from the Doxyfile
         "USE_MDFILE_AS_MAINPAGE = README.md",
     ]
-    tags = ["manual"]  # Tags to add to the target. This way the target won't run unless explicitly called
+    tags = ["manual"]  # Tags to add to the target. 
+                       # This way the target won't run unless explicitly called
 )
 ```
 

From 6ee170cb0538714202aecca4bc25039ec31ebef4 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 17:24:39 +0000
Subject: [PATCH 13/15] ref: delete anything which is not the doxygen binary

---
 extensions.bzl | 27 ++++++++++++++++-----------
 1 file changed, 16 insertions(+), 11 deletions(-)

diff --git a/extensions.bzl b/extensions.bzl
index 5089443..d4b9137 100644
--- a/extensions.bzl
+++ b/extensions.bzl
@@ -29,34 +29,40 @@ def _doxygen_repository(ctx):
             ctx.file("doxygen", ctx.read(ctx.which("doxygen")), legacy_utf8 = False)
         return
 
-    doxygen_version_dash = doxygen_version.replace(".", "_")
-
     url = "https://github.com/doxygen/doxygen/releases/download/Release_%s/doxygen-%s.%s"
+    doxygen_version_dash = doxygen_version.replace(".", "_")
+    download_output = ""
 
     if ctx.os.name.startswith("windows"):
         # For windows, download the zip file and extract the executable
         url = url % (doxygen_version_dash, doxygen_version, "windows.x64.bin.zip")
+        download_output = "doxygen-dir"
         ctx.download_and_extract(
             url = url,
+            output = download_output,
             sha256 = ctx.attr.sha256,
             type = "zip",
             canonical_id = get_default_canonical_id(ctx, [url]),
             auth = get_auth(ctx, [url]),
         )
 
+        # Copy the doxygen executable to the repository
+        ctx.file("doxygen.exe", ctx.read("doxygen-dir/doxygen.exe"), legacy_utf8 = False)
+
     elif ctx.os.name.startswith("mac"):
         # For mac, download the dmg file, mount it and copy the executable
         url = url % (doxygen_version_dash, doxygen_version, "dmg")
+        download_output = "doxygen.dmg"
         ctx.download(
             url = url,
-            output = "doxygen.dmg",
+            output = download_output,
             sha256 = ctx.attr.sha256,
             canonical_id = get_default_canonical_id(ctx, [url]),
             auth = get_auth(ctx, [url]),
         )
 
         # Mount the dmg file
-        ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mountpoint", "doxygen-mount", "doxygen.dmg"])
+        ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mountpoint", "doxygen-mount", download_output])
 
         # Copy the doxygen executable to the repository
         ctx.file("doxygen", ctx.read("doxygen-mount/Doxygen.app/Contents/Resources/doxygen"), legacy_utf8 = False)
@@ -64,14 +70,13 @@ def _doxygen_repository(ctx):
         # Unmount the dmg file
         ctx.execute(["hdiutil", "detach", "doxygen-mount"])
 
-        # Delete the temporary files
-        ctx.delete("doxygen.dmg")
-
     elif ctx.os.name == "linux":
         # For linux, download the tar.gz file and extract the executable
         url = url % (doxygen_version_dash, doxygen_version, "linux.bin.tar.gz")
+        download_output = "doxygen-dir"
         ctx.download_and_extract(
             url = url,
+            output = download_output,
             sha256 = ctx.attr.sha256,
             type = "tar.gz",
             canonical_id = get_default_canonical_id(ctx, [url]),
@@ -80,14 +85,14 @@ def _doxygen_repository(ctx):
         )
 
         # Copy the doxygen executable to the repository
-        ctx.file("doxygen", ctx.read("bin/doxygen"), legacy_utf8 = False)
+        ctx.file("doxygen", ctx.read("doxygen-dir/bin/doxygen"), legacy_utf8 = False)
 
-        # Delete other temporary files
-        for file in ("bin", "examples", "html", "man"):
-            ctx.delete(file)
     else:
         fail("Unsuppported OS: %s" % ctx.os.name)
 
+    # Delete temporary files
+    ctx.delete(download_output)
+
 doxygen_repository = repository_rule(
     implementation = _doxygen_repository,
     doc = """

From 36dfc710d3e73c66d4a9d3fcd68a48779fb6d5d9 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 17:27:43 +0000
Subject: [PATCH 14/15] fix: missing dll for windows

---
 extensions.bzl | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/extensions.bzl b/extensions.bzl
index d4b9137..ee57ef1 100644
--- a/extensions.bzl
+++ b/extensions.bzl
@@ -31,12 +31,11 @@ def _doxygen_repository(ctx):
 
     url = "https://github.com/doxygen/doxygen/releases/download/Release_%s/doxygen-%s.%s"
     doxygen_version_dash = doxygen_version.replace(".", "_")
-    download_output = ""
+    download_output = "doxygen-dir"
 
     if ctx.os.name.startswith("windows"):
-        # For windows, download the zip file and extract the executable
+        # For windows, download the zip file and extract the executable and dll
         url = url % (doxygen_version_dash, doxygen_version, "windows.x64.bin.zip")
-        download_output = "doxygen-dir"
         ctx.download_and_extract(
             url = url,
             output = download_output,
@@ -46,8 +45,9 @@ def _doxygen_repository(ctx):
             auth = get_auth(ctx, [url]),
         )
 
-        # Copy the doxygen executable to the repository
+        # Copy the doxygen executable (and dll) to the repository
         ctx.file("doxygen.exe", ctx.read("doxygen-dir/doxygen.exe"), legacy_utf8 = False)
+        ctx.file("libclang.dll", ctx.read("doxygen-dir/libclang.dll"), legacy_utf8 = False)
 
     elif ctx.os.name.startswith("mac"):
         # For mac, download the dmg file, mount it and copy the executable
@@ -73,7 +73,6 @@ def _doxygen_repository(ctx):
     elif ctx.os.name == "linux":
         # For linux, download the tar.gz file and extract the executable
         url = url % (doxygen_version_dash, doxygen_version, "linux.bin.tar.gz")
-        download_output = "doxygen-dir"
         ctx.download_and_extract(
             url = url,
             output = download_output,

From 5f4e2965e8cfde0c39593406d2dbbf8de5d723f4 Mon Sep 17 00:00:00 2001
From: Ernesto Casablanca <casablancaernesto@gmail.com>
Date: Fri, 15 Nov 2024 19:32:47 +0000
Subject: [PATCH 15/15] feat: support platform-specific configurations

---
 .github/workflows/ci.yml |  37 +++++
 CHANGELOG.md             |   1 +
 README.md                |  51 +++++--
 docs/extensions_doc.md   | 105 ++++++++++++--
 doxygen/BUILD.bazel      |   6 +-
 examples/MODULE.bazel    |   9 +-
 extensions.bzl           | 305 ++++++++++++++++++++++++++-------------
 7 files changed, 378 insertions(+), 136 deletions(-)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 4a6f47a..a28cb65 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -50,3 +50,40 @@ jobs:
         with:
           files: "examples/bazel-bin/${{ matrix.subdir }}/html/index.html"
           fail: true
+
+  tests-multiple-installations:
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        subdir: [base, kwargs, doxyfile, latex, nested, custom, awesome]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install doxygen
+        uses: ssciwr/doxygen-install@v1
+      - name: Enable use of windows doxygen by decommenting the module extension line
+        uses: richardrigutins/replace-in-files@v2
+        with:
+          search-text: '# doxygen_extension.version(version = "1.11.0", sha256 = "478fc9897d00ca181835d248a4d3e5c83c26a32d1c7571f4321ddb0f2e97459f", platform = "windows")'
+          replacement-text: doxygen_extension.version(version = "1.11.0", sha256 = "478fc9897d00ca181835d248a4d3e5c83c26a32d1c7571f4321ddb0f2e97459f", platform = "windows")
+          files: examples/MODULE.bazel
+      - name: Enable use of mac doxygen by decommenting the module extension line
+        uses: richardrigutins/replace-in-files@v2
+        with:
+          search-text: '# doxygen_extension.version(version = "1.12.0", sha256 = "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001", platform = "mac")'
+          replacement-text: doxygen_extension.version(version = "1.12.0", sha256 = "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001", platform = "mac")
+          files: examples/MODULE.bazel
+      - name: Enable use linux doxygen by decommenting the module extension line
+        uses: richardrigutins/replace-in-files@v2
+        with:
+          search-text: '# doxygen_extension.version(version = "1.10.0", sha256 = "dcfc9aa4cc05aef1f0407817612ad9e9201d9bf2ce67cecf95a024bba7d39747", platform = "linux")'
+          replacement-text: doxygen_extension.version(version = "1.10.0", sha256 = "dcfc9aa4cc05aef1f0407817612ad9e9201d9bf2ce67cecf95a024bba7d39747", platform = "linux")
+          files: examples/MODULE.bazel
+      - name: Build ${{ matrix.subdir }}
+        run: bazel build //${{ matrix.subdir }}:doxygen
+        working-directory: examples
+      - name: Check output
+        uses: andstor/file-existence-action@v3
+        with:
+          files: "examples/bazel-bin/${{ matrix.subdir }}/html/index.html"
+          fail: true
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5a89fec..23a8c6b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -70,6 +70,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - Support hermetic build for `macos` platform (thanks to @kaycebasques)
+- Support for platform-specific configurations in the extension rule
 
 ### Changed
 
diff --git a/README.md b/README.md
index a0b84b6..f9a334b 100644
--- a/README.md
+++ b/README.md
@@ -36,24 +36,14 @@ To select a doxygen version to use, use the `doxygen_extension` module extension
 ```bzl
 # MODULE.bazel file
 
+bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
+
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
 use_repo(doxygen_extension, "doxygen")
 ```
 
 By default, version `1.12.0` of Doxygen is used. To select a different version, indicate it in the `version` module:
 
-```bzl
-# MODULE.bazel file
-
-doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
-# Using the 1.10.0 version of Doxygen on Windows instead of the default 1.12.0
-doxygen_extension.version(
-    version = "1.10.0",
-    sha256 = "2135c1d5bdd6e067b3d0c40a4daac5d63d0fee1b3f4d6ef1e4f092db0d632d5b",
-)
-use_repo(doxygen_extension, "doxygen")
-```
-
 If you don't know the SHA256 of the Doxygen binary, just leave it empty.
 The build will fail with an error message containing the correct SHA256.
 
@@ -63,7 +53,40 @@ Download from https://github.com/doxygen/doxygen/releases/download/Release_1_10_
 
 If you set the version to `0.0.0`, the doxygen executable will be assumed to be available from the PATH.
 No download will be performed and bazel will use the installed version of doxygen.
-Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
+
+> [!Warning]  
+> Setting the version to `0.0.0` this will break the hermeticity of your build, as it will now depend on the environment.
+
+The module also supports multiple versions of doxygen for different platforms.
+Each will only be downloaded if the given platform matches the current platform.
+
+> [!Tip]  
+> Not indicating the platform will make the configuration apply to all platforms.
+> The build will fail when the downloaded file does not match the SHA256 checksum, i.e. when the platform changes.
+> Unless you are using a system-wide doxygen installation, you should always specify the platform.
+
+```bzl
+# MODULE.bazel file
+
+bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
+
+doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
+
+# Download doxygen version 1.10.0 on linux
+doxygen_extension.version(
+    version = "1.10.0",
+    sha256 = "dcfc9aa4cc05aef1f0407817612ad9e9201d9bf2ce67cecf95a024bba7d39747",
+    platform = "linux",
+)
+# Use the local doxygen installation on mac
+doxygen_extension.version(
+    version = "0.0.0",
+    platform = "mac",
+)
+# Since no configuration has been provided, windows will fallback to the default version
+
+use_repo(doxygen_extension, "doxygen")
+```
 
 > [!Note]
 > See [the documentation](docs/extensions_doc.md) for more information.
@@ -90,7 +113,7 @@ doxygen(
         "GENERATE_LATEX = NO",                      # from the Doxyfile
         "USE_MDFILE_AS_MAINPAGE = README.md",
     ]
-    tags = ["manual"]  # Tags to add to the target. 
+    tags = ["manual"]  # Tags to add to the target.
                        # This way the target won't run unless explicitly called
 )
 ```
diff --git a/docs/extensions_doc.md b/docs/extensions_doc.md
index c1bba0a..847be0e 100755
--- a/docs/extensions_doc.md
+++ b/docs/extensions_doc.md
@@ -9,17 +9,19 @@ Repository rule for downloading the correct version of doxygen using module exte
 <pre>
 load("@rules_doxygen//:extensions.bzl", "doxygen_repository")
 
-doxygen_repository(<a href="#doxygen_repository-name">name</a>, <a href="#doxygen_repository-build">build</a>, <a href="#doxygen_repository-doxyfile_template">doxyfile_template</a>, <a href="#doxygen_repository-doxygen_bzl">doxygen_bzl</a>, <a href="#doxygen_repository-repo_mapping">repo_mapping</a>, <a href="#doxygen_repository-sha256">sha256</a>, <a href="#doxygen_repository-version">version</a>)
+doxygen_repository(<a href="#doxygen_repository-name">name</a>, <a href="#doxygen_repository-build">build</a>, <a href="#doxygen_repository-doxyfile_template">doxyfile_template</a>, <a href="#doxygen_repository-doxygen_bzl">doxygen_bzl</a>, <a href="#doxygen_repository-platforms">platforms</a>, <a href="#doxygen_repository-repo_mapping">repo_mapping</a>, <a href="#doxygen_repository-sha256s">sha256s</a>,
+                   <a href="#doxygen_repository-versions">versions</a>)
 </pre>
 
 Repository rule for doxygen.
 
+It can be provided with a configuration for each of the three platforms (windows, mac, linux) to download the correct version of doxygen only when the configuration matches the current platform.
 Depending on the version, the behavior will change:
 - If the version is set to `0.0.0`, the repository will use the installed version of doxygen, getting the binary from the PATH.
 - If a version is specified, the repository will download the correct version of doxygen and make it available to the requesting module.
 
-> [!Note]
-> The local installation version of the rules needs doxygen to be installed on your system and the binary (named doxygen) must available in the PATH.
+> [!Warning]
+> If version is set to `0.0.0`, the rules needs doxygen to be installed on your system and the binary (named doxygen) must available in the PATH.
 > Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
 
 You can further customize the repository by specifying the `doxygen_bzl`, `build`, and `doxyfile_template` attributes, but the default values should be enough for most use cases.
@@ -27,17 +29,24 @@ You can further customize the repository by specifying the `doxygen_bzl`, `build
 ### Example
 
 ```starlark
-# Download the os specific version 1.12.0 of doxygen
+# Download the os specific version 1.12.0 of doxygen supporting all platforms
 doxygen_repository(
     name = "doxygen",
-    version = "1.12.0",
-    sha256 = "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138",
+    versions = ["1.12.0", "1.12.0", "1.12.0"],
+    sha256s = [
+        "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138",
+        "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001",
+        "3c42c3f3fb206732b503862d9c9c11978920a8214f223a3950bbf2520be5f647",
+    ]
+    platforms = ["windows", "mac", "linux"],
 )
 
-# Use the system installed version of doxygen
+# Use the system installed version of doxygen on linux and download version 1.11.0 for windows. No support for mac
 doxygen_repository(
     name = "doxygen",
-    version = "0.0.0",
+    version = ["0.0.0", "1.11.0"],
+    sha256s = ["", "478fc9897d00ca181835d248a4d3e5c83c26a32d1c7571f4321ddb0f2e97459f"],
+    platforms = ["linux", "windows"],
 )
 ```
 
@@ -50,9 +59,10 @@ doxygen_repository(
 | <a id="doxygen_repository-build"></a>build |  The BUILD file of the repository   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//doxygen:BUILD.bazel"`  |
 | <a id="doxygen_repository-doxyfile_template"></a>doxyfile_template |  The Doxyfile template to use   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//doxygen:Doxyfile.template"`  |
 | <a id="doxygen_repository-doxygen_bzl"></a>doxygen_bzl |  The starlark file containing the doxygen macro   | <a href="https://bazel.build/concepts/labels">Label</a> | optional |  `"@rules_doxygen//doxygen:doxygen.bzl"`  |
+| <a id="doxygen_repository-platforms"></a>platforms |  List of platforms to download the doxygen binary for. Available options are (windows, mac, linux). Must be the same length as `version` and `sha256s`.   | List of strings | required |  |
 | <a id="doxygen_repository-repo_mapping"></a>repo_mapping |  In `WORKSPACE` context only: a dictionary from local repository name to global repository name. This allows controls over workspace dependency resolution for dependencies of this repository.<br><br>For example, an entry `"@foo": "@bar"` declares that, for any time this repository depends on `@foo` (such as a dependency on `@foo//some:target`, it should actually resolve that dependency within globally-declared `@bar` (`@bar//some:target`).<br><br>This attribute is _not_ supported in `MODULE.bazel` context (when invoking a repository rule inside a module extension's implementation function).   | <a href="https://bazel.build/rules/lib/dict">Dictionary: String -> String</a> | optional |  |
-| <a id="doxygen_repository-sha256"></a>sha256 |  The sha256 hash of the doxygen archive. If not specified, an all-zero hash will be used.   | String | optional |  `"0000000000000000000000000000000000000000000000000000000000000000"`  |
-| <a id="doxygen_repository-version"></a>version |  The version of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH   | String | required |  |
+| <a id="doxygen_repository-sha256s"></a>sha256s |  List of sha256 hashes of the doxygen archive. Must be the same length as `versions and `platforms`.   | List of strings | required |  |
+| <a id="doxygen_repository-versions"></a>versions |  List of versions of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH. Must be the same length as `sha256s` and `platforms`.   | List of strings | required |  |
 
 
 <a id="doxygen_extension"></a>
@@ -61,7 +71,7 @@ doxygen_repository(
 
 <pre>
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
-doxygen_extension.version(<a href="#doxygen_extension.version-sha256">sha256</a>, <a href="#doxygen_extension.version-version">version</a>)
+doxygen_extension.version(<a href="#doxygen_extension.version-platform">platform</a>, <a href="#doxygen_extension.version-sha256">sha256</a>, <a href="#doxygen_extension.version-version">version</a>)
 </pre>
 
 Module extension for declaring the doxygen version to use.
@@ -81,9 +91,37 @@ Download from https://github.com/doxygen/doxygen/releases/download/Release_1_10_
 
 If you set the version to `0.0.0`, the doxygen executable will be assumed to be available from the PATH.
 No download will be performed and bazel will use the installed version of doxygen.
-Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
 
-### Example
+> [!Warning]
+> Setting the version to `0.0.0` this will break the hermeticity of your build, as it will now depend on the environment.
+
+The module also supports multiple versions of doxygen for different platforms.
+Each will only be downloaded if the given platform matches the current platform.
+
+> [!Tip]
+> Not indicating the platform will make the configuration apply to all platforms.
+> The build will fail when the downloaded file does not match the SHA256 checksum, i.e. when the platform changes.
+> Unless you are using a system-wide doxygen installation, you should always specify the platform.
+
+### Examples
+
+```starlark
+# MODULE.bazel file
+
+bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
+
+doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
+
+# Using the 1.10.0 version of Doxygen instead of the default 1.12.0.
+# Note that che checksum is correct only if the platform is windows.
+# If the platform is different, the build will fail.
+doxygen_extension.version(
+    version = "1.10.0",
+    sha256 = "2135c1d5bdd6e067b3d0c40a4daac5d63d0fee1b3f4d6ef1e4f092db0d632d5b",
+)
+
+use_repo(doxygen_extension, "doxygen")
+```
 
 ```starlark
 # MODULE.bazel file
@@ -92,8 +130,44 @@ bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
 
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
 
-# Using the 1.10.0 version of Doxygen on Windows instead of the default 1.12.0
-doxygen_extension.version(version = "1.10.0", sha256 = "2135c1d5bdd6e067b3d0c40a4daac5d63d0fee1b3f4d6ef1e4f092db0d632d5b")
+doxygen_extension.version(
+    version = "1.10.0",
+    sha256 = "dcfc9aa4cc05aef1f0407817612ad9e9201d9bf2ce67cecf95a024bba7d39747",
+    platform = "linux",
+)
+doxygen_extension.version(
+    version = "1.12.0",
+    sha256 = "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001",
+    platform = "mac",
+)
+doxygen_extension.version(
+    version = "1.11.0",
+    sha256 = "478fc9897d00ca181835d248a4d3e5c83c26a32d1c7571f4321ddb0f2e97459f",
+    platform = "windows",
+)
+
+use_repo(doxygen_extension, "doxygen")
+```
+
+```bzl
+# MODULE.bazel file
+
+bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
+
+doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
+
+# Download doxygen version 1.10.0 on linux
+doxygen_extension.version(
+    version = "1.10.0",
+    sha256 = "dcfc9aa4cc05aef1f0407817612ad9e9201d9bf2ce67cecf95a024bba7d39747",
+    platform = "linux",
+)
+# Use the local doxygen installation on mac
+doxygen_extension.version(
+    version = "0.0.0",
+    platform = "mac",
+)
+# Since no configuration has been provided, windows will fallback to the default version
 
 use_repo(doxygen_extension, "doxygen")
 ```
@@ -109,6 +183,7 @@ use_repo(doxygen_extension, "doxygen")
 
 | Name  | Description | Type | Mandatory | Default |
 | :------------- | :------------- | :------------- | :------------- | :------------- |
+| <a id="doxygen_extension.version-platform"></a>platform |  The target platform for the doxygen binary. Available options are (windows, mac, linux). If not specified, it will select the platform it is currently running on.   | String | optional |  `""`  |
 | <a id="doxygen_extension.version-sha256"></a>sha256 |  The sha256 hash of the doxygen archive. If not specified, an all-zero hash will be used.   | String | optional |  `""`  |
 | <a id="doxygen_extension.version-version"></a>version |  The version of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH   | String | required |  |
 
diff --git a/doxygen/BUILD.bazel b/doxygen/BUILD.bazel
index 8f39cf4..b463064 100644
--- a/doxygen/BUILD.bazel
+++ b/doxygen/BUILD.bazel
@@ -9,9 +9,9 @@ filegroup(
     name = "executable",
     srcs = select(
         {
-            "@platforms//os:linux": ["doxygen"],
-            "@platforms//os:macos": ["doxygen"],
-            "@platforms//os:windows": ["doxygen.exe"],
+            "@platforms//os:linux": ["linux/doxygen"],
+            "@platforms//os:macos": ["mac/doxygen"],
+            "@platforms//os:windows": ["windows/doxygen.exe"],
         },
         "Unsupported platform",
     ),
diff --git a/examples/MODULE.bazel b/examples/MODULE.bazel
index 9dbdfb3..33c4ad4 100644
--- a/examples/MODULE.bazel
+++ b/examples/MODULE.bazel
@@ -7,6 +7,13 @@ local_path_override(
 )
 
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
-# Test doxygen_extension with a system installation of doxygen
+
+# doxygen_extension with a system installation of doxygen
 # doxygen_extension.version(version = "0.0.0")
+
+# Multiple versions of doxygen for different platforms
+# doxygen_extension.version(version = "1.10.0", sha256 = "dcfc9aa4cc05aef1f0407817612ad9e9201d9bf2ce67cecf95a024bba7d39747", platform = "linux")
+# doxygen_extension.version(version = "1.12.0", sha256 = "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001", platform = "mac")
+# doxygen_extension.version(version = "1.11.0", sha256 = "478fc9897d00ca181835d248a4d3e5c83c26a32d1c7571f4321ddb0f2e97459f", platform = "windows")
+
 use_repo(doxygen_extension, "doxygen")
diff --git a/extensions.bzl b/extensions.bzl
index ee57ef1..59b0ec6 100644
--- a/extensions.bzl
+++ b/extensions.bzl
@@ -14,95 +14,102 @@ def _doxygen_repository(ctx):
     """
 
     # Copy the necessary files to the repository by reading them from the current repository
+    if len(ctx.attr.versions) != len(ctx.attr.sha256s) or len(ctx.attr.versions) != len(ctx.attr.platforms):
+        fail("The number of versions, sha256s and platforms must be the same")
+    for platform in ctx.attr.platforms:
+        if platform not in ("windows", "mac", "linux"):
+            fail("Unsupported platform: '%s'. Available options are (windows, mac, linux)" % platform)
+
     ctx.file("WORKSPACE", "workspace(name = %s)\n" % repr(ctx.name))
     ctx.file("doxygen.bzl", ctx.read(ctx.attr.doxygen_bzl))
     ctx.file("BUILD.bazel", ctx.read(ctx.attr.build))
     ctx.file("Doxyfile.template", ctx.read(ctx.attr.doxyfile_template))
 
-    doxygen_version = ctx.attr.version
-
-    # If the version is set to 0.0.0 use the installed version of doxygen from the PATH
-    if doxygen_version == "0.0.0":
-        if ctx.os.name.startswith("windows"):
-            ctx.file("doxygen.exe", ctx.read(ctx.which("doxygen")), legacy_utf8 = False)
-        else:
-            ctx.file("doxygen", ctx.read(ctx.which("doxygen")), legacy_utf8 = False)
-        return
-
-    url = "https://github.com/doxygen/doxygen/releases/download/Release_%s/doxygen-%s.%s"
-    doxygen_version_dash = doxygen_version.replace(".", "_")
-    download_output = "doxygen-dir"
-
-    if ctx.os.name.startswith("windows"):
-        # For windows, download the zip file and extract the executable and dll
-        url = url % (doxygen_version_dash, doxygen_version, "windows.x64.bin.zip")
-        ctx.download_and_extract(
-            url = url,
-            output = download_output,
-            sha256 = ctx.attr.sha256,
-            type = "zip",
-            canonical_id = get_default_canonical_id(ctx, [url]),
-            auth = get_auth(ctx, [url]),
-        )
-
-        # Copy the doxygen executable (and dll) to the repository
-        ctx.file("doxygen.exe", ctx.read("doxygen-dir/doxygen.exe"), legacy_utf8 = False)
-        ctx.file("libclang.dll", ctx.read("doxygen-dir/libclang.dll"), legacy_utf8 = False)
-
-    elif ctx.os.name.startswith("mac"):
-        # For mac, download the dmg file, mount it and copy the executable
-        url = url % (doxygen_version_dash, doxygen_version, "dmg")
-        download_output = "doxygen.dmg"
-        ctx.download(
-            url = url,
-            output = download_output,
-            sha256 = ctx.attr.sha256,
-            canonical_id = get_default_canonical_id(ctx, [url]),
-            auth = get_auth(ctx, [url]),
-        )
-
-        # Mount the dmg file
-        ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mountpoint", "doxygen-mount", download_output])
-
-        # Copy the doxygen executable to the repository
-        ctx.file("doxygen", ctx.read("doxygen-mount/Doxygen.app/Contents/Resources/doxygen"), legacy_utf8 = False)
-
-        # Unmount the dmg file
-        ctx.execute(["hdiutil", "detach", "doxygen-mount"])
-
-    elif ctx.os.name == "linux":
-        # For linux, download the tar.gz file and extract the executable
-        url = url % (doxygen_version_dash, doxygen_version, "linux.bin.tar.gz")
-        ctx.download_and_extract(
-            url = url,
-            output = download_output,
-            sha256 = ctx.attr.sha256,
-            type = "tar.gz",
-            canonical_id = get_default_canonical_id(ctx, [url]),
-            auth = get_auth(ctx, [url]),
-            stripPrefix = "doxygen-%s" % doxygen_version,
-        )
-
-        # Copy the doxygen executable to the repository
-        ctx.file("doxygen", ctx.read("doxygen-dir/bin/doxygen"), legacy_utf8 = False)
-
-    else:
-        fail("Unsuppported OS: %s" % ctx.os.name)
-
-    # Delete temporary files
-    ctx.delete(download_output)
+    for doxygen_version, sha256, platform in zip(ctx.attr.versions, ctx.attr.sha256s, ctx.attr.platforms):
+        # If the version is set to 0.0.0 use the installed version of doxygen from the PATH
+        # No download will be performed
+        # This happens only if the platform matches the current platform
+        if doxygen_version == "0.0.0":
+            if platform == "windows" and ctx.os.name.startswith("windows"):
+                ctx.file("windows/doxygen.exe", ctx.read(ctx.which("doxygen")), legacy_utf8 = False)
+            elif platform == "mac" and ctx.os.name.startswith("mac"):
+                ctx.file("mac/doxygen", ctx.read(ctx.which("doxygen")), legacy_utf8 = False)
+            elif platform == "linux" and ctx.os.name == "linux":
+                ctx.file("linux/doxygen", ctx.read(ctx.which("doxygen")), legacy_utf8 = False)
+            continue
+
+        url = "https://github.com/doxygen/doxygen/releases/download/Release_%s/doxygen-%s.%s"
+        doxygen_version_dash = doxygen_version.replace(".", "_")
+        download_output = "doxygen-dir"
+
+        if platform == "windows" and ctx.os.name.startswith("windows"):
+            # For windows, download the zip file and extract the executable and dll
+            url = url % (doxygen_version_dash, doxygen_version, "windows.x64.bin.zip")
+            ctx.download_and_extract(
+                url = url,
+                output = download_output,
+                sha256 = sha256,
+                type = "zip",
+                canonical_id = get_default_canonical_id(ctx, [url]),
+                auth = get_auth(ctx, [url]),
+            )
+
+            # Copy the doxygen executable (and dll) to the repository
+            ctx.file("windows/doxygen.exe", ctx.read("doxygen-dir/doxygen.exe"), legacy_utf8 = False)
+            ctx.file("windows/libclang.dll", ctx.read("doxygen-dir/libclang.dll"), legacy_utf8 = False)
+
+        elif platform == "mac" and ctx.os.name.startswith("mac"):
+            # For mac, download the dmg file, mount it and copy the executable
+            url = url % (doxygen_version_dash, doxygen_version, "dmg")
+            download_output = "doxygen.dmg"
+            ctx.download(
+                url = url,
+                output = download_output,
+                sha256 = sha256,
+                canonical_id = get_default_canonical_id(ctx, [url]),
+                auth = get_auth(ctx, [url]),
+            )
+
+            # Mount the dmg file
+            ctx.execute(["hdiutil", "attach", "-nobrowse", "-readonly", "-mountpoint", "doxygen-mount", download_output])
+
+            # Copy the doxygen executable to the repository
+            ctx.file("mac/doxygen", ctx.read("doxygen-mount/Doxygen.app/Contents/Resources/doxygen"), legacy_utf8 = False)
+
+            # Unmount the dmg file
+            ctx.execute(["hdiutil", "detach", "doxygen-mount"])
+
+        elif platform == "linux" and ctx.os.name == "linux":
+            # For linux, download the tar.gz file and extract the executable
+            url = url % (doxygen_version_dash, doxygen_version, "linux.bin.tar.gz")
+            ctx.download_and_extract(
+                url = url,
+                output = download_output,
+                sha256 = sha256,
+                type = "tar.gz",
+                canonical_id = get_default_canonical_id(ctx, [url]),
+                auth = get_auth(ctx, [url]),
+                stripPrefix = "doxygen-%s" % doxygen_version,
+            )
+
+            # Copy the doxygen executable to the repository
+            ctx.file("linux/doxygen", ctx.read("doxygen-dir/bin/doxygen"), legacy_utf8 = False)
+
+        # Delete temporary files
+        ctx.delete(download_output)
 
 doxygen_repository = repository_rule(
     implementation = _doxygen_repository,
     doc = """
 Repository rule for doxygen.
 
+It can be provided with a configuration for each of the three platforms (windows, mac, linux) to download the correct version of doxygen only when the configuration matches the current platform.
 Depending on the version, the behavior will change:
 - If the version is set to `0.0.0`, the repository will use the installed version of doxygen, getting the binary from the PATH.
 - If a version is specified, the repository will download the correct version of doxygen and make it available to the requesting module.
 
-> [!Note]  
-> The local installation version of the rules needs doxygen to be installed on your system and the binary (named doxygen) must available in the PATH.
+> [!Warning]  
+> If version is set to `0.0.0`, the rules needs doxygen to be installed on your system and the binary (named doxygen) must available in the PATH.
 > Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
 
 You can further customize the repository by specifying the `doxygen_bzl`, `build`, and `doxyfile_template` attributes, but the default values should be enough for most use cases.
@@ -110,28 +117,42 @@ You can further customize the repository by specifying the `doxygen_bzl`, `build
 ### Example
 
 ```starlark
-# Download the os specific version 1.12.0 of doxygen
+# Download the os specific version 1.12.0 of doxygen supporting all platforms
 doxygen_repository(
     name = "doxygen",
-    version = "1.12.0",
-    sha256 = "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138",
+    versions = ["1.12.0", "1.12.0", "1.12.0"],
+    sha256s = [
+        "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138",
+        "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001",
+        "3c42c3f3fb206732b503862d9c9c11978920a8214f223a3950bbf2520be5f647",
+    ]
+    platforms = ["windows", "mac", "linux"],
 )
 
-# Use the system installed version of doxygen
+# Use the system installed version of doxygen on linux and download version 1.11.0 for windows. No support for mac
 doxygen_repository(
     name = "doxygen",
-    version = "0.0.0",
+    version = ["0.0.0", "1.11.0"],
+    sha256s = ["", "478fc9897d00ca181835d248a4d3e5c83c26a32d1c7571f4321ddb0f2e97459f"],
+    platforms = ["linux", "windows"],
 )
 ```
 """,
     attrs = {
-        "version": attr.string(
-            doc = "The version of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH",
+        "versions": attr.string_list(
+            doc = "List of versions of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH. Must be the same length as `sha256s` and `platforms`.",
+            mandatory = True,
+            allow_empty = False,
+        ),
+        "sha256s": attr.string_list(
+            doc = "List of sha256 hashes of the doxygen archive. Must be the same length as `versions and `platforms`.",
             mandatory = True,
+            allow_empty = False,
         ),
-        "sha256": attr.string(
-            doc = "The sha256 hash of the doxygen archive. If not specified, an all-zero hash will be used.",
-            default = "0" * 64,
+        "platforms": attr.string_list(
+            doc = "List of platforms to download the doxygen binary for. Available options are (windows, mac, linux). Must be the same length as `version` and `sha256s`.",
+            mandatory = True,
+            allow_empty = False,
         ),
         "doxygen_bzl": attr.label(
             doc = "The starlark file containing the doxygen macro",
@@ -160,31 +181,45 @@ def _doxygen_extension_impl(ctx):
         ctx: a [module context](https://bazel.build/rules/lib/builtins/module_ctx) object containing the module's attributes
     """
     for mod in ctx.modules:
-        if len(mod.tags.version) > 1:
-            fail("Only one version of doxygen can be specified")
-        doxygen_version = "1.12.0"
-        if ctx.os.name.startswith("windows"):
-            doxygen_sha256 = "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138"
-        elif ctx.os.name.startswith("mac"):
-            doxygen_sha256 = "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001"
-        elif ctx.os.name == "linux":
-            doxygen_sha256 = "3c42c3f3fb206732b503862d9c9c11978920a8214f223a3950bbf2520be5f647"
-        else:
-            fail("Unsuppported OS: %s" % ctx.os.name)
+        platforms = []
+        versions = []
+        sha256s = []
+
+        default_configurations = {
+            "windows": struct(version = "1.12.0", sha256 = "07f1c92cbbb32816689c725539c0951f92c6371d3d7f66dfa3192cbe88dd3138"),
+            "mac": struct(version = "1.12.0", sha256 = "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001"),
+            "linux": struct(version = "1.12.0", sha256 = "3c42c3f3fb206732b503862d9c9c11978920a8214f223a3950bbf2520be5f647"),
+        }
 
+        # Otherwise, add all the configurations (version and sha256) for each platform
         for attr in mod.tags.version:
-            doxygen_version = attr.version if attr.version != "" else fail("Version must be specified")
-            doxygen_sha256 = attr.sha256 if attr.sha256 != "" else "0" * 64
+            platform = attr.platform if attr.platform != "" else "windows" if ctx.os.name.startswith("windows") else "mac" if ctx.os.name.startswith("mac") else "linux"
+            if platform not in default_configurations:
+                fail("Unsupported platform: '%s'. Available options are (windows, mac, linux)" % platform)
+            if platform in platforms:
+                fail("Doxygen version/sha256 for platform '%s' was already specified: (version = '%s', sha256 = '%s')" % (platform, versions[platforms.index(platform)], sha256s[platforms.index(platform)]))
+            platforms.append(platform)
+            versions.append(attr.version if attr.version != "" else fail("Version must be specified"))
+            sha256s.append(attr.sha256 if attr.sha256 != "" else "0" * 64)
+
+        # If no version is specified for a platform, use the default
+        for platform in default_configurations:
+            if platform not in platforms:
+                platforms.append(platform)
+                versions.append(default_configurations[platform].version)
+                sha256s.append(default_configurations[platform].sha256)
 
         doxygen_repository(
             name = "doxygen",
-            sha256 = doxygen_sha256,
-            version = doxygen_version,
+            versions = versions,
+            sha256s = sha256s,
+            platforms = platforms,
         )
 
 _doxygen_version = tag_class(attrs = {
     "version": attr.string(doc = "The version of doxygen to use. If set to `0.0.0`, the doxygen executable will be assumed to be available from the PATH", mandatory = True),
     "sha256": attr.string(doc = "The sha256 hash of the doxygen archive. If not specified, an all-zero hash will be used."),
+    "platform": attr.string(doc = "The target platform for the doxygen binary. Available options are (windows, mac, linux). If not specified, it will select the platform it is currently running on."),
 })
 
 doxygen_extension = module_extension(
@@ -208,9 +243,37 @@ Download from https://github.com/doxygen/doxygen/releases/download/Release_1_10_
 
 If you set the version to `0.0.0`, the doxygen executable will be assumed to be available from the PATH.
 No download will be performed and bazel will use the installed version of doxygen.
-Keep in mind that this will break the hermeticity of your build, as it will now depend on the environment.
 
-### Example
+> [!Warning]  
+> Setting the version to `0.0.0` this will break the hermeticity of your build, as it will now depend on the environment.
+
+The module also supports multiple versions of doxygen for different platforms.
+Each will only be downloaded if the given platform matches the current platform.
+
+> [!Tip]  
+> Not indicating the platform will make the configuration apply to all platforms.
+> The build will fail when the downloaded file does not match the SHA256 checksum, i.e. when the platform changes.
+> Unless you are using a system-wide doxygen installation, you should always specify the platform.
+
+### Examples
+
+```starlark
+# MODULE.bazel file
+
+bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
+
+doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
+
+# Using the 1.10.0 version of Doxygen instead of the default 1.12.0.
+# Note that che checksum is correct only if the platform is windows.
+# If the platform is different, the build will fail.
+doxygen_extension.version(
+    version = "1.10.0",
+    sha256 = "2135c1d5bdd6e067b3d0c40a4daac5d63d0fee1b3f4d6ef1e4f092db0d632d5b",
+)
+
+use_repo(doxygen_extension, "doxygen")
+```
 
 ```starlark
 # MODULE.bazel file
@@ -219,8 +282,44 @@ bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
 
 doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
 
-# Using the 1.10.0 version of Doxygen on Windows instead of the default 1.12.0
-doxygen_extension.version(version = "1.10.0", sha256 = "2135c1d5bdd6e067b3d0c40a4daac5d63d0fee1b3f4d6ef1e4f092db0d632d5b")
+doxygen_extension.version(
+    version = "1.10.0",
+    sha256 = "dcfc9aa4cc05aef1f0407817612ad9e9201d9bf2ce67cecf95a024bba7d39747",
+    platform = "linux",
+)
+doxygen_extension.version(
+    version = "1.12.0",
+    sha256 = "6ace7dde967d41f4e293d034a67eb2c7edd61318491ee3131112173a77344001",
+    platform = "mac",
+)
+doxygen_extension.version(
+    version = "1.11.0",
+    sha256 = "478fc9897d00ca181835d248a4d3e5c83c26a32d1c7571f4321ddb0f2e97459f",
+    platform = "windows",
+)
+
+use_repo(doxygen_extension, "doxygen")
+```
+
+```bzl
+# MODULE.bazel file
+
+bazel_dep(name = "rules_doxygen", version = "...", dev_dependency = True)
+
+doxygen_extension = use_extension("@rules_doxygen//:extensions.bzl", "doxygen_extension")
+
+# Download doxygen version 1.10.0 on linux
+doxygen_extension.version(
+    version = "1.10.0",
+    sha256 = "dcfc9aa4cc05aef1f0407817612ad9e9201d9bf2ce67cecf95a024bba7d39747",
+    platform = "linux",
+)
+# Use the local doxygen installation on mac
+doxygen_extension.version(
+    version = "0.0.0",
+    platform = "mac",
+)
+# Since no configuration has been provided, windows will fallback to the default version
 
 use_repo(doxygen_extension, "doxygen")
 ```