From a824cee84f6c82270aeb674c8d19ad1d6227de57 Mon Sep 17 00:00:00 2001 From: Magnus Ottenklinger Date: Tue, 19 Sep 2023 09:06:03 +0200 Subject: [PATCH] Deprecate docception --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index a694b3b..22c2eb4 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,25 @@ Run doctests on arbitrary markdown files. +## DEPRECATION NOTICE + +As of Elixir 1.15, this dependency can be replaced by using the +[doctest_file/1,2](https://hexdocs.pm/ex_unit/1.15/ExUnit.DocTest.html#doctest_file/2) macro +provided by ExUnit itself, see #11 (thanks @axelson for pointing this out). To use this +on a range of files, you can create a simple test module in your `test/` directory: + +```elixir +defmodule DocTest do + use ExUnit.Case + # You could also use a wildcard below + for file <- ["README.md"] do + doctest_file(file) + end +end +``` + +--- + ## Usage $ mix docception markdown-files