FarNet.template 2.2.0

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet new install FarNet.template::2.2.0
This package contains a .NET Template Package you can call from the shell/command line.

FarNet.template

FarNet module template for C# and F# projects

With .NET SDK v6 installed with Visual Studio or manually, the easiest way to create module projects for FarNet is using FarNet.template from the NuGet gallery.

Projects created from the template can be used for development and debugging in Visual Studio and VSCode.

To install the FarNet module template from the NuGet gallery, run:

dotnet new -i FarNet.template

Take a look at all templates:

dotnet new -l

The list should contain "FarNet module":

Template Name  Short Name  Language  Tags
-------------  ----------  --------  -------------
FarNet module  farnet      [C#],F#   FarNet/Module

To create a C# (default) or F# module project, create a new folder with your new FarNet module name, change to it, and run:

dotnet new farnet
dotnet new farnet -lang F#

To uninstall the template, run:

dotnet new -u FarNet.template

Created FarNet module

Before opening created projects in Visual Studio or VSCode ensure you have the environment variable FARHOME set to the Far Manager home. If it is missing then the development location C:\Bin\Far\x64 is used, see the project file and change if needed. If you start Visual Studio or VSCode from Far Manager then FARHOME is set automatically.

Visual Studio

The project is ready to use in Visual Studio.

VSCode

Requirements:

Project details

  • .vscode
    • launch.json - VSCode debug settings
    • tasks.json - VSCode build task
  • Properties
    • launchSettings.json - Visual Studio debug settings
  • README.md - documentation file
  • MODULE_NAME.csproj/fsproj - project file
  • Host.cs/fs - optional module host and its instance
  • Tool1.cs/fs - plugin menu item "Hello from MODULE_NAME"
  • Command1.cs/fs - command invoked using "MODULE_NAME:" prefix

All projects reference assemblies FarNet and optional FarNet.Tools.

F# projects reference FSharp.Core.dll and optional FarNet.FSharp.dll. They are installed together with the module FarNet.FSharpFar (really must have if you develop in F# for Far Manager).

When you build a project the post build step copies built files to the FarNet module directory. Ensure Far Manager is not running to avoid files in use.

Debugging

Press [F5] to starts debugging. Debug modes:

  • Start Far (Visual Studio, VSCode default mode)
    • The build step is called at first and then debugging starts.Far.exe should be in the path or you should adjust settings.
  • Attach single Far (select in VSCode)
    • Attach to the already running single Far.exe.
  • Attach selected Far (select in VSCode)
    • Choose one of the several running Far.exe.

This package has no dependencies.

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
5.0.0 2,613 11/19/2023
4.0.3 367 4/8/2023
4.0.2 429 1/2/2023
4.0.1 329 11/19/2022
4.0.0 289 11/19/2022
3.0.2 428 10/18/2022
3.0.1 421 10/13/2022
3.0.0 393 10/8/2022
2.2.0 468 8/25/2022
2.0.1 441 7/31/2022
2.0.0 422 7/19/2022
1.3.0 450 6/11/2022
1.2.1 400 6/10/2022
1.2.0 404 6/10/2022
1.1.0 407 6/3/2022
1.0.3 456 2/12/2022
1.0.2 2,435 12/26/2020
1.0.1 537 12/19/2019
1.0.0 549 12/15/2019
0.0.4 1,307 9/3/2018
0.0.2 1,170 3/23/2018
0.0.1 934 3/19/2018

Requires FarNet 6.0.6
- Use new module ids.
- Build as ALC modules.