Skip to content

zsv playground

Azeem Sajid edited this page Dec 9, 2024 · 3 revisions

Overview

zsv playground is a minimal terminal that runs in the browser.

This document describes how to make the best of it.

Open an issue if something is broken.
Please make sure that the issue being reported is not a duplicate of already reported (opened/closed) issues.

In general, any feedback/suggestions for improvments are always welcome!

Limitations

The zsv CLI application in the playground may be limited in its functionality due to the fact that it's a sandboxed environment.

Following are its current limitations:

  • The input via STDIN is not supported.
    • The input needs to be passed as a file.
  • The output to STDOUT may take time depending on its size.
    • For large files, e.g. with millions of records, it is recommended to dump output to a file with -o/--output flag and work with that.
    • The save command may also be used to download the output file to disk for any extensive STDOUT related tasks.
  • The sheet command is not available.
  • For iOS, zsv is built without SIMD instructions.
    • The performance may differ in the playground versus the installed version.

Important

Each new tab is a new session. Nothing is preserved between sessions.
Refreshing a tab will start a new session i.e. everyting will be lost.

Getting started

To start the playground, go to https://liquidaty.github.io/zsv/.

Note

The TAB autocompletion is supported for commands/subcommands/flags and files.

Commands

The help command lists all the supported commands that are available in the playground.

This section describes only the important ones:

  • load
    • Usage: load
    • Load files from disk to the browser's filesystem.
    • Opens the file dialog box to navigate the disk and select file(s).
    • The existing files are overwritten i.e. force mode.
  • save
    • Usage: save <filename> ...
    • Save files from the browser's filesystem to disk.
  • download
    • Usage: download <url> ...
    • Download files via URL(s) to the browser's filesystem.
    • The existing files are overwritten i.e. force mode.
  • ls
    • Usage: ls
    • List the content of the current directory i.e. /home/zsv/.
  • rm
    • Usage: rm <filename> ...
    • Remove files from the browser's filesystem.
    • No prompt i.e. force mode.

Demo

zsv-playground-demo

Clone this wiki locally