First release

Author: FieryCod

.gitignore

@@ -0,0 +1,8 @@
+.DS_Store
+.idea
+*.log
+tmp/
+pom.xml.asc
+target
+.cpcache
+*.jar

README.md

@@ -1,2 +1,66 @@
 # clojure-graalvm-agent-helper
-Ease native configuration generation for GraalVM NativeImage
+Ease native configuration generation for GraalVM NativeImage. You don't have to write configurations for native image by hand, since there is [Agent](https://medium.com/graalvm/introducing-the-tracing-agent-simplifying-graalvm-native-image-configuration-c3b56c486271) which might trace all the calls you make. 
+
+This tool helps you automate the process. You can leave in-context calls and production version of the jar will not contain any code which in-context wraps.
+
+Extracted from `holy-lambda` micro-framework.
+
+## How to use it?
+1. Add following dependency:
+
+   ``` clojure
+    io.github.FieryCod/clojure-graalvm-agent-helper {:mvn/version "0.0.1"}
+   ```
+   
+   2. Use `agent/in-context` in your code:
+   
+   ```clojure
+    (ns example.core
+      (:gen-class)
+      (:require
+        [fierycod.graalvm-agent-helper.core :as agent]))
+
+    (agent/in-context
+      (println "I can run arbitrary code in agent context. Agent will catch all the calls in context and generate native configuration out of it :)"))
+
+    (agent/in-context
+      (println "In case of error agent will catch it :)")
+      (throw (ex-info "Ups.." {})))
+
+    (defn -main
+      []
+      (agent/in-context (println "Since main is called I will print as well :)")))
+   ```
+   
+   3. Compile with `USE_AGENT_CONTEXT` environment set to `true`, so that `in-context` will not be removed
+   
+   ```
+   USE_AGENT_CONTEXT=true clojure -X:uberjar :aot true :jvm-opts '["-Dclojure.compiler.direct-linking=true", "-Dclojure.spec.skip-macros=true"]' :jar agent-output.jar :main-class example.core
+   ```
+   
+   4. Run in native agent context
+   ```
+   java -agentlib:native-image-agent=config-output-dir=resources/native-configuration \
+        -Dexecutor=native-agent \
+        -jar agent-output.jar
+   ```
+   
+   5. Compile a project without `USE_IN_AGENT_CONTEXT`
+   ```
+   clojure -X:uberjar :aot true :jvm-opts '["-Dclojure.compiler.direct-linking=true", "-Dclojure.spec.skip-macros=true"]' :jar output.jar :main-class example.core
+   ```
+   
+   5. Feed `native-image` with configuration and compile
+   ```
+   native-image -jar output.jar \
+     -H:ConfigurationFileDirectories=resources/native-configuration \
+     -H:+AllowIncompleteClasspath \
+     --report-unsupported-elements-at-runtime \
+     --no-fallback \
+     --verbose \
+     --enable-url-protocols=http,https \
+     --no-server \
+     --initialize-at-build-time 
+   ```
+   
+   Check example folder if you still have trouble setting it up.

example/Makefile

@@ -0,0 +1,37 @@
+IMAGE_CORD_PART:=fierycod/graalvm-native-image
+USE_EE:=false
+PWD=$$(pwd)
+USER_GID=$$(id -u):$$(id -g)
+
+ifeq ($(USE_EE), false)
+	IMAGE_CORD=$(IMAGE_CORD_PART):ce
+else
+	IMAGE_CORD=$(IMAGE_CORD_PART):ee
+endif
+
+compile-agent:
+	USE_AGENT_CONTEXT=true clojure -X:uberjar :aot true :jvm-opts '["-Dclojure.compiler.direct-linking=true", "-Dclojure.spec.skip-macros=true"]' :jar agent-output.jar :main-class example.core
+
+native-gen-conf: compile-agent
+	@docker run --user $(USER_GID) \
+		-v $(PWD):/project \
+		-it $(IMAGE_CORD) \
+		bash -c "java -agentlib:native-image-agent=config-output-dir=resources/native-configuration \
+			          -Dexecutor=native-agent \
+			          -jar agent-output.jar"
+compile:
+	clojure -X:uberjar :aot true :jvm-opts '["-Dclojure.compiler.direct-linking=true", "-Dclojure.spec.skip-macros=true"]' :jar output.jar :main-class example.core
+
+native-image: native-gen-conf compile
+	@docker run --user $(USER_GID) \
+		-v $(PWD):/project \
+		-it $(IMAGE_CORD) \
+		bash -c "native-image -jar output.jar \
+		  -H:ConfigurationFileDirectories=resources/native-configuration \
+		  -H:+AllowIncompleteClasspath \
+		  --report-unsupported-elements-at-runtime \
+          --no-fallback \
+          --verbose \
+          --enable-url-protocols=http,https \
+          --no-server \
+          --initialize-at-build-time"

example/deps.edn

@@ -0,0 +1,20 @@
+{:paths ["src"]
+ :deps {org.clojure/clojure                              {:mvn/version "1.10.3"}
+        io.github.FieryCod/clojure-graalvm-agent-helper  {:mvn/version "0.0.1"}}
+ :aliases {:deps {:replace-deps {org.clojure/tools.deps.alpha {:mvn/version "0.11.910"}
+                                 org.slf4j/slf4j-nop {:mvn/version "1.7.25"}}
+                  :ns-default clojure.tools.cli.api}
+           :test {:extra-paths ["test"]}
+
+           :uberjar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.0.216"}}
+                     :exec-fn hf.depstar/uberjar
+                     :exec-args {:aot true}}
+
+           ;; build a jar (library):
+           :jar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.0.216"}}
+                 :exec-fn hf.depstar/jar
+                 :exec-args {}}
+           ;; generic depstar alias, use with jar or uberjar function name:
+           :depstar {:replace-deps {com.github.seancorfield/depstar {:mvn/version "2.0.216"}}
+                     :ns-default hf.depstar
+                     :exec-args {}}}}

example/resources/native-configuration/jni-config.json

@@ -0,0 +1,2 @@
+[
+]

example/resources/native-configuration/proxy-config.json

@@ -0,0 +1,2 @@
+[
+]