Merge branch 'main' into sm-pq-metadata

deephaven · Mar 15, 2024 · 48906dd · 48906dd
2 parents a529fc2 + 1c8c11f
commit 48906dd
Show file tree

Hide file tree

Showing 8,553 changed files with 74,115 additions and 50,319 deletions.
diff --git a/.github/workflows/create-docs-issues.js b/.github/workflows/create-docs-issues.js
@@ -1,5 +1,5 @@
 module.exports = async ({ github, context }) => {
-  const ISSUE_REPO_NAME = "deephaven.io";
+  const ISSUE_REPO_NAME = "deephaven-docs-community";
   const ISSUE_TYPES = ["Community"];
 
   const body =
@@ -15,7 +15,7 @@ module.exports = async ({ github, context }) => {
       repo: ISSUE_REPO_NAME,
       title: `${context.payload.pull_request.title}`,
       body,
-      labels: [type, "documentation", "triage", "autogenerated"],
+      labels: ["triage", "autogenerated"],
     })
   );
 

diff --git a/.github/workflows/publish-ci.yml b/.github/workflows/publish-ci.yml
@@ -113,5 +113,5 @@ jobs:
         if: ${{ startsWith(github.ref, 'refs/heads/release/v') }}
         env:
           NODE_AUTH_TOKEN: ${{ secrets.DEEPHAVENBOT_NPM_TOKEN }}
-        run: npm publish --tag latest web/client-api/types/build/deephaven-jsapi-types-*.tgz
+        run: npm publish --provenance --tag latest web/client-api/types/build/deephaven-jsapi-types-*.tgz
         continue-on-error: true
diff --git a/Base/build.gradle b/Base/build.gradle
@@ -33,7 +33,7 @@ sourceSets {
 
 // TODO (core#116): Gradle test fixtures
 task jarTests(type: Jar, dependsOn: testClasses) {
-    classifier = 'tests'
+    archiveClassifier = 'tests'
     from sourceSets.test.output
 }
 configurations {
@@ -44,11 +44,3 @@ configurations {
 artifacts {
     tests jarTests
 }
-
-spotless {
-    java {
-        targetExclude(
-                '**/ringbuffer/Aggregating*RingBuffer*.java'
-        )
-    }
-}
diff --git a/Base/src/main/java/io/deephaven/base/ArrayUtil.java b/Base/src/main/java/io/deephaven/base/ArrayUtil.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import io.deephaven.base.verify.Require;

diff --git a/Base/src/main/java/io/deephaven/base/AtomicUtil.java b/Base/src/main/java/io/deephaven/base/AtomicUtil.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import java.util.concurrent.atomic.AtomicInteger;

diff --git a/Base/src/main/java/io/deephaven/base/Base64.java b/Base/src/main/java/io/deephaven/base/Base64.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 /* copied from java.util.prefs; but allow the class to be public */

diff --git a/Base/src/main/java/io/deephaven/base/ClampUtil.java b/Base/src/main/java/io/deephaven/base/ClampUtil.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 public class ClampUtil {

diff --git a/Base/src/main/java/io/deephaven/base/ClassUtil.java b/Base/src/main/java/io/deephaven/base/ClassUtil.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import org.apache.commons.lang3.ClassUtils;

diff --git a/Base/src/main/java/io/deephaven/base/CompareUtils.java b/Base/src/main/java/io/deephaven/base/CompareUtils.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 public class CompareUtils {

diff --git a/Base/src/main/java/io/deephaven/base/Copyable.java b/Base/src/main/java/io/deephaven/base/Copyable.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 public interface Copyable<T> extends SafeCloneable<T> {

diff --git a/Base/src/main/java/io/deephaven/base/Encodeable.java b/Base/src/main/java/io/deephaven/base/Encodeable.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import java.io.DataInput;

diff --git a/Base/src/main/java/io/deephaven/base/FIFOMutex.java b/Base/src/main/java/io/deephaven/base/FIFOMutex.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import java.util.concurrent.atomic.AtomicReference;

diff --git a/Base/src/main/java/io/deephaven/base/FIFOSemaphore.java b/Base/src/main/java/io/deephaven/base/FIFOSemaphore.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import io.deephaven.base.verify.Assert;

diff --git a/Base/src/main/java/io/deephaven/base/Factory.java b/Base/src/main/java/io/deephaven/base/Factory.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 public interface Factory<T> {

diff --git a/Base/src/main/java/io/deephaven/base/FatalErrorHandler.java b/Base/src/main/java/io/deephaven/base/FatalErrorHandler.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 /**

diff --git a/Base/src/main/java/io/deephaven/base/FatalErrorHandlerFactory.java b/Base/src/main/java/io/deephaven/base/FatalErrorHandlerFactory.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 public interface FatalErrorHandlerFactory {

diff --git a/Base/src/main/java/io/deephaven/base/FileUtils.java b/Base/src/main/java/io/deephaven/base/FileUtils.java
@@ -1,13 +1,16 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import io.deephaven.base.verify.Assert;
 import io.deephaven.base.verify.Require;
 import org.jetbrains.annotations.Nullable;
 
 import java.io.*;
+import java.net.URI;
+import java.net.URISyntaxException;
+import java.nio.file.Path;
 import java.util.ArrayList;
 
 public class FileUtils {
@@ -249,4 +252,72 @@ public boolean accept(File pathname) {
                     || (pathname.isFile() && (normalFileFilter == null || normalFileFilter.accept(pathname)));
         }
     }
+
+    /**
+     * Take the file source path or URI string and convert it to a URI object.
+     *
+     * @param source The file source path or URI
+     * @param isDirectory Whether the source is a directory
+     * @return The URI object
+     */
+    public static URI convertToURI(final String source, final boolean isDirectory) {
+        if (source.isEmpty()) {
+            throw new IllegalArgumentException("Cannot convert empty source to URI");
+        }
+        final URI uri;
+        try {
+            uri = new URI(source);
+        } catch (final URISyntaxException e) {
+            // If the URI is invalid, assume it's a file path
+            return convertToURI(new File(source), isDirectory);
+        }
+        if (uri.getScheme() == null) {
+            // Convert to a "file" URI
+            return convertToURI(new File(source), isDirectory);
+        }
+        return uri;
+    }
+
+    /**
+     * Takes a file and convert it to a URI object with {@code "file"} scheme. This method is preferred instead of
+     * {@link File#toURI()} because {@link File#toURI()} internally calls {@link File#isDirectory()}, which typically
+     * invokes the {@code stat} system call, resulting in filesystem metadata access.
+     *
+     * @param file The file
+     * @param isDirectory Whether the source file is a directory
+     * @return The URI object
+     */
+    public static URI convertToURI(final File file, final boolean isDirectory) {
+        String absPath = file.getAbsolutePath();
+        if (File.separatorChar != '/') {
+            absPath = absPath.replace(File.separatorChar, '/');
+        }
+        if (absPath.charAt(0) != '/') {
+            absPath = "/" + absPath;
+        }
+        if (isDirectory && absPath.charAt(absPath.length() - 1) != '/') {
+            absPath = absPath + "/";
+        }
+        if (absPath.startsWith("//")) {
+            absPath = "//" + absPath;
+        }
+        try {
+            return new URI("file", null, absPath, null);
+        } catch (final URISyntaxException e) {
+            throw new IllegalStateException("Failed to convert file to URI: " + file, e);
+        }
+    }
+
+    /**
+     * Takes a path and convert it to a URI object with {@code "file"} scheme. This method is preferred instead of
+     * {@link Path#toUri()} because {@link Path#toUri()} internally invokes the {@code stat} system call, resulting in
+     * filesystem metadata access.
+     *
+     * @param path The path
+     * @param isDirectory Whether the file is a directory
+     * @return The URI object
+     */
+    public static URI convertToURI(final Path path, final boolean isDirectory) {
+        return convertToURI(path.toFile(), isDirectory);
+    }
 }
diff --git a/Base/src/main/java/io/deephaven/base/Lazy.java b/Base/src/main/java/io/deephaven/base/Lazy.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import java.util.function.Supplier;

diff --git a/Base/src/main/java/io/deephaven/base/LockFreeArrayQueue.java b/Base/src/main/java/io/deephaven/base/LockFreeArrayQueue.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import io.deephaven.base.queue.ConcurrentQueue;

diff --git a/Base/src/main/java/io/deephaven/base/LowGarbageArrayIntegerMap.java b/Base/src/main/java/io/deephaven/base/LowGarbageArrayIntegerMap.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import io.deephaven.base.verify.Assert;

diff --git a/Base/src/main/java/io/deephaven/base/LowGarbageArrayList.java b/Base/src/main/java/io/deephaven/base/LowGarbageArrayList.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import io.deephaven.base.verify.Assert;

diff --git a/Base/src/main/java/io/deephaven/base/LowGarbageArraySet.java b/Base/src/main/java/io/deephaven/base/LowGarbageArraySet.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import java.util.AbstractSet;

diff --git a/Base/src/main/java/io/deephaven/base/MathUtil.java b/Base/src/main/java/io/deephaven/base/MathUtil.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 /**

diff --git a/Base/src/main/java/io/deephaven/base/Pair.java b/Base/src/main/java/io/deephaven/base/Pair.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import org.jetbrains.annotations.NotNull;

diff --git a/Base/src/main/java/io/deephaven/base/Predicate.java b/Base/src/main/java/io/deephaven/base/Predicate.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 public class Predicate {

diff --git a/Base/src/main/java/io/deephaven/base/RAPriQueue.java b/Base/src/main/java/io/deephaven/base/RAPriQueue.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import java.util.Arrays;

diff --git a/Base/src/main/java/io/deephaven/base/Reference.java b/Base/src/main/java/io/deephaven/base/Reference.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 // --------------------------------------------------------------------

diff --git a/Base/src/main/java/io/deephaven/base/RingBuffer.java b/Base/src/main/java/io/deephaven/base/RingBuffer.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 import java.util.Arrays;

diff --git a/Base/src/main/java/io/deephaven/base/SafeCloneable.java b/Base/src/main/java/io/deephaven/base/SafeCloneable.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 /**

diff --git a/Base/src/main/java/io/deephaven/base/SleepUtil.java b/Base/src/main/java/io/deephaven/base/SleepUtil.java
@@ -1,6 +1,6 @@
-/**
- * Copyright (c) 2016-2022 Deephaven Data Labs and Patent Pending
- */
+//
+// Copyright (c) 2016-2024 Deephaven Data Labs and Patent Pending
+//
 package io.deephaven.base;
 
 public class SleepUtil {