Valkyrie: no more APIs.
Valkyrie is a programming language designed for writing client-server applications without having to coordinate the client and the server.
In every client/server application you have to build an API for the client and the server to communicate with each other. This is becoming more true in reactive applications.
In the good old days, if you wanted to have an HTML page with some stuff from your database, you could just write an HTML page and open PHP brackets <? and write code to retrieve whatever you want and render it with the HTML page ?>. Since then the difficulty has increased substantially. To do that now you have to
1. Write an HTML page
2. Choose a way for the client to communicate to the server ( GraphQL? REST? )
3. Design an API
4. Implement it
5. Test it
6. Debug it until it works
7. Hope that stuff doesn't change too much
Valkyrie allows you to describe the connection between the client and server via language constructs. For example, you can define "server functions" and invoke them from the client. The compiler will generate a server and a client that know how to talk to each other.
Source repl: https://repl.it/@noapi/valkyrie#
(defs initialize-server-counter  (def counter (atom 0)) "initialized") (defs get-server-counter  @counter) (startd increment-func-every-second-in-server "* * * ? * *" (swap! counter inc)) (defonce client-counter (r/atom 0)) (defn current-server-count-component  [:div [:strong "Server daemon function ran: "] @client-counter]) (initialize-server-counter (fn [response])) (defn app  (js/setTimeout #(get-server-counter (fn [response] (swap! client-counter (fn [y] (:body response))))) 3000) (current-server-count-component))
In this demo, valk will generate a server and a client. The execution flow is as follows:
1. The client calls the server function
initialize-server-counter to set a global variable counter in the server to 0
2. The daemon function
increment-func-every-second-in-server will run every second in the server and increments the counter by 1
3. The server function
get-server-counter returns the value of the counter when it is called
4. The client executes the server function
get-server-counter every 3 seconds and updates the client variable
client-counter to be equal to the counter value in the server
5. When the value of client-counter changes the react component
current-server-count-component will rerender and display the most recent value
6. App as the root react element
This is an example of how you can easily coordinate the exchange of information between the server and the client, using language constructs, without having to define a million API endpoints.
Server functions can be defined using the
defs special form. They are functions that run on the server but can be invoked from the client. They are the equivalent of a REST API call.
(defs server-function  "This function run in the server") (defn app  (server-function #((.-log js/console) (:body %))) "HELLO WORLD")
In this example the client will render a react component that renders HELLO WORLD. The react component will asynchronouslly call a server function called "server-function" which will run on the server and return "This function run in the server" to the client. The client will in turn console log "This function run in the server".
Daemon functions that run on the server can be setup and defined using the
startd special form. This keyword is followed by a function name, a string containing a cron expression and a function body.
(startd daemon-func "* * * ? * *" ;; cron expression (println "in-daemon-func")) ;; function body
This Valkyrie code snippet will setup a daemon function called
daemon-func and run the function body every second on the server. This will result in
"in-daemon-func" being printed on the console every second.
- Implement a websocket language construct that allows easy bidirectional communication between the server and the client. This would make the demo much cleaner.
- Statically check all communication between client and server. This would definitely make web applications less buggier.