Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alvatar/spheres
Spheres - A set of tools and libraries for practical Scheme. Multiplatform and Mobile.
https://github.com/alvatar/spheres
Last synced: 2 months ago
JSON representation
Spheres - A set of tools and libraries for practical Scheme. Multiplatform and Mobile.
- Host: GitHub
- URL: https://github.com/alvatar/spheres
- Owner: alvatar
- License: mit
- Created: 2014-10-11T20:27:13.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2021-03-18T21:21:43.000Z (almost 4 years ago)
- Last Synced: 2024-08-04T22:18:37.303Z (6 months ago)
- Language: Scheme
- Homepage:
- Size: 2.84 MB
- Stars: 69
- Watchers: 17
- Forks: 10
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-racket-and-scheme - spheres
README
# SchemeSpheres
_A set of tools and libraries for real-life Scheme. Multiplatform and mobile._
**IMPORTANT NOTE: This repository is deprecated and SchemeSpheres discontinued. However, progress is now being made as smaller libraries, using the new r7rs support in Gambit, which render some of the ideas here implemented obsolete.**
Some of these new projects are:
- [base](github.com/alvatar/base)
- [gles2](github.com/alvatar/gles2)
- [sdl2](github.com/alvatar/sdl2)
- [ffi-utils](github.com/alvatar/ffi-utils)
## Installation
The libraries are implemented in R7RS style. Support and installation depends on the Scheme implementation used. Spheres is mainly developed for Gambit, but nothing stops other implementations to use and adapt these libraries.
### Installation for Gambit Scheme
[](http://gambitscheme.org)
[](https://travis-ci.org/fourthbit/spheres)
In order to use these libraries, we need to provide Gambit with _R7RS libraries_ and _syntax-rules_ support. See below for current limitations. The following process will set up Gambit for use with Spheres in Linux, OSX or Windows:
1. Compile the syntax expander: go to /spheres/gambit and run ./compile-scsc.sh. This file provides improved syntax-rules support for Gambit.
2. Copy the .gambini file to your _HOME_ directory. This is Gambit's initialization file, and it is configured to load the syntax expander and a minimal R7RS layer.
3. (optional) Copy the _spheres/_ directory into your Gambit's installation library directory (i.e. /usr/local/Gambit/lib).
4. Update all .gambini paths to where your Spheres files are located (either Gambit's library directory, if you copied the files there, or any other path where you choose to leave Spheres' files).
## Basic usage
In order to make a library available within the REPL, the extended _load_ form is used:
(load (spheres/core base))
Spheres also brings automated compilation and __multiplatform/mobile__ build scripts. In order to make this functionality available, you need to install [Ssrun](https://github.com/fourthbit/ssrun). Once you do this, you can download the [project template](https://github.com/fourthbit/sphere-project) if you want to create a project based on Spheres. Additionally, with _Ssrun_, you can call the compilation tasks within the REPL:
(load (spheres/core base) compile: #t)
## Notes
Spheres supports _syntax-rules_ and _define-macro_ syntax. While Gambit will natively support R7RS in the future, at the moment we provide asubset of the functionality for practical usage:
* Macro systems supported: _syntax-rules_ and _define-macro_ (_syntax-case_ is also supported, but not used).
* Procedures in each library are within their own namespace (imports/exports are handled).
* Not supported from R7RS: _except_, _only_, _rename_, _include-ci_, _include-library-declarations_. Syntax is always in the global namespace (imports/exports and not handled).
## Contribute
Please, write to the project contributors if you are interested. Any help is welcome!