Feersum 0.2.7
dotnet tool install --global Feersum --version 0.2.7
dotnet new tool-manifest # if you are setting up this repo dotnet tool install --local Feersum --version 0.2.7
#tool dotnet:?package=Feersum&version=0.2.7
nuke :add-package Feersum --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 | Versions 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. |
This package has no dependencies.
Version | Downloads | Last updated |
---|---|---|
0.2.7 | 86 | 7/1/2024 |
0.2.6 | 187 | 6/20/2023 |
0.2.5 | 387 | 12/4/2021 |
0.2.4 | 368 | 11/12/2021 |
0.2.3 | 392 | 10/24/2021 |
0.2.2 | 352 | 10/18/2021 |
0.2.1 | 349 | 10/11/2021 |
0.2.0 | 434 | 10/10/2021 |
0.1.2 | 367 | 9/26/2021 |
0.1.1 | 427 | 9/19/2021 |
0.1.0 | 391 | 9/17/2021 |
0.1.0-tags-v0-0-2.1 | 181 | 10/26/2020 |
0.1.0-nuget-push.123 | 232 | 8/30/2020 |
0.1.0-beta.1 | 183 | 8/30/2020 |