{"id":33209349,"url":"https://github.com/bradford-hamilton/monkey-lang","last_synced_at":"2026-03-10T08:32:38.724Z","repository":{"id":57521832,"uuid":"200317385","full_name":"bradford-hamilton/monkey-lang","owner":"bradford-hamilton","description":"Currently extending the Monkey programming language designed in the books \"Writing An Interpreter In Go\" and \"Writing a Compiler in Go\"","archived":false,"fork":false,"pushed_at":"2024-10-16T13:19:21.000Z","size":219,"stargazers_count":54,"open_issues_count":0,"forks_count":7,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-02-01T15:55:16.587Z","etag":null,"topics":["compilers","go","golang","interpreters","languages","monkey-language","parser"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bradford-hamilton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-08-03T01:23:09.000Z","updated_at":"2026-01-30T01:45:31.000Z","dependencies_parsed_at":"2024-06-20T15:34:50.449Z","dependency_job_id":"a7430b6f-8269-4603-9001-b7037a296d4b","html_url":"https://github.com/bradford-hamilton/monkey-lang","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/bradford-hamilton/monkey-lang","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradford-hamilton%2Fmonkey-lang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradford-hamilton%2Fmonkey-lang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradford-hamilton%2Fmonkey-lang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradford-hamilton%2Fmonkey-lang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bradford-hamilton","download_url":"https://codeload.github.com/bradford-hamilton/monkey-lang/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bradford-hamilton%2Fmonkey-lang/sbom","scorecard":{"id":250246,"data":{"date":"2025-08-11","repo":{"name":"github.com/bradford-hamilton/monkey-lang","commit":"c3ed87975e5f309daebec8f77daea2e212112ec2"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.7,"checks":[{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":0,"reason":"Found 2/28 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v0.3.0 not signed: https://api.github.com/repos/bradford-hamilton/monkey-lang/releases/23706592","Warn: release artifact v0.2.5 not signed: https://api.github.com/repos/bradford-hamilton/monkey-lang/releases/22242388","Warn: release artifact v0.2.1 not signed: https://api.github.com/repos/bradford-hamilton/monkey-lang/releases/21427387","Warn: release artifact v0.2.0 not signed: https://api.github.com/repos/bradford-hamilton/monkey-lang/releases/21425009","Warn: release artifact v0.3.0 does not have provenance: https://api.github.com/repos/bradford-hamilton/monkey-lang/releases/23706592","Warn: release artifact v0.2.5 does not have provenance: https://api.github.com/repos/bradford-hamilton/monkey-lang/releases/22242388","Warn: release artifact v0.2.1 does not have provenance: https://api.github.com/repos/bradford-hamilton/monkey-lang/releases/21427387","Warn: release artifact v0.2.0 does not have provenance: https://api.github.com/repos/bradford-hamilton/monkey-lang/releases/21425009"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 4 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T08:18:16.038Z","repository_id":57521832,"created_at":"2025-08-17T08:18:16.038Z","updated_at":"2025-08-17T08:18:16.038Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30328251,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T05:25:20.737Z","status":"ssl_error","status_checked_at":"2026-03-10T05:25:17.430Z","response_time":106,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["compilers","go","golang","interpreters","languages","monkey-language","parser"],"created_at":"2025-11-16T11:00:20.715Z","updated_at":"2026-03-10T08:32:38.716Z","avatar_url":"https://github.com/bradford-hamilton.png","language":"Go","funding_links":[],"categories":["Other"],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/bradford-hamilton/monkey-lang.svg?branch=master)](https://travis-ci.org/bradford-hamilton/monkey-lang)\n[![Go Report Card](https://goreportcard.com/badge/github.com/bradford-hamilton/monkey-lang)](https://goreportcard.com/report/github.com/bradford-hamilton/monkey-lang)\n[![codecov](https://codecov.io/gh/bradford-hamilton/monkey-lang/branch/master/graph/badge.svg)](https://codecov.io/gh/bradford-hamilton/monkey-lang)\n[![GoDoc](https://godoc.org/github.com/bradford-hamilton/monkey-lang?status.svg)](https://godoc.org/github.com/bradford-hamilton/monkey-lang)\n[![Go 1.23.1](https://img.shields.io/badge/go-1.23.1-9cf.svg)](https://golang.org/dl/)\n\n# Monkey Lang\n\nCurrently extending the Monkey programming language designed in [_Writing An Interpreter In Go_](https://interpreterbook.com) and [_Writing a Compiler in Go_](https://compilerbook.com) by [Thorsten Ball](https://github.com/mrnugget). I **_highly_** recommend picking up a copy of his books.\n\nI'll formally document the language and it's features at some point, but for now I'm keeping a list of the additional functionality I've added on top of original design.\n\nAll additional features (where applicable) have been implemented for both the interpreter and the compiler:\n\n1. Ability to execute Monkey files (.mo file ext) in addition to the interactive console. This is now the default behavior. Add `--console` flag when executing to drop into the REPL instead.\n2. Both file execution and console usage respond to an `--engine=` flag where you can choose to use the evaluator or the VM.\n3. Logical operators `\u0026\u0026` and `||`\n4. Single line comments starting with `//`\n5. Multi line comments using `/* */`\n6. `const` variable declaration (although it only mocks let at this point until I add variable reassignment)\n7. Modulo operator `%`\n8. Postfix operators `++` and `--`\n9. Comparison operators `\u003e=` and `\u003c=`\n10. String comparisons using `!=` and `==`\n11. Line numbers throughout the tokens/lexer/parsing/evaluator used for better errors.\n12. Ability to have question marks in identifiers. Ex: `has_attribute?`\n13. Additional builtin functions:\n      | Type        | Builtin       |\n      |-------------|---------------|\n      | Array       | `pop`, `join` |\n      | String      | `split`       |\n14. [VS Code syntax highlighting extension](https://github.com/bradford-hamilton/vscode-monkeylang-syntax). Not yet published, but working and provides basic syntax highlighting.\n15. Add installation support through [brew](https://brew.sh)\n16. Add roughly +20% code coverage\n\n## Installation\n_**Option A:**_\n\n```\nbrew tap bradford-hamilton/monkey\nbrew install bradford-hamilton/monkey/monkey\n```\n\n_**Option B:**_\n\nIf you mosey on over to [releases](https://github.com/bradford-hamilton/monkey-lang/releases), you'll find binaries for darwin, linux, windows, and amd64. You can download directly from there.\n\n_**Option C:**_\n\nIf you have Go installed on your machine, use `go install`:\n\n```\ngo install github.com/bradford-hamilton/monkey-lang\n```\n\nThis will place the binary in your `go/bin` and is ready to use.\n\n\n## Usage\nBuild\n```\ngo build -o monkey main.go\n```\n\nRun\n```\n./monkey [option...] filePath\n```\n\n## Examples\n\nRunning with vm\n```\n./monkey --engine=vm examples/program.mo\n```\n\nRunning with evaluator\n```\n./monkey --engine=eval examples/program.mo\n```\n\nRun interactive console\n```\n./monkey --console\n```\n\n## Show your support\n\nGive a ⭐ if this project was helpful in any way!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbradford-hamilton%2Fmonkey-lang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbradford-hamilton%2Fmonkey-lang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbradford-hamilton%2Fmonkey-lang/lists"}