TelnetNegotiationCore 1.0.4

There is a newer version of this package available.
See the version list below for details.

dotnet add package TelnetNegotiationCore --version 1.0.4

NuGet\Install-Package TelnetNegotiationCore -Version 1.0.4

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="TelnetNegotiationCore" Version="1.0.4" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add TelnetNegotiationCore --version 1.0.4

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: TelnetNegotiationCore, 1.0.4"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install TelnetNegotiationCore as a Cake Addin
#addin nuget:?package=TelnetNegotiationCore&version=1.0.4

// Install TelnetNegotiationCore as a Cake Tool
#tool nuget:?package=TelnetNegotiationCore&version=1.0.4

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Larger Logo

Telnet Negotiation Core

Summary

This project is intended to be a library that implements basic telnet functionality. This is done with an eye on MUDs at this time, but may improve to support more terminal capabilities as time permits.

At this time, this repository is in a rough state and does not yet implement some common modern code standards.

State

This library is in a state where breaking changes to the interface are expected.

Support

RFC	Description	Supported	Comments
RFC 855	Telnet Option Specification	Full
RFC 1091	Terminal Type Negotiation	Full
MTTS	MTTS Negotiation (Extends TTYPE)	Full
RFC 1073	Window Size Negotiation (NAWS)	Full
GMCP	Generic Mud Communication Protocol	Full
MSSP	MSSP Negotiation	Full	Untested
RFC 885	End Of Record Negotiation	Full	Untested
EOR	End Of Record Negotiation	Full	Untested
MSDP	Mud Server Data Protocol	Partial	Planned
RFC 2066	Charset Negotiation	Partial	No TTABLE support
RFC 858	Suppress GOAHEAD Negotiation	No	Planned
RFC 1572	New Environment Negotiation	No	Planned
MNES	Mud New Environment Negotiation	No	Planned
MCCP	Mud Client Compression Protocol	No	Rejects
RFC 1950	ZLIB Compression	No	Rejects
RFC 857	Echo Negotiation	No	Rejects
RFC 1079	Terminal Speed Negotiation	No	Rejects
RFC 1372	Flow Control Negotiation	No	Rejects
RFC 1184	Line Mode Negotiation	No	Rejects
RFC 1096	X-Display Negotiation	No	Rejects
RFC 1408	Environment Negotiation	No	Rejects
RFC 2941	Authentication Negotiation	No	Rejects
RFC 2946	Encryption Negotiation	No	Rejects

ANSI Support, ETC?

Being a Telnet Negotiation Library, this library doesn't give support for extensions like ANSI, Pueblo, MXP, etc at this time.

Use

Client

A messy example exists in the TestClient Project.

Initiate a logger. A Serilog logger is required by this library at this time.

	var log = new LoggerConfiguration()
		.Enrich.FromLogContext()
		.WriteTo.Console()
		.WriteTo.File(new CompactJsonFormatter(), "LogResult.log")
		.MinimumLevel.LogDebug()
		.CreateLogger();

	Log.Logger = log;

Create functions that implement your desired behavior on getting a signal.

	private async Task WriteToOutputStreamAsync(byte[] arg, StreamWriter writer)
	{
		try 
		{ 
			await writer.BaseStream.WriteAsync(arg, CancellationToken.None);
		}
		catch(ObjectDisposedException ode)
		{
			_Logger.LogInformation("Stream has been closed", ode);
		}
	}

	public static Task WriteBackAsync(byte[] writeback, Encoding encoding) =>
		Task.Run(() => Console.WriteLine(encoding.GetString(writeback)));

	public Task SignalGMCPAsync((string module, string writeback) val, Encoding encoding) =>
		Task.Run(() => _Logger.LogDebug("GMCP Signal: {Module}: {WriteBack}", val.module, val.writeback));

	public Task SignalMSSPAsync(MSSPConfig val) =>
		Task.Run(() => _Logger.LogDebug("New MSSP: {@MSSP}", val));

	public Task SignalPromptAsync() =>
		Task.Run(() => _Logger.LogDebug("Prompt"));

	public Task SignalNAWSAsync(int height, int width) => 
		Task.Run(() => _Logger.LogDebug("Client Height and Width updated: {Height}x{Width}", height, width));

Initialize the Interpreter.

	var telnet = new TelnetInterpreter(TelnetInterpreter.TelnetMode.Client, _Logger.ForContext<TelnetInterpreter>())
	{
		CallbackOnSubmitAsync = WriteBackAsync,
		CallbackNegotiationAsync = (x) => WriteToOutputStreamAsync(x, output),
		SignalOnGMCPAsync = SignalGMCPAsync,
		SignalOnMSSPAsync = SignalMSSPAsync,
		SignalOnNAWSAsync = SignalNAWSAsync,
		SignalOnPromptingAsync = SignalPromptAsync,
		CharsetOrder = new[] { Encoding.GetEncoding("utf-8"), Encoding.GetEncoding("iso-8859-1") }
	}.BuildAsync();

Start interpreting.

	for (int currentByte = 0; currentByte != -1; currentByte = input.BaseStream.ReadByte())
	{
		telnet.InterpretAsync((byte)currentByte).GetAwaiter().GetResult();
	}

Server

A messy example exists in the TestServer Project.

Product	Compatible and additional computed target framework versions.
.NET	net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net8.0
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.0)
- morelinq (>= 3.4.2)
- OneOf (>= 3.0.255)
- stateless (>= 5.13.0)
- System.Collections.Immutable (>= 8.0.0)
- TelnetNegotiationCore.Functional (>= 1.0.4)

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last updated
1.0.9	70	11/18/2024
1.0.7	969	3/19/2024
1.0.6	119	1/9/2024
1.0.4	112	1/9/2024
1.0.3	114	1/8/2024
1.0.2	124	1/7/2024
1.0.1	118	1/4/2024
1.0.0	127	1/3/2024

# Change Log
All notable changes to this project will be documented in this file.

## [1.0.4] - 2024-01-09

### Changed
- Removed Serilog dependency in favor of Microsoft.Extensions.Logging.Abstractions, which allows one to inject the preferred logger.

## [1.0.3] - 2024-01-08

### Fixed
- Ensure that the Project Dependency on TelnetNegotiationCore.Functional is added as a DLL.

## [1.0.2] - 2024-01-07

### Added
- Add MSDP support.
- Added a helper function to convert strings to safe byte arrays.

### Changed
- Altered EOR functionality.

## [1.0.1] - 2024-01-03

### Added
- Add callback function for MSSP.

### Changed
- Target .NET 8.0.
- Change Methods to be properly async.
- Modernized TestClient example to use Pipes.
- Modernized TestServer example to use Pipes and Kestrel.

## [1.0.0] - 2024-01-03

Initial version.

### Added
- Initial support for RFC855 (TELOPT)
- Initial support for RFC858 (GOAHEAD)
- Initial support for RFC1091 (TTERM)
- Initial support for MTTS
- Initial support for RFC885 (EOR)
- Initial support for RFC1073 (NAWS)
- Initial support for RFC2066 (CHARSET)
- Initial support for MSSP
- Initial support for GMCP

Total 1.9K

Current version 112

Per day average 5

telnet