{"id":13713144,"url":"https://github.com/bendiksolheim/diy-lisp-java","last_synced_at":"2025-05-06T23:30:40.740Z","repository":{"id":23515331,"uuid":"26881426","full_name":"bendiksolheim/diy-lisp-java","owner":"bendiksolheim","description":"Java port of Kjetil Valles diy-lisp","archived":false,"fork":false,"pushed_at":"2015-09-15T10:05:54.000Z","size":412,"stargazers_count":2,"open_issues_count":4,"forks_count":1,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-11-13T23:33:13.384Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/bendiksolheim.png","metadata":{"files":{"readme":"README.md","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":"2014-11-19T21:01:51.000Z","updated_at":"2016-04-30T03:21:53.000Z","dependencies_parsed_at":"2022-08-03T00:56:06.495Z","dependency_job_id":null,"html_url":"https://github.com/bendiksolheim/diy-lisp-java","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/bendiksolheim%2Fdiy-lisp-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bendiksolheim%2Fdiy-lisp-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bendiksolheim%2Fdiy-lisp-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bendiksolheim%2Fdiy-lisp-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bendiksolheim","download_url":"https://codeload.github.com/bendiksolheim/diy-lisp-java/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252787171,"owners_count":21804211,"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":[],"created_at":"2024-08-02T23:01:28.419Z","updated_at":"2025-05-06T23:30:39.634Z","avatar_url":"https://github.com/bendiksolheim.png","language":"Java","funding_links":[],"categories":["Java"],"sub_categories":[],"readme":"## DIY Lisp \n\n\u003e batteries included, some assembly required\n\nIn this tutorial/workshop we'll be implementing our own little language, more or less from scratch. \n\nBy the end of the tutorial you will be the proud author of a programming language, and will hopefully better understand how programming languages work  on a fundamental level.\n\n### What we will be making\n\nWe will make a relatively simple, but neat language. We aim for the following features:\n\n- A handful of datatypes (integers, booleans and symbols)\n- Variables\n- First class functions with lexical scoping\n- That nice homemade quality feeling\n\nWe will *not* have:\n\n- A proper type system\n- Error handling\n- Good performance\n- And much, much more\n\nThe language should be able to interpret the following code by the time we are done:\n\n```lisp\n(define fact \n    ;; Factorial function\n    (lambda (n) \n        (if (eq n 0) \n            1 ; Factorial of 0 is 1\n            (* n (fact (- n 1))))))\n\n;; When parsing the file, the last statement is returned\n(fact 5)\n```\n\nThe syntax is that of the languages in the Lisp family. If you find the example unfamiliar, you might want to have a look at [a more detailed description of the language](parts/language.md).\n\n### Prerequisites\n\nBefore we get started, make sure you have installed [Java 8 Development Kit (JDK)](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html) and [Maven (at least version 3)](https://maven.apache.org/download.cgi). \n\nClone this repo:\n\n```bash\ngit clone https://github.com/bendiksolheim/diy-lisp-java.git\n```\n\nInstall dependencies:\n```bash\ncd diy-lisp-java\nmvn install -DskipTests\n```\n\nAnd you should be pretty much good to go!\n\n### A few tips\n\nTake the time to consider the following points before we get going:\n\n- **Keep things simple**\n  \n  \tDon't make things more complicated than they need to be. The tests should hopefully guide you every step of the way.\n\n- **Read the test descriptions**\n\n  \tEach test has a small text describing what you are going to implement and why. Reading these should make things easier, and you might end up learning more.\n\n- **Use the provided functions**\n\n  \tSome of the more boring details are already taken care of. Take the time to look at the functions provided in `Parser.java`, and the various imports in files where you need to do some work.\n\n- **Description of your language**\n\n  \tUnfamiliar with Lisp? Read a description of the language you are going to make in [language.md](https://github.com/kvalle/diy-lisp/blob/master/parts/language.md).\n\n### Get started!\n\nThe workshop is split up into seven parts. Each consist of an introduction, and a bunch of unit tests which it is your task to make run. When all the tests run, you'll have implemented that part of the language.\n\nHave fun!\n\n- [Part 1: parsing](parts/1.md)\n- [Part 2: evaluating simple expressions](parts/2.md)\n- [Part 3: evaluating complex expressions](parts/3.md)\n- [Part 4: working with variables](parts/4.md)\n- [Part 5: functions](parts/5.md)\n- [Part 6: working with lists](parts/6.md)\n- [Part 7: using your language](parts/7.md)\n- [Part 8: final touches](parts/8.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbendiksolheim%2Fdiy-lisp-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbendiksolheim%2Fdiy-lisp-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbendiksolheim%2Fdiy-lisp-java/lists"}