Build Status Gitter chat

“There are two kinds of spurs, my friend. Those that come in by the door … [and] those that come in by the window.”

— Tuco Benedicto Pacifico Juan Maria Ramirez

Sometimes it’s easier to come in by the window. Tuco is a slightly cleaned-up fork of the prehistoric net.wimpi.telnetd with a pure API in the style of doobie. It lets you embed a telnet server in your application in a reasonable way.

Quick Start

The current development version is 0.4.1 for Scala 2.11/12 with

Add the dependency to your build.sbt thus:

libraryDependencies += "org.tpolecat" %% "tuco-core"  % "0.4.1" // either this
libraryDependencies += "org.tpolecat" %% "tuco-shell" % "0.4.1" // or this, which includes the shell API

Obviously this is very early software. Please experiment and contribute code or suggestions, but don’t rely on it for anything important yet unless you are prepared to rewrite things.

Where from here? Maybe the exquisite and voluminous documentation?

Probable FAQ

  • Is this a security problem? Yes! Telnet should definitely not be available outside your local network, and probably not even from a remote machine. It’s all on you.

  • Who the hell is Tuco Benedicto Pacifico Juan Maria Ramirez? Please enjoy this brief educational video.