voidcontext / fetch-file

Simple file downloader library which can display the progress on the CLI

Version Matrix

fetch-file Build Status Latest Version

Simple library to download a potentially large file over a potentially slow network, while the progress is printed to the stdout.


Getting started

Currently only Scala 2.13.x is supported.

   libraryDependencies += "com.gaborpihaj" %% "fetchfile" % "0.3.0"


This example downloads the content of the pre-generated test file into a file in /tmp.

import cats.effect._
import cats.effect.concurrent.Ref
import cats.instances.list._
import vdx.fetchfile.Pipes._
import vdx.fetchfile._

import scala.io.Source

import java.io.{File, FileOutputStream}
import java.net.URL

object Main extends IOApp {
  def run(args: List[String]): IO[ExitCode] = {

    implicit val clock: MonotonicClock = MonotonicClock.system

    val shaSum = Source.fromFile("docker/static-files/100MB.bin.sha256").mkString.trim()
    val gzippedeShaSum = Source.fromFile("docker/static-files/100MB.bin.gz.sha256").mkString.trim()

    val outFile = new File("/tmp/100MB.bin")

    Blocker[IO].use { blocker =>
      implicit val backend: HttpClient[IO] = HttpURLConnectionClient[IO](blocker, 1024 * 16)

      val downloader = Downloader[IO](blocker, Progress.consoleProgress[IO])

      for {
        ref <- Ref.of[IO, List[Byte]](List.empty)
        _ <- downloader.fetch(
          new URL("http://localhost:8088/100MB.bin.gz"),
          Resource.fromAutoCloseable(IO.delay(new FileOutputStream(outFile))),
          pipes = List(
            collectSHA256(ref), // Collect SHA before gunzip
            fs2.compress.gunzip[IO](32 * 1024) // Unzip compressed stream
          last = ensureSHA256(shaSum) // Ensure gunzipped SHA is correct
        collecetedSha <- ref.get.map(_.map("%02x".format(_)).mkString)
      } yield {
        println(s"Collected SHA: $collecetedSha, expected gzipped SHA: $gzippedeShaSum")

See fulle example in examples.


Some of the tests are relying on a HTTP webserver so that files can be downloaded through HTTP. The repository contains a predefined container for this. The test file needs to be generated before building the container.

  $ sh docker/static-files/pre_build.sh
  $ docker-compose up
  $ sbt test