Fly Quickstart

by bucaran 8 years ago

macOS ◆ xterm-256color ◆ fish 1536 views

This tutorial will guide you through installing Fly and running a simple task.

About Generators and Tasks

Every task inside your Flyfile is defined as a generator function, hence the function* syntax. Like other functions, a generator runs from top to bottom, but unlike other functions, they can be exited and reentered at any time.

This behavior is usually controlled using the yield keyword and an iterator object which the generator function returns the first time it is called.

You never use the iterator object in Fly, but you do use yield to hand over control to Fly and queue asynchronous operations. Using this syntax we escape callback hell.

You can yield any value from a generator function. If you yield a Promise, Fly is smart enough to unwrap it and reenter the generator after the promise is resolved. Fly is able to do this and more using pseudo-coroutines via co.

More by bucaran

untitled 00:56

by bucaran 8 years ago

Simple plugin manager for fish (>=2.3) 01:15

by bucaran 8 years ago

untitled 00:43

by bucaran 8 years ago

untitled 01:30

by bucaran 8 years ago

See all

You can download this recording in asciicast v1 format, as a .json file.

Download

Replay in terminal

You can replay the downloaded recording in your terminal using the asciinema play command:

asciinema play 23283.json

If you don't have asciinema CLI installed then see installation instructions.

Use with stand-alone player on your website

Download asciinema player from the releases page (you only need .js and .css file), then use it like this:

<!DOCTYPE html>
<html>
<head>
  <link rel="stylesheet" type="text/css" href="asciinema-player.css" />
</head>
<body>
  <div id="player"></div>
  <script src="asciinema-player.min.js"></script>
  <script>
    AsciinemaPlayer.create(
      '/assets/23283.json',
      document.getElementById('player'),
      { cols: 80, rows: 22 }
    );
  </script>
</body>
</html>

See asciinema player quick-start guide for full usage instructions.

While this site doesn't provide GIF conversion at the moment, you can still do it yourself with the help of asciinema GIF generator utility - agg.

Once you have it installed, generate a GIF with the following command:

agg https://asciinema.org/a/23283 demo.gif

Or, if you already downloaded the recording file:

agg demo.cast demo.gif

Check agg --help for all available options. You can change font family and size, select color theme, adjust speed and more.

See agg manual for full usage instructions.