[workspace] Deprecate the picosha2 external

geometry/render_gltf_client/BUILD.bazel

@@ -98,7 +98,7 @@ drake_cc_library(
         "//geometry/render:render_camera",
         "//geometry/render:render_engine",
         "//systems/sensors:image",
-        "@picosha2",
+        "@picosha2_internal//:picosha2",
         "@vtk//:vtkIOImage",
     ],
 )

multibody/parsing/BUILD.bazel

@@ -86,7 +86,7 @@ drake_cc_library(
         "//common:network_policy",
         "//common:scope_exit",
         "//common/yaml",
-        "@picosha2",
+        "@picosha2_internal//:picosha2",
         "@tinyxml2_internal//:tinyxml2",
     ],
 )
@@ -637,7 +637,7 @@ drake_cc_googletest(
         "//common:find_resource",
         "//common:scope_exit",
         "//common/test_utilities:expect_throws_message",
-        "@picosha2",
+        "@picosha2_internal//:picosha2",
     ],
 )
 

tools/workspace/BUILD.bazel

@@ -96,6 +96,7 @@ _DRAKE_EXTERNAL_PACKAGE_INSTALLS = ["@%s//:install" % p for p in [
     "nlopt_internal",
     "org_apache_xmlgraphics_commons",
     "petsc",
+    "picosha2_internal",
     "pybind11",
     "qhull_internal",
     "sdformat_internal",

tools/workspace/default.bzl

@@ -68,6 +68,7 @@ load("@drake//tools/workspace/org_apache_xmlgraphics_commons:repository.bzl", "o
 load("@drake//tools/workspace/osqp_internal:repository.bzl", "osqp_internal_repository")  # noqa
 load("@drake//tools/workspace/petsc:repository.bzl", "petsc_repository")
 load("@drake//tools/workspace/picosha2:repository.bzl", "picosha2_repository")
+load("@drake//tools/workspace/picosha2_internal:repository.bzl", "picosha2_internal_repository")  # noqa
 load("@drake//tools/workspace/platforms:repository.bzl", "platforms_repository")  # noqa
 load("@drake//tools/workspace/pybind11:repository.bzl", "pybind11_repository")
 load("@drake//tools/workspace/pycodestyle:repository.bzl", "pycodestyle_repository")  # noqa
@@ -247,7 +248,11 @@ def add_default_repositories(excludes = [], mirrors = DEFAULT_MIRRORS):
     if "petsc" not in excludes:
         petsc_repository(name = "petsc", mirrors = mirrors)
     if "picosha2" not in excludes:
+        # The @picosha2 external is deprecated in Drake's WORKSPACE and will
+        # be removed on or after 2023-11-01.
         picosha2_repository(name = "picosha2", mirrors = mirrors)
+    if "picosha2_internal" not in excludes:
+        picosha2_internal_repository(name = "picosha2_internal", mirrors = mirrors)  # noqa
     if "platforms" not in excludes:
         platforms_repository(name = "platforms", mirrors = mirrors)
     if "pybind11" not in excludes:

tools/workspace/picosha2/package.BUILD.bazel

@@ -15,4 +15,5 @@ cc_library(
     name = "picosha2",
     hdrs = ["picosha2.h"],
     includes = ["."],
+    deprecation = "DRAKE DEPRECATED: The @picosha2 external is deprecated in Drake's WORKSPACE and will be removed on or after 2023-11-01.",  # noqa
 )

tools/workspace/picosha2/repository.bzl

@@ -3,6 +3,9 @@ load("@drake//tools/workspace:github.bzl", "github_archive")
 def picosha2_repository(
         name,
         mirrors = None):
+    """The @picosha2 external is deprecated in Drake's WORKSPACE and will be
+    removed on or after 2023-11-01.
+    """
     github_archive(
         name = name,
         repository = "okdshin/PicoSHA2",

tools/workspace/picosha2_internal/BUILD.bazel

@@ -0,0 +1,3 @@
+load("//tools/lint:lint.bzl", "add_lint_tests")
+
+add_lint_tests()

tools/workspace/picosha2_internal/package.BUILD.bazel

@@ -0,0 +1,23 @@
+# -*- bazel -*-
+
+load(
+    "@drake//tools/install:install.bzl",
+    "install",
+)
+
+licenses(["notice"])  # MIT
+
+package(
+    default_visibility = ["//visibility:public"],
+)
+
+cc_library(
+    name = "picosha2",
+    hdrs = ["picosha2.h"],
+    includes = ["."],
+)
+
+install(
+    name = "install",
+    docs = ["LICENSE"],
+)

tools/workspace/picosha2_internal/patches/vendor.patch

@@ -0,0 +1,18 @@
+Adds a hidden drake_vendor namespace for ODR safety
+
+--- picosha2.h
++++ picosha2.h
+@@ -36,6 +36,7 @@
+ #include <sstream>
+ #include <vector>
+ #include <fstream>
++inline namespace drake_vendor __attribute__ ((visibility ("hidden"))) {
+ namespace picosha2 {
+ typedef unsigned long word_t;
+ typedef unsigned char byte_t;
+@@ -374,4 +375,5 @@
+
+ }
+ }// namespace picosha2
++}// namespace drake_vendor
+ #endif  // PICOSHA2_H

tools/workspace/picosha2_internal/repository.bzl

@@ -0,0 +1,16 @@
+load("@drake//tools/workspace:github.bzl", "github_archive")
+
+def picosha2_internal_repository(
+        name,
+        mirrors = None):
+    github_archive(
+        name = name,
+        repository = "okdshin/PicoSHA2",
+        commit = "27fcf6979298949e8a462e16d09a0351c18fcaf2",
+        sha256 = "18d82bb79c021ccf4ce58125b64691accef54237ba5194462740bacf8b39d8a9",  # noqa
+        build_file = ":package.BUILD.bazel",
+        patches = [
+            ":patches/vendor.patch",
+        ],
+        mirrors = mirrors,
+    )