This is the backend (web service) powering the GenieBuilder VSCode plugin. Unless you want to contribute to the backend, this repo is not what you want.
If you want to install the GenieBuilder VSCode plugin, please visit the VSCode marketplace or use this link to install it: https://marketplace.visualstudio.com/items?itemName=GenieBuilder.geniebuilder
- Clone the repository
- Start a Julia REPL in the app's folder:
$ julia --project - Instantiate the dependencies:
pkg> instantiate
Check the instructions here. We have Dockerized a sample GenieBuilder App along with recipe to create package compiler system image and using that .so image.
In the app's folder: $ bin/repl.
You might need to edit the repl file to point to the correct julia binary.
You might also need to make the repl file executable: $ chmod +x repl.
Alternatively you can load the project: $ julia --project.
Then load the Genie app: julia> using Genie; Genie.loadapp().
Once the app is loaded, run julia> up().
The following API endpoints are exposed by the GenieCloud backend:
Returns a list of all available apps.
{
"applications": [
{
"id": {
"value": 1
},
"name": "IrisClustering",
"port": 24838,
"path": "/apps/"
}
]
}Returns the status of the app.
{
"status": "online"
}Possible status values are: online, offline, error.
Starts the app if app is offline otherwise it returns the app's status.
Stops the app if online otherwise it returns the app's status.
Returns the list of files and folders within path
{
"dir": [
{
"file": ".gitattributes"
},
{
"file": ".gitignore"
},
{
"file": "Manifest.toml"
},
{
"file": "Project.toml"
},
{
"dir": "bin"
},
{
"file": "bootstrap.jl"
},
{
"dir": "build"
},
{
"dir": "config"
},
{
"dir": "log"
},
{
"dir": "models"
},
{
"dir": "plugins"
},
{
"dir": "public"
},
{
"file": "routes.jl"
},
{
"dir": "sessions"
},
{
"dir": "src"
},
{
"dir": "test"
},
{
"dir": "views"
}
]
}{
"dir": [
{
"file": "iris.jl"
},
{
"dir": "layouts"
}
]
}Returns the contents of the file at path, if it exists -- an error otherwise.
{
"content": "page(\n model, partial = true,\n [\n heading(\"Iris flowers clustering\")\n\n row([\n cell(class=\"st-module\", [\n h6(\"Number of clusters\")\n slider( 1:1:20,\n @data(:no_of_clusters);\n label=true)\n ])\n cell(class=\"st-module\", [\n h6(\"Number of iterations\")\n slider( 10:10:200,\n @data(:no_of_iterations);\n label=true)\n ])\n\n cell(class=\"st-module\", [\n h6(\"X feature\")\n Stipple.select(:xfeature; options=:features)\n ])\n\n cell(class=\"st-module\", [\n h6(\"Y feature\")\n Stipple.select(:yfeature; options=:features)\n ])\n ])\n\n row([\n cell(class=\"st-module\", [\n h5(\"Species clusters\")\n plot(:iris_plot_data, layout = :layout, config = \"{ displayLogo:false }\")\n ])\n\n cell(class=\"st-module\", [\n h5(\"k-means clusters\")\n plot(:cluster_plot_data, layout = :layout, config = \"{ displayLogo:false }\")\n ])\n ])\n\n row([\n cell(class=\"st-module\", [\n h5(\"Iris data\")\n table(:iris_data; pagination=:credit_data_pagination, dense=true, flat=true, style=\"height: 350px;\")\n ])\n ])\n ]\n )"
}{
"error": "./views/irisssss.jl is not a file"
}Writes the POST payload sent in the POST variable payload to the file denoted by path.
Returns the application's log. Can be large.
{
"content": "┌ Error: 2022-02-21 09:33:59 MethodError: no method matching (::GenieDevTools.var\"#32#37\")()\n│ Stacktrace:\n│ [1] #invokelatest#2\n│"Returns any compilation errors that can cause the app building to fail. If no errors, the response will be an empty object {},
{
"(PkgData(IrisClustering [37dd9d81-1a0e-4ce3-9765-cea2640fa567], basedir \"/Users/adrian/Dropbox/Projects/GenieCloud/apps/IrisClustering\":\n \"src/IrisClustering.jl\": FileInfo(IrisClustering=>ExprsSigs(<0 expressions>, <0 signatures>), with cachefile /Users/adrian/.julia/compiled/v1.7/IrisClustering/kz2BH_tYonf.ji)\n \"config/secrets.jl\": FileInfo(IrisClustering=>ExprsSigs(<1 expressions>, <0 signatures>), )\n \"config/initializers/autoload.jl\": FileInfo(IrisClustering=>ExprsSigs(<1 expressions>, <0 signatures>), )\n \"config/initializers/converters.jl\": FileInfo(IrisClustering=>ExprsSigs(<5 expressions>, <3 signatures>), )\n \"config/initializers/inflector.jl\": FileInfo(IrisClustering=>ExprsSigs(<2 expressions>, <0 signatures>), )\n \"config/initializers/logging.jl\": FileInfo(IrisClustering=>ExprsSigs(<5 expressions>, <1 signatures>), )\n \"config/initializers/ssl.jl\": FileInfo(IrisClustering=>ExprsSigs(<3 expressions>, <1 signatures>), )\n \"plugins/autoreload.jl\": FileInfo(IrisClustering=>ExprsSigs(<3 expressions>, <1 signatures>), )\n \"plugins/devtools.jl\": FileInfo(IrisClustering=>ExprsSigs(<2 expressions>, <0 signatures>), )\n \"plugins/sessionstorage.jl\": FileInfo(IrisClustering=>ExprsSigs(<3 expressions>, <0 signatures>), )\n \"routes.jl\": FileInfo(IrisClustering=>ExprsSigs(<6 expressions>, <1 signatures>), )\n, \"routes.jl\")": [
{
"file": "/Users/adrian/Dropbox/Projects/GenieCloud/apps/IrisClustering/routes.jl",
"line": 16,
"error": "extra token \"do\" after end of expression"
},
[
{}
]
]
}Returns the list of pages registered in the app. Pages are bundles of views, layouts, models and route.
{
"pages": [
{
"view": "views/iris.jl",
"route": {
"method": "GET",
"path": "/"
},
"layout": "views/layouts/app.jl.html",
"model": {
"name": "Iris.IrisModel",
"fields": [
"iris_data",
"credit_data_pagination",
"features",
"xfeature",
"yfeature",
"iris_plot_data",
"cluster_plot_data",
"layout",
"no_of_clusters",
"no_of_iterations",
"channel__",
"isready",
"isreadydelay",
"isprocessing"
],
"types": [
"Stipple.Reactive{StippleUI.Tables.DataTable}",
"StippleUI.Tables.DataTablePagination",
"Stipple.Reactive{Vector{String}}",
"Stipple.Reactive{String}",
"Stipple.Reactive{String}",
"Stipple.Reactive{Vector{StipplePlotly.Charts.PlotData}}",
"Stipple.Reactive{Vector{StipplePlotly.Charts.PlotData}}",
"Stipple.Reactive{StipplePlotly.Charts.PlotLayout}",
"Stipple.Reactive{Int64}",
"Stipple.Reactive{Int64}",
"String",
"Stipple.Reactive{Bool}",
"Stipple.Reactive{Int64}",
"Stipple.Reactive{Bool}"
]
}
}
]
}Lists the CSS and JS assets used by the application.
{
"deps": {
"styles": [
"<link href=\"/stippleui.jl/master/assets/css/quasar.min.css\" rel=\"stylesheet\" />"
],
"scripts": [
"<script src=\"/stippleui.jl/master/assets/js/quasar.umd.min.js\"></script>",
"<script src=\"/stippleplotly.jl/master/assets/js/plotly2.min.js\"></script>",
"<script src=\"/stippleplotly.jl/master/assets/js/resizesensor.min.js\"></script>",
"<script src=\"/stippleplotly.jl/master/assets/js/lodash.min.js\"></script>",
"<script src=\"/stippleplotly.jl/master/assets/js/vueresize.min.js\"></script>",
"<script src=\"/stippleplotly.jl/master/assets/js/vueplotly.min.js\"></script>",
"<script src=\"/stipple.jl/master/assets/js/irisirismodel.js\" defer></script>"
]
}
}Starts a remote repl session in the guest app. You can use another Julia REPL with the RemoteREPL.jl package to
connect to the guest reply using the port number returned by this endpoint.
The REPL is always started on a remote port for security considerations -- and the port is returned in the response.
{"status":"OK","port":44659}using RemoteREPL
connect_repl(44659)