json = require 'json'
function main(args)
  local infile = io.open(args[1])
  local manifest_s = infile:read('*a')
  infile:close()
  local manifest = json.decode(manifest_s)
  local core_filenames = {}
  for k,v in pairs(manifest) do
    if not starts_with(k, 'fw_') then
      table.insert(core_filenames, k)
    end
  end
  table.sort(core_filenames)
  for _,core in ipairs(core_filenames) do
    local filename = ('%04d'):format(manifest[core])..'-'..core
    local f = io.open(filename)
    if f then
      print(f:read('*a'))
      print('')
    end
  end
end
function starts_with(s, prefix)
  if #s < #prefix then
    return false
  end
  for i=1,#prefix do
    if s:sub(i,i) ~= prefix:sub(i,i) then
      return false
    end
  end
  return true
end
main(arg)

# Thin programming environment for making edits to "live" LÖVE apps

# Thin programming environment for making edits to live, "freewheeling" LÖVE apps

Run this app from the terminal, [passing its directory to LÖVE](https://love2d.org/wiki/Getting_Started#Running_Games)
You'll see a page that's currently hard-coded in the app.
![initial view](assets/1.png)
All text is currently editable. There's a table on the right that will grow
and shrink as you add and delete text.
Changes you make are currently not saved. This is just a demo.

To pan, drag the surface around. To increase/decrease zoom, press `ctrl+=`,
`ctrl+-` respectively. To reset zoom press `ctrl+0`.
this live without restarting the app each time, install [the driver
app](https://codeberg.org/akkartik/driver.love). Here's an example session
using a fork of this repo:
To run from the terminal, [pass this directory to LÖVE](https://love2d.org/wiki/Getting_Started#Running_Games).

Run this app from the terminal, [passing its directory to LÖVE](https://love2d.org/wiki/Getting_Started#Running_Games)

[More information about the on-disk representation of freewheeling apps.](representation.md)

While editing text:

When cursor is not in an editor:
* arrow keys pan the surface
* `shift`+arrow keys pan faster
  - `pagedown` and `pageup` are aliases for `shift+down` and `shift+up` respectively

* Bad things will happen if you have _more than_ a single such app running. Or
  if you close one app and open another without restarting the driver. Just
  always open the app and then the driver. If you close the app, close the
  driver.

* Don't give up your other tools just yet. It's easy to make a mistake that
  the app doesn't recover from when you fix it. Try restarting the app, and if
  it still doesn't work, perhaps you need to fix the initial load. This isn't
  yet a tool you can keep open for months on end. (And I'm ambivalent about
  making it such a tool since your programs might stop working for others.)

* Both freewheeling apps and the driver for them currently benefit from being
  launched in terminal windows rather than by being clicked on in a desktop
  OS. See [the driver app](https://codeberg.org/akkartik/driver.love/src/branch/main/README.md)
  for details.

* I still see driver and the app being driven occasionally crash. When I do I
  try to make things more robust. If you do you'll quite possibly crash again
  if you try to restart. In such a situation you'll have to bump down to
  editing the underlying version files by other means. See [representation.md](representation.md)
  for details of the underlying representation on disk.
* Given the above issues, both this driver and its client freewheeling app
  benefit from being launched in terminal windows rather than by being clicked
  on in a desktop OS.

Its immediate upstream is [the template repo for freewheeling apps](https://codeberg.org/akkartik/template-live-editor.love).

* https://codeberg.org/akkartik/driver.love - the driver app for modifying
  freewheeling apps without restarting them.