{"id":20430757,"url":"https://github.com/jaguar-dart/jaguar_rpc","last_synced_at":"2026-04-17T22:01:51.006Z","repository":{"id":56833226,"uuid":"115177098","full_name":"Jaguar-dart/jaguar_rpc","owner":"Jaguar-dart","description":"A simple JSON based RPC protocol","archived":false,"fork":false,"pushed_at":"2018-08-22T12:16:49.000Z","size":6989,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-15T17:32:53.104Z","etag":null,"topics":["dartlang","jaguar","json","rpc","rpc-server","server"],"latest_commit_sha":null,"homepage":null,"language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jaguar-dart.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-12-23T06:53:26.000Z","updated_at":"2023-11-27T21:49:42.000Z","dependencies_parsed_at":"2022-09-08T07:10:43.042Z","dependency_job_id":null,"html_url":"https://github.com/Jaguar-dart/jaguar_rpc","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/Jaguar-dart%2Fjaguar_rpc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaguar-dart%2Fjaguar_rpc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaguar-dart%2Fjaguar_rpc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jaguar-dart%2Fjaguar_rpc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jaguar-dart","download_url":"https://codeload.github.com/Jaguar-dart/jaguar_rpc/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241975135,"owners_count":20051428,"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":["dartlang","jaguar","json","rpc","rpc-server","server"],"created_at":"2024-11-15T08:08:53.147Z","updated_at":"2026-04-17T22:01:50.993Z","avatar_url":"https://github.com/Jaguar-dart.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# jaguar_rpc\n\nA simple JSON based RPC protocol\n\n# Example\n\n## HTTP\n\n```dart\nmain() async {\n  int contactIdGen = 0;\n\n  // RPC endpoint\n  final endpoint = new RpcEndpoint()\n    ..route('/get/version', (_) =\u003e response(body: {'major': '1', 'minor': '0'}))\n    ..route('/add/todo', (RpcRequest req) {\n      final newContact = new Contact.fromJson(req.body);\n      newContact.id = contactIdGen++;\n      contacts.contacts.add(newContact);\n      return response(body: contacts.json);\n    });\n\n  // Serve the endpoint with Jaguar http server\n  final server = new Jaguar();\n  server.addApi(rpcOnHttp(endpoint));\n  await server.serve();\n}\n```\n\nClient:\n\n```dart\nmain() async {\n  final client =\n      new JsonClient(new http.IOClient(), basePath: 'http://localhost:8080/');\n  {\n    final resp =\n        await client.post('/get/version', body: request('/get/version').toMap);\n    final rpcResp = new RpcResponse.decodeJson(resp.bodyStr);\n    print(rpcResp.status);\n    print(rpcResp.body);\n  }\n  {\n    final resp = await client.post('/add/todo',\n        body: request('/add/todo',\n                body: new Contact(name: 'teja', email: 'tejainece@gmail.com')\n                    .json)\n            .toMap);\n    final rpcResp = new RpcResponse.decodeJson(resp.bodyStr);\n    print(rpcResp.status);\n    print(rpcResp.body);\n  }\n}\n```\n\n## Websocket server\n\n```dart\nmain() async {\n  int contactIdGen = 0;\n\n  // RPC endpoint\n  final endpoint = new RpcEndpoint()\n    ..route('/get/version', (_) =\u003e response(body: {'major': '1', 'minor': '0'}))\n    ..route('/add/todo', (RpcRequest req) {\n      final newContact = new Contact.fromJson(req.body);\n      newContact.id = contactIdGen++;\n      contacts.contacts.add(newContact);\n      return response(body: contacts.json);\n    });\n\n  // Serve the endpoint with Jaguar http server\n  final server = new Jaguar();\n  server.get('/ws', rpcOnWebSocket(endpoint));\n  await server.serve();\n}\n```\n\nClient:\n\n```dart\nmain() async {\n  // Client\n  final WebSocket socket = await WebSocket.connect('ws://localhost:8080/ws');\n  final Stream\u003cRpcResponse\u003e data =\n      socket.asBroadcastStream().map((d) =\u003e new RpcResponse.decodeJson(d));\n  {\n    socket.add(request('/get/version').json);\n    final RpcResponse rpcResp = await data.first;\n    print(rpcResp.status);\n    print(rpcResp.body);\n  }\n  {\n    socket.add(request('/add/todo',\n            body: new Contact(name: 'teja', email: 'tejainece@gmail.com').toMap)\n        .json);\n    final RpcResponse rpcResp = await data.first;\n    print(rpcResp.status);\n    print(rpcResp.body);\n  }\n}\n```\n\n## WebSocket IO client\n\n```dart\nmain() async {\n  // Client\n  final RpcWebSocketClient socket =\n      await RpcWebSocketClient.connect('ws://localhost:8080/ws');\n  {\n    final RpcResponse rpcResp = await socket.send(request('/get/version'));\n    print(rpcResp.status);\n    print(rpcResp.body);\n  }\n  {\n    final RpcResponse rpcResp = await socket.send(request('/add/todo',\n        body: new Contact(name: 'teja', email: 'tejainece@gmail.com').toMap));\n    print(rpcResp.status);\n    print(rpcResp.body);\n  }\n}\n```\n\n## Isolate\n\n\u003e TODO\n\n## TCP\n\n\u003e TODO\n\n## Plain\n\n```dart\nmain() {\n  int contactIdGen = 0;\n\n  final server = new RpcEndpoint()\n    ..route('/get/version', (_) =\u003e response(body: {'major': '1', 'minor': '0'}))\n    ..route('/add/todo', (RpcRequest req) {\n      final newContact = new Contact.fromJson(req.body);\n      newContact.id = contactIdGen++;\n      contacts.contacts.add(newContact);\n      return response(body: contacts.json);\n    });\n\n  {\n    final RpcResponse resp = server.handleRequest(request('/get/unknown'));\n    print(resp.status);\n  }\n\n  {\n    final RpcResponse resp = server.handleRequest(request('/add/todo',\n        body: new Contact(name: 'teja', email: 'tejainece@gmail.com').json));\n    print(resp.status);\n    print(resp.body);\n  }\n}\n```\n\n# Native extension\n\n\u003e TODO\n\n# TODO\n\n+ [X] HTTP interface\n+ [X] Websocket interface\n+ [ ] TCP interface\n+ [ ] Isolate interface","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaguar-dart%2Fjaguar_rpc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjaguar-dart%2Fjaguar_rpc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjaguar-dart%2Fjaguar_rpc/lists"}