{"id":13590877,"url":"https://github.com/darius/ichbins","last_synced_at":"2025-12-17T14:18:39.778Z","repository":{"id":65565539,"uuid":"758885","full_name":"darius/ichbins","owner":"darius","description":"A tiny self-hosting Lisp-to-C compiler","archived":false,"fork":false,"pushed_at":"2020-06-28T16:49:38.000Z","size":114,"stargazers_count":236,"open_issues_count":0,"forks_count":23,"subscribers_count":11,"default_branch":"master","last_synced_at":"2024-11-06T11:44:58.739Z","etag":null,"topics":["compiler","language","lisp"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/darius.png","metadata":{"files":{"readme":"README","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-07-06T02:16:53.000Z","updated_at":"2024-09-01T01:10:11.000Z","dependencies_parsed_at":"2023-01-29T22:55:11.409Z","dependency_job_id":null,"html_url":"https://github.com/darius/ichbins","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darius%2Fichbins","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darius%2Fichbins/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darius%2Fichbins/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/darius%2Fichbins/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/darius","download_url":"https://codeload.github.com/darius/ichbins/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247860786,"owners_count":21008351,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["compiler","language","lisp"],"created_at":"2024-08-01T16:00:51.390Z","updated_at":"2025-12-17T14:18:34.751Z","avatar_url":"https://github.com/darius.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"ICHBINS\n\nThis is a self-hosting compiler of a Lisp dialect to C in 6 pages of\ncode. I've tried to make it as simple as possible, with almost no\nconcessions to performance or extra functionality -- it's meant to be\neducational rather than useful.\n\n\nQUICK START\n\n    $ git clone git@github.com:darius/ichbins.git\n(Or get a tarball from http://github.com/darius/ichbins)\n    $ cd ichbins\n    $ make\n\nTo compile a program named foo.scm and then run it:\n    $ ./ichbins \u003cfoo.scm \u003efoo.c\n    $ cc foo.c -o foo\n    $ ./foo\n\nThere's a sketchy overview of the language and system in Overview.text.\n\nTo make a change to the compiler and rebuild it, just typing 'make'\nisn't sufficient because of the circular dependency. 'make' will build\nan executable named ichbins2, compiling the current source with the\nprevious executable. To replace that executable, type './bless', which\ndoes two tests:\n\n    * That the tests in the tests/ directory pass.\n\n    * That the old and new versions of the compiler executable produce\n      the same C output from the compiler source. This test typically\n      passes for routine changes to the source, but it's perfectly OK\n      for it to fail; you should just be sure you can say why this case\n      is expected. Then do 'mv ichbins2 ichbins' by hand and do ./bless \n      again; this time it must pass, or something's buggered.\n\nThe Lisp dialect implemented here is documented in Documentation.md.\n\n\nMOTIVATION\n\nI'm a nut who wants to grow a beautiful wholeness from tiny beginnings.\nThis is a rewrite of 'icbins', which had the same larger goal in mind\nbut a more immediate focus on playing with bootstrapping.\n\nDirect influences include:\n\nSteele \u0026 Sussman, \"The Art of the Interpreter\"\nhttp://library.readscheme.org/page1.html\n\nMarc Feeley, \"Scheme in 90 Minutes\"\nhttp://www.iro.umontreal.ca/~boucherd/mslug/meetings/20041020/minutes-en.html\n(which compiles a more powerful Scheme subset, but is longer and not\nself-hosting)\n\nThe name 'ichbins' could stand for \"I Can Hardly Believe It's Not Scheme!\"\n\nSee also https://github.com/darius/elv for a more featureful descendant.\n\n\nTHANKS\n\nTo Johnicholas Hines for example code.\n\nTo Manuel Simoni and Kragen Sitaker for feedback.\n\n\nLICENSE \u0026 CONTACT\n\nCopyright 2007 Darius Bacon under the terms of the MIT X license\nfound at http://www.opensource.org/licenses/mit-license.html\n\nDarius Bacon \u003cdarius@wry.me\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarius%2Fichbins","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdarius%2Fichbins","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdarius%2Fichbins/lists"}