Feersum.CompilerServices 0.2.7

dotnet add package Feersum.CompilerServices --version 0.2.7                
NuGet\Install-Package Feersum.CompilerServices -Version 0.2.7                
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="Feersum.CompilerServices" Version="0.2.7" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Feersum.CompilerServices --version 0.2.7                
#r "nuget: Feersum.CompilerServices, 0.2.7"                
#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 Feersum.CompilerServices as a Cake Addin
#addin nuget:?package=Feersum.CompilerServices&version=0.2.7

// Install Feersum.CompilerServices as a Cake Tool
#tool nuget:?package=Feersum.CompilerServices&version=0.2.7                

<p align="center"> <img src="docs/Logo_colour_sm.png" alt="Ant in a box" /> </p> <h1 align="center"><samp>(feersum . scheme)</samp></h1> <p align="center"> <a href=https://dev.azure.com/iwillspeak/GitHub/_build/latest?definitionId=4&branchName=main"><img alt="Build Status" src="https://dev.azure.com/iwillspeak/GitHub/_apis/build/status/iwillspeak.feersum?branchName=main" /></a> <a href="https://www.nuget.org/packages/Feersum"><img alt="Feersum on NuGet.org" src="https://buildstats.info/nuget/Feersum?includePreReleases=true" /></a> </p>

Wots in that thare box yoor holdin?

A Scheme compiler for .NET written in F#. Progress livestreamed on Twitch, catchup on YouTube

Contributing

Feersum is in active development. Contributions are welcome. See CONTRIBUTING for more imformation. For an introduction to buiding and testing the compiler, as well as a discussion of the high-level structure check out the DEVGUIDE.

Getting Started using Feersum

Feersum is distributed as a .NET tool, and MSBuild SDK. For quick use with an interactive REPL and simple compilation the tool can be installed directly:

$ dotnet tool install -g Feersum

Then from the command line feersum-scheme should launch a Scheme REPL. Type in Scheme code to have it compiled and evaluated. To compile a file into a simple executable run feersum-scheme yourfile.scm. This will produce a new file yourfile.exe which can then be run by dotnet yourfile.exe.

To create an SDK style scheme project and build it with dotnet build first install the Feersum.Templates template pack:

$ dotnet new install Feersum.Templates::*

Then from the command line:

$ dotnet new scm-console

This generates a new console application project in the current directory. Compile and run with dotnet build and dotnet run as usual! Other templates are available:

  • scm-classlib - Generate a .NET class library project.
  • scmlib - Generate s Scheme library definition file.

Planned Features

This is a rough list of interesting features I'd like to implement in this project, and is by no means a guarantee or a strict roadmap.

  • Implement all special forms
  • Support all value types
  • Support all standard procedures
  • Macros support.
    • Macro Hygene (#13).
  • Support for Scheme exceptions and guard.
  • Full numeric tower support.
  • Interop with other .NET assemblies.
  • Multi-statement support in the REPL.
  • Debugging support
    • Bound tree contains sequence points for debuging
    • Stop at entry, and step in.
    • Debuggable REPL. Embedded source in PDBs?
  • MSBUILD SDK support so .scmproj can be defined.
    • Proper support for different target frameworks
  • Scheme library and import support.
  • Standard library & builtins from a separate assembly.
  • Quoted expressions.
  • Diagnostics with position
    • Expose position information in parser.
    • Handle multiple parser errors.
    • Turn errors in bind into diagnotics too.
  • Perform on-demand compilation & emit to in-memory assembly for REPL.

Future themes of development are also tracked with Roadmap issues on GitHub.

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.

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
0.2.7 104 7/1/2024
0.2.6 158 6/20/2023
0.2.5 306 12/4/2021
0.2.4 295 11/12/2021