{"id":20273451,"url":"https://github.com/justusadam/marvin","last_synced_at":"2025-04-11T04:42:56.980Z","repository":{"id":140082126,"uuid":"69334381","full_name":"JustusAdam/marvin","owner":"JustusAdam","description":"The paranoid bot (framework)","archived":false,"fork":false,"pushed_at":"2022-02-24T16:00:12.000Z","size":535,"stargazers_count":53,"open_issues_count":10,"forks_count":6,"subscribers_count":11,"default_branch":"master","last_synced_at":"2025-04-11T04:42:51.266Z","etag":null,"topics":["bot","haskell","hubot","irc","irc-bot","slack","slack-bot","telegram","telegram-bot"],"latest_commit_sha":null,"homepage":"https://marvin.readthedocs.io","language":"Haskell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JustusAdam.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2016-09-27T08:14:16.000Z","updated_at":"2024-08-10T12:00:27.000Z","dependencies_parsed_at":"2024-03-31T00:15:42.732Z","dependency_job_id":null,"html_url":"https://github.com/JustusAdam/marvin","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JustusAdam%2Fmarvin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JustusAdam%2Fmarvin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JustusAdam%2Fmarvin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JustusAdam%2Fmarvin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JustusAdam","download_url":"https://codeload.github.com/JustusAdam/marvin/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248345281,"owners_count":21088242,"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":["bot","haskell","hubot","irc","irc-bot","slack","slack-bot","telegram","telegram-bot"],"created_at":"2024-11-14T12:49:07.045Z","updated_at":"2025-04-11T04:42:56.968Z","avatar_url":"https://github.com/JustusAdam.png","language":"Haskell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Marvin, the paranoid bot (β stage)\n\n[![Travis](https://travis-ci.org/JustusAdam/marvin.svg?branch=master)](https://travis-ci.org/JustusAdam/marvin)\n[![Hackage](https://img.shields.io/hackage/v/marvin.svg)](http://hackage.haskell.org/package/marvin)\n\nMarvin is an attempt to combine the ease of use of [hubot](https://hubot.github.com) with the typesafety and easy syntax of Haskell and the performance gains from compiled languages.\n\n## Installing and using marvin\n\nThe verbose documentation can be found on readthedocs https://marvin.readthedocs.io.\nIt should hopefully answer all your questions.\n\nInstallation instructions are on [this](http://marvin.readthedocs.io/en/latest/getting-started.html) documentation page.\n\n## Links\n\n- [Documentation](https://marvin.readthedocs.io)\n- [Hackage](https://hackage.haskell.org/package/marvin)\n- [Repository](https://github.com/JustusAdam/marvin)\n- [Bugtracker](https://github.com/JustusAdam/marvin/issues)\n- [Documentation repository](https://github.com/JustusAdam/marvin-docs) and [bugtracker](https://github.com/JustusAdam/marvin-docs/issues)\n- [Slack channel][slack-channel] ([signup instructions](#testing-and-talking))\n\n[slack-channel]: https://marvin-bot.slack.com\n\n## A teaser\n\n```Haskell\nmodule MyScript where\n\nimport Marvin.Prelude\n\nscript :: (IsAdapter a, SupportsFiles a) =\u003e ScriptInit a\nscript = defineScript \"my-script\" $ do\n    hear \"sudo (.+)\" $ do\n        match \u003c- getMatch\n\n        reply $(isL \"All right, i'll do #{match !! 1}\")\n    \n    respond \"repeat\" $ do\n        message \u003c- getMessage\n\n        send $(isL \"You wrote #{message}\")\n    \n    respond \"what is in file ([\\\\w\\\\._/-]+)\\\\??\" $ do\n        match \u003c- getMatch \n        let file = match !! 1\n\n        contents \u003c- liftIO $ readFile file\n\n        send contents\n    \n    respond \"upload file ([\\\\w\\\\._/-]+)\" $ do\n        [_, filepath] \u003c- getMatch\n        chan \u003c- getChannel\n        f \u003c- sendFile filepath\n        case res of\n            Left err -\u003e send $(isL \"Failed to share file: #{err}\")\n            Right _  -\u003e send \"File successfully uploaded\"\n    \n    enterIn \"random\" $ do\n        user \u003c- getUser\n        send $(isL \"Hello #{user^.username} welcome to the random channel!\")\n    \n    fileSharedIn \"announcements\" $ do\n        file \u003c- getFile\n        safeFileToDir file \"shared-files\"\n```\n\n## Status of the project\n\nI currently do not actively develop this project. I am happy to merge pull requests but I will likely not have time to work on issues myself. It is also likely that the adapters are not up-to-date with the APIs they are supposed to interact with so be aware. \n\n**Maintenance Level**: Happy to merge\n\n**Accepting maintainers**: Yes\n\nFor information on the meaning of this see [commercialhaskell guide to OSS maintenance](https://github.com/commercialhaskell/commercialhaskell/blob/master/guide/open-source-maintenance.md) \n\n### Issues and errors\n\nIf you are a marvin user, please report any error, issues, or improvement suggestions to the [issue section](https://github.com/JustusAdam/marvin/issues) or [write me an email](mailto:dev@justus.science).\n\n### Testing\n\nI welcome anybody who tests marvin by deploying it. \nEspecially testing different adapters is a huge help.\n\n### Hacking\n\nIf you want to hack on marvin, feel free to do so and send me your changes as pull requests.\n\nCurrent hot places to get started:\n\n- Convenient HTTP requests API in `Marvin.Util.HTTP`.\n- Convenient JSON handling API in `Marvin.Util.JSON`.\n- New adapters as submodules of `Marvin.Adapter`.\n- A basic library of scripts (maybe as a `Marvin.Scripts.Prelude` module?) (inspiration: https://github.com/github/hubot-scripts)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustusadam%2Fmarvin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustusadam%2Fmarvin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustusadam%2Fmarvin/lists"}