CAMEL-23154: camel-jbang - Deprecate bind command

docs/user-manual/modules/ROOT/pages/camel-jbang.adoc

@@ -1312,6 +1312,8 @@ camel run joke.yaml
 
 ==== Binding Kamelets in a pipe
 
+WARNING: The bind command is deprecated from Camel 4.19 onwards
+
 Camel JBang is able to create the Pipe custom resource for you.
 You can use the `bind` command to specify a source and a sink that should be set in the pipe.
 As a result, Camel JBang will create a proper Pipe custom resource for you.

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/Bind.java

@@ -36,8 +36,9 @@
 import picocli.CommandLine;
 import picocli.CommandLine.Command;
 
-@Command(name = "bind", description = "Bind source and sink Kamelets as a new Camel integration",
+@Command(name = "bind", description = "DEPRECATED: Bind source and sink Kamelets as a new Camel integration",
          sortOptions = false, showDefaultValues = true)
+@Deprecated(since = "4.19")
 public class Bind extends CamelCommand {
 
     @CommandLine.Parameters(description = "Name of binding file to be saved", arity = "1",

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/BindingProvider.java

@@ -24,6 +24,7 @@
  * may represent a Kamelet, Camel endpoint URI or a Kubernetes object reference such as a reference to a Knative broker
  * for instance. Implementations must not hold any state as the binding provider instance is used for multiple calls.
  */
+@Deprecated
 public interface BindingProvider {
 
     String getEndpoint(

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/KnativeBrokerBindingProvider.java

@@ -24,6 +24,7 @@
 /**
  * Binding to a Knative broker resource.
  */
+@Deprecated
 public class KnativeBrokerBindingProvider extends ObjectReferenceBindingProvider {
 
     private static final String prefix = "knative:broker:";

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/KnativeChannelBindingProvider.java

@@ -21,6 +21,7 @@
 
 import org.apache.camel.util.StringHelper;
 
+@Deprecated
 public class KnativeChannelBindingProvider extends ObjectReferenceBindingProvider {
 
     private static final String prefix = "knative:channel:";

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/ObjectReferenceBindingProvider.java

@@ -36,6 +36,7 @@
  * specify resource properties. Subclasses may add logic for a very specific Kubernetes resource such as Kamelets or
  * Knative brokers.
  */
+@Deprecated
 public class ObjectReferenceBindingProvider implements BindingProvider {
 
     private static final Pattern OBJECT_REFERENCE_URI_PATTERN

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/PipeProvider.java

@@ -46,6 +46,7 @@
  * Binding to Kamelets as Kubernetes object references. Automatically resolves Kamelet from catalog and reads required
  * properties. Adds required properties as placeholder to the object reference when not set already by the user.
  */
+@Deprecated
 public class PipeProvider extends ObjectReferenceBindingProvider {
 
     private static final String prefix = "kamelet:";

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/StrimziKafkaTopicBindingProvider.java

@@ -24,6 +24,7 @@
 /**
  * Binding to a Strimzi Kafka topic resource.
  */
+@Deprecated
 public class StrimziKafkaTopicBindingProvider extends ObjectReferenceBindingProvider {
 
     private static final String prefix = "kafka:topic:";

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/TemplateProvider.java

@@ -26,6 +26,7 @@
  * Helper class provides access to the templates that construct the Pipe resource. Subclasses may overwrite the provider
  * to inject their own templates.
  */
+@Deprecated
 public interface TemplateProvider {
     default InputStream getPipeTemplate() {
         return TemplateProvider.class.getClassLoader().getResourceAsStream("templates/pipe.yaml.tmpl");

dsl/camel-jbang/camel-jbang-core/src/main/java/org/apache/camel/dsl/jbang/core/commands/bind/UriBindingProvider.java

@@ -26,6 +26,7 @@
 import org.apache.camel.util.StringHelper;
 import org.apache.camel.util.URISupport;
 
+@Deprecated
 public class UriBindingProvider implements BindingProvider {
 
     private static final Pattern CAMEL_ENDPOINT_URI_PATTERN = Pattern.compile("^[a-z0-9+][a-zA-Z0-9-+]*:.*$");

dsl/camel-jbang/camel-jbang-core/src/test/java/org/apache/camel/dsl/jbang/core/commands/bind/BindKnativeBrokerTest.java

@@ -23,6 +23,7 @@
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
+@Deprecated
 class BindKnativeBrokerTest extends CamelCommandBaseTestSupport {
 
     @Test

dsl/camel-jbang/camel-jbang-core/src/test/java/org/apache/camel/dsl/jbang/core/commands/bind/BindKnativeChannelTest.java

@@ -23,6 +23,7 @@
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
+@Deprecated
 class BindKnativeChannelTest extends CamelCommandBaseTestSupport {
 
     @Test

dsl/camel-jbang/camel-jbang-core/src/test/java/org/apache/camel/dsl/jbang/core/commands/bind/BindObjectReferenceTest.java

@@ -25,6 +25,7 @@
 
 import static org.assertj.core.api.Assertions.assertThat;
 
+@Deprecated
 class BindObjectReferenceTest extends CamelCommandBaseTestSupport {
 
     @Test

dsl/camel-jbang/camel-jbang-core/src/test/java/org/apache/camel/dsl/jbang/core/commands/bind/BindStrimziKafkaTopicTest.java

@@ -23,6 +23,7 @@
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
+@Deprecated
 class BindStrimziKafkaTopicTest extends CamelCommandBaseTestSupport {
 
     @Test

dsl/camel-jbang/camel-jbang-core/src/test/java/org/apache/camel/dsl/jbang/core/commands/bind/BindTest.java

@@ -23,6 +23,7 @@
 import org.junit.jupiter.api.Assertions;
 import org.junit.jupiter.api.Test;
 
+@Deprecated
 class BindTest extends CamelCommandBaseTestSupport {
 
     @Test