// Verify GCS Storage client is not initialized before connect() is called
        assertNull(getField(conn, "storage"));
    }

    /**
     * Test that connect() method fails when GCS_PROJECT_ID is not set.
     */
    public void test_connect_failsWithoutProjectId() throws Exception {
        URL url = new URL("gcs://mybucket/object.txt");
        Handler handler = new Handler();

  /**
   * Simulate some of the races that can happen on add. We can't easily simulate the race that
   * happens when an {@link AtomicInteger#compareAndSet} fails, but we can simulate the case where
   * the putIfAbsent returns a non-null value, and the case where the replace() of an observed zero
   * fails.
   */
  public void testAdd_withFailures() {
    AtomicInteger existing = new AtomicInteger(12);

        // Verify MinIO client is not initialized before connect() is called
        assertNull(getField(conn, "minioClient"));
    }

    /**
     * Test that connect() method fails when STORAGE_ENDPOINT is not set.
     */
    public void test_connect_failsWithoutEndpoint() throws Exception {
        URL url = new URL("storage://mybucket/object.txt");
        Handler handler = new Handler();

     * Extracts theme files from the JAR and deploys them to appropriate directories.
     *
     * @param artifact the theme artifact to install
     * @throws ThemeException if installation fails
     */
    public void install(final Artifact artifact) {
        final Path jarPath = getJarFile(artifact);
        final String themeName = getThemeName(artifact);
        if (logger.isDebugEnabled()) {

     *
     * @param objectName the name of the object to update tags for
     * @param tagItems the map of tag items from the form
     * @throws StorageException if the tag update fails
     */
    public static void updateObjectTags(final String objectName, final Map<String, String> tagItems) {
        final Map<String, String> tags = new HashMap<>();

        if (existingCounter.compareAndSet(oldValue, newValue)) {
          if (newValue == 0) {
            // Just CASed to 0; remove the entry to clean up the map. If the removal fails,
            // another thread has already replaced it with a new counter, which is fine.
            countMap.remove(element, existingCounter);
          }
          return oldValue;
        }
      } else {

     * @return a map containing the processed document data
     * @throws CrawlingAccessException if crawling fails or configuration is invalid
     * @throws ChildUrlsException if the URL redirects to another location
     * @throws CrawlerSystemException if data deserialization fails
     */
    public Map<String, Object> processRequest(final CrawlingConfig crawlingConfig, final String crawlingInfoId, final String url) {

     * Removes protocol and path components to return just the hostname.
     *
     * @param u the URL string to extract host from
     * @return the host name, or empty string if URL is blank, or unknown hostname if parsing fails
     */
    default String getHost(final String u) {
        if (StringUtil.isBlank(u)) {
            return StringUtil.EMPTY; // empty
        }

        String url = u;
        final String originalUrl = url;

  Date delayedDate(long delayMillis) {
    return new Date(System.currentTimeMillis() + delayMillis);
  }

  /** The first exception encountered if any threadAssertXXX method fails. */
  private final AtomicReference<Throwable> threadFailure = new AtomicReference<>(null);

  /**
   * Records an exception so that it can be rethrown later in the test harness thread, triggering a

     * @param pluginUrl the URL of the plugin
     * @param version the snapshot version
     * @return the actual version string with timestamp and build number, or null if not found
     * @throws SAXException if XML parsing fails
     * @throws IOException if I/O error occurs
     */
    protected String getSnapshotActualVersion(final DocumentBuilder builder, final String pluginUrl, final String version)
            throws SAXException, IOException {