summaryrefslogtreecommitdiffstats
path: root/jack-api
diff options
context:
space:
mode:
authorJean-Philippe Lesot <jplesot@google.com>2015-06-18 17:49:48 +0000
committerGerrit Code Review <noreply-gerritcodereview@google.com>2015-06-18 17:49:49 +0000
commitc800defbffa7c5c0db769839c8e74e4485935b48 (patch)
treec47f9eb64ee2d6670c934bb738d5a446d1a5b412 /jack-api
parentc19224bbab964a20695874b4b8e6b01f79a4a65a (diff)
parent89a0ed230c1a967462ac03be09f6d5349c0bc9c1 (diff)
downloadtoolchain_jack-c800defbffa7c5c0db769839c8e74e4485935b48.zip
toolchain_jack-c800defbffa7c5c0db769839c8e74e4485935b48.tar.gz
toolchain_jack-c800defbffa7c5c0db769839c8e74e4485935b48.tar.bz2
Merge "Declare CLI api and let Jack implement it" into ub-jack-brest
Diffstat (limited to 'jack-api')
-rw-r--r--jack-api/src/com/android/jack/api/v01/Cli01CompilationTask.java34
-rw-r--r--jack-api/src/com/android/jack/api/v01/Cli01Config.java59
2 files changed, 93 insertions, 0 deletions
diff --git a/jack-api/src/com/android/jack/api/v01/Cli01CompilationTask.java b/jack-api/src/com/android/jack/api/v01/Cli01CompilationTask.java
new file mode 100644
index 0000000..c609705
--- /dev/null
+++ b/jack-api/src/com/android/jack/api/v01/Cli01CompilationTask.java
@@ -0,0 +1,34 @@
+/*
+ * Copyright (C) 2015 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.android.jack.api.v01;
+
+
+/**
+ * A task allowing to run the Jack compiler once.
+ */
+public interface Cli01CompilationTask {
+
+ /**
+ * Runs the Jack compiler. May be called only once.
+ * @return command line status
+ * @throws UnrecoverableException If an error out of Jack's control occurred
+ * @throws ConfigurationException If there is an error in the configuration
+ * @throws IllegalStateException If Jack is run more than once
+ */
+ int run() throws UnrecoverableException, ConfigurationException,
+ IllegalStateException;
+}
diff --git a/jack-api/src/com/android/jack/api/v01/Cli01Config.java b/jack-api/src/com/android/jack/api/v01/Cli01Config.java
new file mode 100644
index 0000000..b661f1d
--- /dev/null
+++ b/jack-api/src/com/android/jack/api/v01/Cli01Config.java
@@ -0,0 +1,59 @@
+/*
+ * Copyright (C) 2015 The Android Open Source Project
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package com.android.jack.api.v01;
+
+import com.android.jack.api.JackConfig;
+
+import java.io.File;
+import java.io.PrintStream;
+
+import javax.annotation.Nonnull;
+
+/**
+ * A configuration for CLI level 01 of the Jack compiler.
+ */
+public interface Cli01Config extends JackConfig {
+
+ /**
+ * Creates an instance of the {@link Cli01CompilationTask} according to this configuration.
+ * @param args To be handled as command line arguments.
+ * @return The {@link Cli01CompilationTask}
+ * @throws ConfigurationException
+ */
+ @Nonnull
+ Cli01CompilationTask getTask(@Nonnull String[] args) throws ConfigurationException;
+
+ /**
+ * Redirect Jack's error output to the given stream.
+ * @param standardError The stream where to write errors.
+ */
+ void setStandardError(@Nonnull PrintStream standardError);
+
+ /**
+ * Redirect Jack's standards output to the given stream.
+ * @param standardOutput The stream where to write non error messages.
+ */
+ void setStandardOutput(@Nonnull PrintStream standardOutput);
+
+ /**
+ * Defines Jack's working directory.
+ * @param workingDirectory The base directory that will be used to evaluate non absolute file
+ * paths.
+ */
+ void setWorkingDirectory(@Nonnull File workingDirectory);
+
+}