{"id":32170840,"url":"https://github.com/dymmer-code/blacklist","last_synced_at":"2026-05-26T13:33:41.931Z","repository":{"id":45412715,"uuid":"175225606","full_name":"dymmer-code/blacklist","owner":"dymmer-code","description":"Blacklist using Akismet for Elixir","archived":false,"fork":false,"pushed_at":"2021-12-15T02:47:39.000Z","size":21,"stargazers_count":3,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-12-13T01:47:06.070Z","etag":null,"topics":["elixir-lang","elixir-library","phoenix-framework","tesla-api"],"latest_commit_sha":null,"homepage":null,"language":"Elixir","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"lgpl-2.1","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dymmer-code.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-03-12T14:12:33.000Z","updated_at":"2022-08-13T20:02:15.000Z","dependencies_parsed_at":"2022-09-17T04:50:45.745Z","dependency_job_id":null,"html_url":"https://github.com/dymmer-code/blacklist","commit_stats":null,"previous_names":["altenwald/blacklist"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/dymmer-code/blacklist","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymmer-code%2Fblacklist","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymmer-code%2Fblacklist/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymmer-code%2Fblacklist/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymmer-code%2Fblacklist/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dymmer-code","download_url":"https://codeload.github.com/dymmer-code/blacklist/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dymmer-code%2Fblacklist/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29681468,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-21T12:30:22.644Z","status":"ssl_error","status_checked_at":"2026-02-21T12:29:55.402Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["elixir-lang","elixir-library","phoenix-framework","tesla-api"],"created_at":"2025-10-21T17:36:22.257Z","updated_at":"2026-02-21T13:01:15.888Z","avatar_url":"https://github.com/dymmer-code.png","language":"Elixir","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Blacklist\n\n[![hex.pm](https://img.shields.io/hexpm/v/blacklist.svg)](https://hex.pm/packages/blacklist)\n[![hexdocs.pm](https://img.shields.io/badge/hex-docs-lightgreen.svg)](https://hexdocs.pm/blacklist/)\n[![hex.pm](https://img.shields.io/hexpm/dt/blacklist.svg)](https://hex.pm/packages/blacklist)\n[![hex.pm](https://img.shields.io/hexpm/l/blacklist.svg)](https://hex.pm/packages/blacklist)\n[![github.com](https://img.shields.io/github/last-commit/dymmer-code/blacklist.svg)](https://github.com/dymmer-code/blacklist/commits/master)\n\nBlacklist check with [Akismet API](https://akismet.com/development/api/#comment-check) implemented with [Tesla](https://hex.pm/packages/tesla).\n\nThis is very useful to check if a message coming from a contact form is a _ham_ or _spam_ one.\n\n## Installation\n\nAdd `blacklist` to your list of dependencies in `mix.exs`:\n\n```elixir\ndef deps do\n  [\n    {:blacklist, \"~\u003e 0.1\"}\n  ]\nend\n```\n\n## Usage\n\n```elixir\nBlacklist.check author, email, locale, user_agent, user_ip, content\n# false\n```\n\nThe information provided to check if the message is spam is as follow:\n\n- `author`: author name of the message.\n- `email`: email for the author of the message.\n- `locale`: language used for the message. It should be in ISO-639 (es, en, ...).\n- `user_agent`: the user agent of the browser used to send the message.\n- `user_ip`: the user IP where the message came from.\n- `content`: the content of the message.\n\nThe result of the function will be or a boolean indicating if it's spam or not, or an error in case something went wrong.\n\nThis depends on an external service and you should to configure the credentials to use it:\n\n```elixir\nconfig :blacklist, api_key: \"xxxxxxxxxxxx\",\n                   blog: \"https://...\"\n```\n\nThe values are:\n\n- `api_key`: the API key provided by Akismet website.\n- `blog`: the URL of your website.\n\nYou can use also the configuration to use a custom blacklist. The configuration for the blacklist is as follow (you can merge both configurations to generate only one):\n\n```elixir\nconfig :blacklist, name: [],\n                   email: [\"@mail.ru\", \"@plusgmail.ru\", \"@seocdvig.ru\"]\n```\n\nEnjoy!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdymmer-code%2Fblacklist","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdymmer-code%2Fblacklist","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdymmer-code%2Fblacklist/lists"}