-
-
Notifications
You must be signed in to change notification settings - Fork 1.5k
GSoC 2015 Ideas
Below is a list of project ideas for GSoC 2015. These projects require familiarity with the Nim programming language so it is absolutely essential that you become familiar with Nim ahead of time.
Nim is a statically typed programming language which compiles primarily to C and has an excellent performance/productivity ratio. Nim's design focuses on efficiency, expressiveness, elegance.
Areas of the project you may wish to work on include the Nim compiler which is itself written in Nim, Nim's standard library and/or the tools and infrastructure of Nim which includes the Nim build farm (Nimbuild) and the Nim package manager (nimble).
To get started you will need to clone the Nim repository and then subsequently bootstrap the compiler, instructions for doing this are located here. You can then move onto the tutorial and read through the other documentation as well.
We encourage you to join the #nim IRC channel on Freenode to discuss these projects with the community and our mentors. The Nim Forum and mailing list are also available. Because communication is a big part of open source development you are expected to get in touch with us before making your application, failure to do so will put your application at a great disadvantage.
The following list of projects are just some ideas that the community and the developers have come up with. You will be contributing to a programming language so there is a lot of flexibility when it comes to the projects that you can work on, this list is certainly not comprehensive so we are happy to hear any suggestions that you may have.
Desirable skills: Experience with C and with REPLs in other languages (Python, GHCi, ...)
Description:
A REPL (read-eval-print loop) can be an valuable tool while exploring a language, new libraries and during regular development, as it allows faster feedback than creating source code files, saving them after each change, and reexecuting.
Nim provides a simple REPL based on its compile-time Virtual Machine, but it is not adequate. For example importing C based code does not work.
An alternative approach is the development of a new REPL that actually compiles the entered code to C and then used TinyCC to immediately execute this code. TinyCC is well suited for this as it can execute C code very quickly.
Tasks:
- Add a simple TinyCC based REPL for Nim.
- Make sure common Nim code works as well as importing C based libraries
- Improve its performance
Difficulty: Medium to Hard
Mentor: def- (@def-), Araq (@Araq)
Desirable skills:
Description:
Often people want to play around with a language without actually installing it. This idea aims to help these people by providing an online compiler for Nim, that can be used on any website.
Create a web application that can be used for compiling and running Nim code. The code should be compiled and ran on a server. Users should be able to enter any Nim code they want and use common libraries. (TODO: Link to similar stuff, like Rust)
Tasks:
- Implement an online compiler
- Make sure it is secure
Difficulty: Easy to Medium
Mentor: def- (@def-)
Desirable skills: Familiarity with the various GC approaches and algorithms, knowledge of the compiler codegen modules.
Description:
Most of the popular garbage collected languages of today require a separately distributed run-time environment, providing only a predetermined set of garbage collection algorithms. This leaves little room for experimentation with various approaches and condemns GC researchers to develop and test their algorithms on specialized platforms such as the Jikes RVM that have limited practical significance.
In contrast, in Nim, the garbage collection algorithm is chosen at compile-time and embedded in the resulting stand-alone native executable. This enables the users to pick a GC algorithm that's most suitable to their project and allows for a proliferation of GC algorithms, developed by independent groups and individuals, without requiring any modifications to be made to the standard Nim distribution.
The Nim code generator and type system can provide various GC roots marking strategies, various kinds of write/read barriers and all necessary static type information (e.g. static cycle analysis) and a GC implementation will consist only of a single Nim module (supplied as a command-line parameter) that provides configuration for the code generator and implements the logic of the garbage collection algorithm. This module will be compiled as C code with the rest of the program and it could be easily debugged using standard C/C++ debugging and profiling tools.
Tasks:
- Add support for precise stack marking
- Add support for read barriers and polish the support for Levanoni/Petrank style of write barriers
- Implement the infrastructure for picking a user-supplied GC module
Bonus points: Implement simple forms of variety of GC algorithms as a proof-of-concept
Difficulty: Medium to Hard
Mentor: zahary (@zah)
Desirable skills: Good OpenCL knowledge, knowledge of the compiler internals, basics of type theory.
Description:
Nim currently supports C, C++, Objective C and JavaScript code generation. However to run efficiently on GPUs an OpenCL backend is required. The easy way to do this is to copy OpenCL's low level mode of operation with its different private
, local
, global
storage and simply provide a idiomatic syntax for OpenCL. So apart from syntactic sugar users get all of Nim's meta programming advantages plus good integration into Nim's infrastructure.
The vision is a gpu
pragma that means a proc and all of its dependencies are translated into OpenCL instead of C but can be invoked from ordinary Nim code that is translated to C. The gpu
code generator is allowed to only translate a subset of Nim, in particular things like function pointers that are not supported by OpenCL do not have to be supported. The compiler should produce a clean error message for unsupported features.
Expected Result: The GPU code generator works on a selected set of examples/test cases.
Tasks:
- Add support for new pointer types in the compiler like
global
,private
. - Add support for work groupss.
- Add support for the
gpu
pragma that translates to the OpenCL, version 2: https://www.khronos.org/registry/cl/sdk/2.0/docs/man/xhtml/
Bonus points: Support version 1.2 of the OpenCL specification: https://www.khronos.org/registry/cl/sdk/1.2/docs/man/xhtml/. This should be significantly harder as version 1.2 doesn't support a shared address space with the host environment.
Difficulty: Hard
Mentor: Araq (@Araq)
Desirable skills: Familiarity with JavaScript.
Description:
Nim has a JavaScript backend, which allows one to write the backend as well as frontend in Nim. The JS backend is simple, so this is a good way to get started with learning about Nim compiler internals.
Tasks:
- Fix JavaScript backend bugs
- Port relevant parts of the standard library to JS
- Make JS test cases
Bonus points:
- Speed up the JavaScript backend by targetting
asm.js
Difficulty: Medium
Mentor: Araq (@Araq), def- (@def-)
Desirable skills: Basic writing and documentation skills, webdesign and infrastructure setup.
Description: The Nim documentation is generally good but it needs to be made more accessible and lacks helpful code examples. Writing documentation is also a great way to get a better understanding of Nim. Read the docs is a good example of attractive as well as readable documentation, it is something we would be after in this project.
Additionally the documentation should be generated more automatically. The documentation of each nimble package should automatically be available online, similar to Hackage. Upon installation of a library with nimble, its documentation should be installed on the system as well.
Tasks:
- Ensure that documentation exists for all public methods and modules.
- Add code examples to all modules and to all procedures (where appropriate).
- Add search capabilities to the online documentation.
- Improve the website design and usability
- Add cross-linking capabilities in nim doc
- Make nimble build and install the documentation locally so you have docs of all your installed libraries
- Automatically create an online documentation of each nimble package
Difficulty: Medium
Mentor: def- (@def-)
TODO: Fill out
Mentor: Araq (@Araq)
Message Passing Interface (MPI) is a portable system for writing highly parallel programs. Nim with its excellent performance/productivity ratio would make a great language for this use.
Tasks:
- Create a low level wrapper for the MPI standard using c2nim
- Write a high level abstraction library for comfortable MPI in Nim
Difficulty: Medium
Mentor: def- (@def-)
Gofmt is often cited as one of the major points for the Go programming language. It completely elimantes the need to manually adhere to style formatting, by automatically converting go code into a consistent style. Something similar would be nice to have in Nim, where we have additional freedoms, like case insensitivity, that should be handled in a onsistent way for big projects.
Tasks:
- Write a
nimfmt
tool
Difficulty: Medium
Mentor: Araq (@Araq), def- (@def-)
Desirable skills: Knowledge of C
Description: Nim's c2nim tool helps create nim bindings for C libraries. However, c2nim does not parse the whole C language, and is not currently supposed to import whole APIs into nim mechanically, but rather to serve as a starting point for manual definition of interfaces to C libraries. c2nim is particularly effective in dealing with C's preprocessor macros, but is not currently capable of parsing many C header files.
Make c2nim accept more C declarations than it currently does, and produce corresponding Nim declarations. This can be done either by directly filling-in the missing capabilities, or by interfacing it with a mature tool for parsing C code, such as LLVM's CLang or the GCC-XML tool. If one of these tools is used, then it is expected that it would not suffice by itself, but rather augment the current c2nim parser, since these tools have their own limitations. A possible implementation might pass the header file once through gcc-xml to parse C declarations, and would use the current c2nim parser on lines that start with '#' to parse preprocessor definitions. c2nim would then process the parsed headers and produce constants, types, macros and proc declarations similar to those that it produces now.
C comments should be converted into nim documentation where appropriate.
Although c2nim currently converts function implementations (and not only declarations), this functionality is outside the scope of this task.
Tasks: Depending on the chosen implementation technique, the tasks would be either:
- detect individual deficiencies in c2nim support for .h files and fix them or:
- interface with a feature-complete parser for C, such as that of GCC or CLANG.
- refactor c2nim so that it can generate declarations from the parsed output of the above parser, rather than directly from .h files as it currently does.
- combine the output from the previous task with the declarations that c2nim produces for preprocessor macros.
Difficulty: Medium
Mentor: Araq (@Araq), def- (@def-)
Description:
Lexer generators are useful tools for writing all sorts of parsers. Currently Nim lacks a native Lexer generators. This project involves the implementation of a lexer generator. It should be modelled after re2c or alternatively it can be based on the wide number of existing lexer generators such as Flex.
Here is a sketch of a possible implementation:
- Parse regular expressions into an NFA and ensure the attached Nim actions are kept around through the next different passes.
- Translate the NFA to an DFA: http://web.cecs.pdx.edu/~harry/compilers/slides/LexicalPart3.pdf
- Minimize the DFA with Hopcroft's algorithm: http://en.wikipedia.org/wiki/DFA_minimization
- Translate the DFA into Nim code and attach the actions.
Desirable skills: Knowledge of lexer generators. How to translate regexes into DFAs and how to optimize the resulting automatons.
Difficulty: Medium to Hard
Mentor: zahary (@zah)
Description:
Ragel is a "finite-state machine compiler with output support for C, C++, C#, Objective-C, D, Java, OCaml, Go, and Ruby source code." This project involves the implementation of a Nim backend for Ragel. This can be based on the large number of pre-existing backends listed previously.
Desirable skills: Knowledge of Ragel's internals.
Difficulty: Medium
Mentor: zahary (@zah)
Please add your project ideas in the following format.
Desirable skills:
Description:
Expected Result:
Difficulty: ...
Mentor: Mentor name (@MentorName)
Intro
Getting Started
- Install
- Docs
- Curated Packages
- Editor Support
- Unofficial FAQ
- Nim for C programmers
- Nim for Python programmers
- Nim for TypeScript programmers
- Nim for D programmers
- Nim for Java programmers
- Nim for Haskell programmers
Developing
- Build
- Contribute
- Creating a release
- Compiler module reference
- Consts defined by the compiler
- Debugging the compiler
- GitHub Actions/Travis CI/Circle CI/Appveyor
- GitLab CI setup
- Standard library and the JavaScript backend
Misc