{"action":"published","release":{"url":"https://api.github.com/repos/dullgiulio/perso/releases/1145473","assets_url":"https://api.github.com/repos/dullgiulio/perso/releases/1145473/assets","upload_url":"https://uploads.github.com/repos/dullgiulio/perso/releases/1145473/assets{?name}","html_url":"https://github.com/dullgiulio/perso/releases/tag/v0.1-alpha","id":1145473,"tag_name":"v0.1-alpha","target_commitish":"master","name":"v0.1.1-alpha","draft":false,"author":{"login":"dullgiulio","id":578051,"avatar_url":"https://avatars.githubusercontent.com/u/578051?v=3","gravatar_id":"","url":"https://api.github.com/users/dullgiulio","html_url":"https://github.com/dullgiulio","followers_url":"https://api.github.com/users/dullgiulio/followers","following_url":"https://api.github.com/users/dullgiulio/following{/other_user}","gists_url":"https://api.github.com/users/dullgiulio/gists{/gist_id}","starred_url":"https://api.github.com/users/dullgiulio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dullgiulio/subscriptions","organizations_url":"https://api.github.com/users/dullgiulio/orgs","repos_url":"https://api.github.com/users/dullgiulio/repos","events_url":"https://api.github.com/users/dullgiulio/events{/privacy}","received_events_url":"https://api.github.com/users/dullgiulio/received_events","type":"User","site_admin":false},"prerelease":true,"created_at":"2015-04-09T16:22:27Z","published_at":"2015-04-09T16:37:45Z","assets":[{"url":"https://api.github.com/repos/dullgiulio/perso/releases/assets/514973","id":514973,"name":"perso-amd64.gz","label":null,"uploader":{"login":"dullgiulio","id":578051,"avatar_url":"https://avatars.githubusercontent.com/u/578051?v=3","gravatar_id":"","url":"https://api.github.com/users/dullgiulio","html_url":"https://github.com/dullgiulio","followers_url":"https://api.github.com/users/dullgiulio/followers","following_url":"https://api.github.com/users/dullgiulio/following{/other_user}","gists_url":"https://api.github.com/users/dullgiulio/gists{/gist_id}","starred_url":"https://api.github.com/users/dullgiulio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dullgiulio/subscriptions","organizations_url":"https://api.github.com/users/dullgiulio/orgs","repos_url":"https://api.github.com/users/dullgiulio/repos","events_url":"https://api.github.com/users/dullgiulio/events{/privacy}","received_events_url":"https://api.github.com/users/dullgiulio/received_events","type":"User","site_admin":false},"content_type":"application/gzip","state":"uploaded","size":1692323,"download_count":0,"created_at":"2015-04-09T16:33:54Z","updated_at":"2015-04-09T16:34:40Z","browser_download_url":"https://github.com/dullgiulio/perso/releases/download/v0.1-alpha/perso-amd64.gz"},{"url":"https://api.github.com/repos/dullgiulio/perso/releases/assets/514972","id":514972,"name":"perso-i386.gz","label":null,"uploader":{"login":"dullgiulio","id":578051,"avatar_url":"https://avatars.githubusercontent.com/u/578051?v=3","gravatar_id":"","url":"https://api.github.com/users/dullgiulio","html_url":"https://github.com/dullgiulio","followers_url":"https://api.github.com/users/dullgiulio/followers","following_url":"https://api.github.com/users/dullgiulio/following{/other_user}","gists_url":"https://api.github.com/users/dullgiulio/gists{/gist_id}","starred_url":"https://api.github.com/users/dullgiulio/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dullgiulio/subscriptions","organizations_url":"https://api.github.com/users/dullgiulio/orgs","repos_url":"https://api.github.com/users/dullgiulio/repos","events_url":"https://api.github.com/users/dullgiulio/events{/privacy}","received_events_url":"https://api.github.com/users/dullgiulio/received_events","type":"User","site_admin":false},"content_type":"application/gzip","state":"uploaded","size":1649748,"download_count":0,"created_at":"2015-04-09T16:33:53Z","updated_at":"2015-04-09T16:34:13Z","browser_download_url":"https://github.com/dullgiulio/perso/releases/download/v0.1-alpha/perso-i386.gz"}],"tarball_url":"https://api.github.com/repos/dullgiulio/perso/tarball/v0.1-alpha","zipball_url":"https://api.github.com/repos/dullgiulio/perso/zipball/v0.1-alpha","body":"# perso - Maildir to REST\r\n\r\n## About\r\n\r\nPerso is a small, self-contained REST server for a Maildir mailbox.\r\n\r\nIt includes configurable header indexing and crawling.\r\n\r\nPerso is useful when used on testing or staging sites to have a quick\r\nmeans to access a mailbox remotely, for example by a integration testing\r\nframework.\r\n\r\nPerso can make you forget about POP/IMAP servers for simple use cases.\r\n\r\n## Downloads\r\n\r\nIf you use Linux, download the attached file and unzip:\r\n\r\n```sh\r\n$ gunzip perso-amd64.gz\r\n```\r\n\r\nAnd check the digital signature:\r\n```\r\nSHA1: 124c3e6d8f1d815df6fbed9dafc69c5c perso-amd64\r\nMD5: d9fd097a97a3a26de3f29b9d8b1f82eb perso-amd64\r\nSHA1: f3f127d2a3cf3af803dfc42da6381050a7117255 perso-i386\r\nMD5: 124c3e6d8f1d815df6fbed9dafc69c5c perso-i386\r\n```\r\n\r\nFor other operating systems, please read the README for building instructions.\r\n\r\n## Getting Started\r\n\r\nDownload the and unzip the binary (see above.)\r\n\r\n'cd' to a directory containing e-mail messages (a Maildir,\r\nusually containing subdirectories 'cur', 'new' and 'tmp').\r\n\r\nAnd, presto, you can run \"perso\".\r\n\r\n```sh\r\n$ cd ~/Mail/ # For example\r\n$ perso\r\n\r\n```\r\n\r\nNow perso is listening on port 8888. Just point your browser to\r\nhttp://localhost:8888/ to proceed. You should be able to see your latest\r\nemail message.\r\n\r\nA short help is also available: http://localhost:8888/help\r\n\r\nGood, that was it. Read on if you want to know what you just did!\r\n\r\n## How does it work?\r\n\r\nPerso works in a very simple way: first it reads all email messages it finds,\r\nthen makes an index for each indexed header. By default, it indices 'To' and\r\n'From'.\r\n\r\nFor each indexed header, you can go through the matching messages in\r\nchronological order.\r\n\r\n```\r\n/from/hello@mysite.com/latest/0\r\n```\r\n\r\nThe first part is the header we want to use to select (in lowercase, so that\r\n'X-Mailer' becomes just 'x-mailer'). The second part is the value we want the\r\nheader to have (or contain, see below).\r\n\r\nFinally, '/latest/N' will give the Nth message from the newest, while\r\n'/older/N' will grab starting from the oldest you have.\r\n\r\nYou can specify your own headers to index when you start \"presto\", see the\r\ninvocation section below.\r\n\r\nInstead of just a number, the last part of the URL can be a range (N-M) or\r\nN,M meaning: from mail N, M messages. Ranges are inclusive (Mth mail is shown.)\r\n\r\nThe messages will be shown in 'mbox' format. In other words, full RFC 2822,\r\nwith a \"From MAILER-DAEMON-PERSO...\" line between each message. The content of the 'Form'\r\nseparator is configurable for easy splitting (mbox format sucks, sorry).\r\n\r\n## Bugs\r\n\r\nPlease report bugs or suggestions: https://github.com/dullgiulio/perso/issues\r\n\r\n## References\r\n\r\n1. Maildir: http://cr.yp.to/proto/maildir.html\r\n2. mbox format: https://en.wikipedia.org/wiki/Mbox"}}