{"id":15056337,"url":"https://github.com/version-fox/vfox-erlang","last_synced_at":"2025-04-23T01:55:15.559Z","repository":{"id":230936564,"uuid":"780416719","full_name":"version-fox/vfox-erlang","owner":"version-fox","description":"Erlang/OTP vfox plugin. Use the vfox to manage multiple Erlang/OTP versions in Linux/Darwin MacOS, also Windows!!!","archived":false,"fork":false,"pushed_at":"2025-04-22T16:23:20.000Z","size":374,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-23T01:55:07.974Z","etag":null,"topics":["erlang","erlang-developement","erlang-otp","vfox","vfox-plugin"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/version-fox.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":"2024-04-01T12:43:14.000Z","updated_at":"2025-04-22T16:23:23.000Z","dependencies_parsed_at":"2024-05-12T06:20:29.625Z","dependency_job_id":"6979441b-551f-4557-9fe1-f288a295c939","html_url":"https://github.com/version-fox/vfox-erlang","commit_stats":null,"previous_names":["yeshan333/vfox-erlang","version-fox/vfox-erlang"],"tags_count":9,"template":false,"template_full_name":"version-fox/vfox-plugin-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/version-fox%2Fvfox-erlang","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/version-fox%2Fvfox-erlang/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/version-fox%2Fvfox-erlang/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/version-fox%2Fvfox-erlang/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/version-fox","download_url":"https://codeload.github.com/version-fox/vfox-erlang/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250354301,"owners_count":21416751,"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":["erlang","erlang-developement","erlang-otp","vfox","vfox-plugin"],"created_at":"2024-09-24T21:50:00.697Z","updated_at":"2025-04-23T01:55:15.553Z","avatar_url":"https://github.com/version-fox.png","language":"Lua","readme":"\u003cdiv align=\"center\"\u003e\n\n![logo](./assets/vfox-erlang-logo.png)\n\n[![E2E tests on Linux](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_linux.yaml) [![E2E tests on Darwin MacOS](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_darwin.yaml) [![E2E tests on Windows](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_windows.yaml/badge.svg)](https://github.com/version-fox/vfox-erlang/actions/workflows/e2e_test_windows.yaml)\n\n\u003c/div\u003e\n\n# vfox-erlang plugin\n\nErlang/OTP [vfox](https://github.com/version-fox) plugin. Use the vfox to manage multiple [Erlang/OTP](https://www.erlang.org/) versions in Linux/Darwin MacOS/Windows. all platform~\n\n## Usage\n\n```shell\n# install plugin\nvfox add --source https://github.com/version-fox/vfox-erlang/archive/refs/heads/main.zip erlang\n\n# install an available version\nvfox search erlang\n# or specific version \nvfox install erlang@25.3.2.10\n```\n\n## Before install Erlang/OTP in Linux/Darwin MacOS\n\nvfox-erlang plugin would install Erlang/OTP through the [Erlang/OTP](https://www.erlang.org/doc/installation_guide/install#how-to-build-and-install-erlang-otp) source code compilation. So you must have the utilities mentioned in the document -\u003e [Building and Installing Erlang/OTP](https://www.erlang.org/doc/installation_guide/install#how-to-build-and-install-erlang-otp). \n\nHere are examples of installing on Ubuntu 20.04 and MacOS 13.\n\n### install in Linux (Ubuntu 20.04/22.04)\n\n```shell\n# install utilities\nsudo apt-get -y install build-essential autoconf m4 libncurses5-dev libwxgtk3.0-gtk3-dev libwxgtk-webview3.0-gtk3-dev libgl1-mesa-dev libglu1-mesa-dev libpng-dev libssh-dev unixodbc-dev xsltproc fop libxml2-utils libncurses-dev openjdk-11-jdk\n```\n\nYou can reference the E2E test in Ubuntu 20.04: [.github/workflows/e2e_test_linux.yaml](.github/workflows/e2e_test_linux.yaml)\n\n### install in Darwin (MacOS 13)\n\n```shell\n# install utilities\nbrew install autoconf libxslt fop wxwidgets openssl\n```\n\nYou can reference the E2E test in MacOS 13: [.github/workflows/e2e_test_darwin.yaml](.github/workflows/e2e_test_darwin.yaml)\n\n### Note\n\nBy default, vfox-erlang plugin will Build [EEP-48 documentation chunks](https://www.erlang.org/doc/apps/kernel/eep48_chapter) for get doc in REPL (eg: h(list).) and [lsp docs hint](https://github.com/elixir-lsp/vscode-elixir-ls/issues/284).\n\n![erl get docs](./assets/get_docs_in_repl.png)\n\nYou cal also use the `OTP_CONFIGURE_ARGS` environment variable to control install behavior. reference this documentation [https://github.com/erlang/otp/blob/master/HOWTO/INSTALL.md#configuring-1](https://github.com/erlang/otp/blob/master/HOWTO/INSTALL.md#configuring-1) for more configuration. eg:\n\n```shell\n# example\nexport OTP_CONFIGURE_ARGS=\"--enable-jit --enable-kernel-poll\"\nvfox install erlang@25.3.2.10\n```\n\nBuilding Erlang/OTP on a relatively fast computer takes approximately 5 minutes. To speed it up, you can utilize [parallel make](https://github.com/erlang/otp/blob/master/HOWTO/INSTALL.md#building-3) with the `-j\u003cnum_jobs\u003e` option. for example:\n\n```shell\nexport MAKEFLAGS=-j8\nvfox install erlang@25.3.2.10\n```\n\n## install Erlang/OTP in Windows platform\n\nIn windows, the vfox-erlang plugin downloads the Erlang/OTP version of the exe installer from the [Erlang/OTP releases](https://github.com/erlang/otp/releases) and executes it for you.\n\nThis is an installation example in PowerShell:\n\n```pwsh\nvfox install erlang@25.3.2.12\nvfox use erlang@25.3.2.12\nInvoke-Expression \"$(vfox activate pwsh)\"\n# Test the installation results\n\u0026 erl.exe -eval 'erlang:display({otp_release, erlang:system_info(otp_release)}), halt().' -noshell\n```\n\nYou can reference the E2E test in in windows-2022: [.github/workflows/e2e_test_windows.yaml](.github/workflows/e2e_test_windows.yaml)\n\n## install a prebuilt Erlang/OTP version\n\nAfter vfox-erlang v1.1.0, you can also install a prebuilt Erlang/OTP version in Ubuntu linux system. \n\n**Before install, you must disable vfox search cache.** Reference: [https://vfox.lhan.me/guides/configuration.html#cache-settings](https://vfox.lhan.me/guides/configuration.html#cache-settings)\n\nThis is an installation example in Bash Shell:\n\n```shell\n# install an available version, you can also a avaliable version in: https://bobs-list.kobrakai.de/\nUSE_PREBUILT_OTP=\"ubuntu-20.04\" vfox search erlang\n```\n\n**USE_PREBUILT_OTP** var value is one of: [\"ubuntu-14.04\", \"ubuntu-16.04\", \"ubuntu-18.04\", \"ubuntu-20.04\", \"ubuntu-22.04\", \"ubuntu-24.04\"].","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fversion-fox%2Fvfox-erlang","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fversion-fox%2Fvfox-erlang","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fversion-fox%2Fvfox-erlang/lists"}