{"id":16526682,"url":"https://github.com/satoren/lrdb","last_synced_at":"2025-03-16T19:31:17.111Z","repository":{"id":38419479,"uuid":"79358114","full_name":"satoren/LRDB","owner":"satoren","description":"Lua Remote DeBugger","archived":false,"fork":false,"pushed_at":"2023-04-12T02:02:54.000Z","size":6871,"stargazers_count":64,"open_issues_count":24,"forks_count":21,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-02-27T12:26:37.029Z","etag":null,"topics":["debugger","lua"],"latest_commit_sha":null,"homepage":null,"language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/satoren.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE_1_0.txt","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":"2017-01-18T16:14:15.000Z","updated_at":"2025-02-21T08:54:19.000Z","dependencies_parsed_at":"2024-10-27T11:09:41.813Z","dependency_job_id":"5e960d89-fcd0-47e6-99b6-702f07818733","html_url":"https://github.com/satoren/LRDB","commit_stats":null,"previous_names":[],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/satoren%2FLRDB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/satoren%2FLRDB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/satoren%2FLRDB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/satoren%2FLRDB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/satoren","download_url":"https://codeload.github.com/satoren/LRDB/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243826780,"owners_count":20354220,"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":["debugger","lua"],"created_at":"2024-10-11T17:29:30.886Z","updated_at":"2025-03-16T19:31:16.518Z","avatar_url":"https://github.com/satoren.png","language":"C++","readme":"# Lua Remote DeBugger\n\nLicensed under [Boost Software License](http://www.boost.org/LICENSE_1_0.txt)\n\n![test](https://github.com/satoren/LRDB/workflows/test/badge.svg)\n[![Coverage Status](https://coveralls.io/repos/github/satoren/LRDB/badge.svg?branch=master)](https://coveralls.io/github/satoren/LRDB?branch=master)\n\n## Introduction\n\nLRDB is Debugger for Lua programing language.\n\n\nCurrentry debug client is [Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=satoren.lrdb) only.\n\nCommand line interface debugger is not implemented.\n\n\n## Features\n\n* Breakpoints with conditional and hit counts.\n* Step over, step in, step out\n* Display Local,Upvalue,Global values\n* Watches,Eval on Debug Console\n* Remote debugging over TCP network\n\n\n## Requirements\n  * Lua 5.1 or later\n  * C++11 compiler\n\n## Embedded to your host program\n\nLRDB is header only library\n\n### include path\n  - LRDB/include\n  - LRDB/third_party/asio/asio/include or boost.asio with -DLRDB_USE_BOOST_ASIO\n  - LRDB/third_party/picojson\n\n### code\n```C++\n#include \"lrdb/server.hpp\"\n...\n\n  int listen_port = 21110;//listen tcp port for debugger interface\n\n  lua_State* L = luaL_newstate();//create lua state\n\n  lrdb::server debug_server(listen_port);\n  debug_server.reset(L);//assign debug server to lua state(Required before script load)\n\n  bool ret = luaL_dofile(L, luafilepath);\n\n  debug_server.reset(); //unassign debug server (Required before lua_close )\n  lua_close(L);\n```\n\n## Lua module\nIf you using standalone Lua. you can use lua c mocule.\n\n### Build and Install with [LuaRocks](https://luarocks.org/)\n```\nluarocks install lrdb\n```\n\n### Build module your self\n```\nmkdir build\ncd build\ncmake ../ -DLUA=lua-5.3\ncmake --build --target lrdb_server\n```\nGenerated lrdb_server.so or lrdb_server.dll\n\n\n### Use module\n```lua\nlrdb = require(\"lrdb_server\")\nlrdb.activate(21110) --21110 is using port number. waiting for connection by debug client.\n\n--debuggee lua code\ndofile(\"luascript.lua\");\n\nlrdb.deactivate() --deactivate debug server if you want.\n```\n\n## Visual Studio Code Extension\nhttps://github.com/satoren/vscode-lrdb","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsatoren%2Flrdb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsatoren%2Flrdb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsatoren%2Flrdb/lists"}