summaryrefslogtreecommitdiffstats
path: root/jill-api/src
diff options
context:
space:
mode:
Diffstat (limited to 'jill-api/src')
-rw-r--r--jill-api/src/com/android/jill/api/v01/Api01Config.java2
-rw-r--r--jill-api/src/com/android/jill/api/v01/Cli01Config.java59
-rw-r--r--jill-api/src/com/android/jill/api/v01/Cli01TranslationTask.java32
3 files changed, 92 insertions, 1 deletions
diff --git a/jill-api/src/com/android/jill/api/v01/Api01Config.java b/jill-api/src/com/android/jill/api/v01/Api01Config.java
index b1923bd..ea1e55b 100644
--- a/jill-api/src/com/android/jill/api/v01/Api01Config.java
+++ b/jill-api/src/com/android/jill/api/v01/Api01Config.java
@@ -24,7 +24,7 @@ import java.io.File;
import javax.annotation.Nonnull;
/**
-* A configuration implementation for API level 01 of Jill.
+* A configuration for API level 01 of Jill.
*/
public interface Api01Config extends JillConfig {
diff --git a/jill-api/src/com/android/jill/api/v01/Cli01Config.java b/jill-api/src/com/android/jill/api/v01/Cli01Config.java
new file mode 100644
index 0000000..2396f43
--- /dev/null
+++ b/jill-api/src/com/android/jill/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.jill.api.v01;
+
+import com.android.jill.api.JillConfig;
+
+import java.io.File;
+import java.io.PrintStream;
+
+import javax.annotation.Nonnull;
+
+/**
+* A configuration for CLI level 01 of Jill.
+*/
+public interface Cli01Config extends JillConfig {
+
+ /**
+ * Creates an instance of the {@link Cli01TranslationTask} according to this configuration.
+ * @param args To be handled as command line arguments.
+ * @return The {@link Cli01TranslationTask}
+ * @throws ConfigurationException
+ */
+ @Nonnull
+ Cli01TranslationTask getTask(@Nonnull String[] args) throws ConfigurationException;
+
+ /**
+ * Redirect Jill's error output to the given stream.
+ * @param standardError The stream where to write errors.
+ */
+ void setStandardError(@Nonnull PrintStream standardError);
+
+ /**
+ * Redirect Jill's standards output to the given stream.
+ * @param standardOutput The stream where to write non error messages.
+ */
+ void setStandardOutput(@Nonnull PrintStream standardOutput);
+
+ /**
+ * Defines Jill's working directory.
+ * @param workingDirectory The base directory that will be used to evaluate non absolute file
+ * paths.
+ */
+ void setWorkingDirectory(@Nonnull File workingDirectory);
+}
+
diff --git a/jill-api/src/com/android/jill/api/v01/Cli01TranslationTask.java b/jill-api/src/com/android/jill/api/v01/Cli01TranslationTask.java
new file mode 100644
index 0000000..61734b9
--- /dev/null
+++ b/jill-api/src/com/android/jill/api/v01/Cli01TranslationTask.java
@@ -0,0 +1,32 @@
+/*
+ * 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.jill.api.v01;
+
+/**
+ * A task allowing to run Jill once.
+ */
+public interface Cli01TranslationTask {
+
+ /**
+ * Runs the Jill compiler. May be called only once.
+ * @return command line status
+ * @throws TranslationException If a fatal error occurred during the translation
+ * @throws IllegalStateException If the translation task is run more than once
+ */
+ int run() throws TranslationException, IllegalStateException;
+}
+