From patchwork Sun Apr 3 13:59:42 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Stefano Sabatini X-Patchwork-Id: 35153 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:c05:b0:7a:e998:b410 with SMTP id bw5csp1586895pzb; Sun, 3 Apr 2022 09:29:51 -0700 (PDT) X-Google-Smtp-Source: ABdhPJzcj//UC8AorfqETzUqvcqdXoN9zyIfiH2YxvEzqUi+v2Wdf2wUTPdsNJBv1Pxi/f1M2CSy X-Received: by 2002:a17:907:724d:b0:6df:ff4c:8941 with SMTP id ds13-20020a170907724d00b006dfff4c8941mr7641046ejc.10.1649003391740; Sun, 03 Apr 2022 09:29:51 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1649003391; cv=none; d=google.com; s=arc-20160816; b=ZwYKGdL43unXZnCH38X5x7RoaH3TYuzi1iFWcJdvvlGGx43zNljII93AqMK+h9EkyO alMsbu0jWV80ZeihZ35YE6DKQzQrsfTgtLhok+ZhnI4BUPEPXtaAlSnDLdKTqb7VHibk LCEL7/db0q0nLXivxLqc5cSKP271FD4E6QBIYVkjmDoNwJYhuZAETgN0isP23FiEbBV4 a0rVWsLLtGJ5CpRJ5vwq2VU62/yUJf2kdNdPgrTFeQUs/vsEcphTREkQhhPCA3tDRp3c 83LH9jSn1ozWrNIZtD0nUtqQqCWeJy9cjTB4XQK5y2K52bvxJN3Ac7ii8ggLvSs31ja3 Rlkg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:cc:reply-to :list-subscribe:list-help:list-post:list-archive:list-unsubscribe :list-id:precedence:subject:mime-version:message-id:date:to:from :dkim-signature:delivered-to; bh=8675UrpfxhFSNKQOJmv51l+J/9b/UI7Voc0DqWCpt10=; b=FoWHqSRXNEjzt0kpgVOUP98NvWfHngdQ8dbdadC1+jrAQqS5Nfh7hHdIIaQty90EWh qYSQDbbBPfOQObhr4OESfFEtt7lVrRcxkh2OjOHzIYfnXNt6XXhSoqRYoJVnNy3GhEcf 030JYuQI7h0P5d5LvZN7dob18FjvyiRdiJwuWNRmXqEpQL3/D822clvXSvXUnLF+LJA3 JBRTuN+Bv0lJPt0rSOhptj/rV1MVnsgiEmMxsANYODW/Prf/2k/Q9kpdH6Jifqnec6VP J8VrSIY1PAONR4YXCNdusiX+4luG4LuPppiZ1tfdWQemSPmbrRhp6NYYtWXf6g4dU7rZ jfGA== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b="lNda30/Z"; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id qk11-20020a170906d9cb00b006e7ecb3d442si910106ejb.649.2022.04.03.09.29.51; Sun, 03 Apr 2022 09:29:51 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20210112 header.b="lNda30/Z"; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id 94A0B68B253; Sun, 3 Apr 2022 19:29:47 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail-ej1-f44.google.com (mail-ej1-f44.google.com [209.85.218.44]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 8A8AB68B0D6 for ; Sun, 3 Apr 2022 19:29:40 +0300 (EEST) Received: by mail-ej1-f44.google.com with SMTP id qh7so5361941ejb.11 for ; Sun, 03 Apr 2022 09:29:40 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=lOfO6rMLrWKg3lPgnGbQHmjjIBAYVvZUSUId7CJAFro=; b=lNda30/Za8PkG/xYRT67kkPZJ4ak6Kqeo/eN5JgN6Usmf/BKfgueGEUHZHcYd48I6i w2sKUkwWdlbkhVlCK8D1zzZDL/8u9BNWUMS+qWfSQCuMb79PuE6IizDN4p0eVQ8iPQm8 AdGev8FCPGhh+cmQ8gQvisbW69o09bVi26Qbf8bPi7TlVL+QYKZWWqGOi7l9pt/wI9e6 BfAbtxQbQXVnGKDACSeGLBQGECaSMvaxQIGyKRlXiUoRVcpeu9kh9wuIVeZMPIocssRF 0f++CLWoviOytuuY2AwW7+WjQ9JLIIFXT4V3r+B4T2VbiqIGdb0IkDfkVENDhTj0SH99 wtRg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=lOfO6rMLrWKg3lPgnGbQHmjjIBAYVvZUSUId7CJAFro=; b=XxqXqvSP1ooYC4W2FTK6zi6FbWyFiV3WJnvHb78egIYxDMQdSPsdghtkQWQtlxndu4 OeUVe5iJPqXyFrdjjJ0Ujkw24Lk7zGXlUxjhN0ARcw4fe/SEQ8Y6E1t4PmRGMV7os5R/ S//PozNBlwxSlAEWJ7AShuPFwItrW7f1zQl1g0J/zx5KG0PDxf5Aiuz7IJ1olk7h4DUV e4peow89t5wXvLzLSth+QblaHxnzE5cz+g54pFm47uKTOArLgxp1iINfOkUqnhuZQbHL h1md9ZqZhXwKN7scnjLQz009KijFrEdL72UFFBJ0Q+WHCy4UJpkhM0qtBLxJ9u87Gvlg /mQA== X-Gm-Message-State: AOAM533kHY+fejtTvjszO4inmlCMTn1UNS0J9zyzW88aHlcKrDvJQBoO wGFluaM5J2lWzUgQ9vuOO+xuDLDg+/su0g== X-Received: by 2002:a17:907:3d9e:b0:6e0:ac96:c1e6 with SMTP id he30-20020a1709073d9e00b006e0ac96c1e6mr7765398ejc.532.1649003379599; Sun, 03 Apr 2022 09:29:39 -0700 (PDT) Received: from mariano (dynamic-adsl-78-14-80-42.clienti.tiscali.it. [78.14.80.42]) by smtp.gmail.com with ESMTPSA id m17-20020a17090672d100b006df98bb199dsm3407114ejl.129.2022.04.03.09.29.39 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 03 Apr 2022 09:29:39 -0700 (PDT) Received: by mariano (Postfix, from userid 1000) id 42077BFA54; Sun, 3 Apr 2022 15:59:42 +0200 (CEST) From: Stefano Sabatini To: FFmpeg development discussions and patches Date: Sun, 3 Apr 2022 15:59:42 +0200 Message-Id: <20220403135942.303691-1-stefasab@gmail.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 3/3] tests: add README.md file with simple instructions X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Cc: Stefano Sabatini Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: UYhNubER8lL1 --- tests/README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 tests/README.md diff --git a/tests/README.md b/tests/README.md new file mode 100644 index 0000000000..4bcae0b403 --- /dev/null +++ b/tests/README.md @@ -0,0 +1,48 @@ +FFmpeg tests +============ + +Tests are useful to make sure that code changes do not introduce regressions. + +## FATE tests + +FATE (FFmpeg Automated Test Environment) is the system used to test +regressions and should be used for new changes which affect the API or +components behavior. + +To run all tests, run the following command from the commandline: +``` +make fate +``` + +To get the complete list of tests: +``` +make fate-list +``` + +You can specify a subset of tests to run by specifying the +corresponding element form the list with the `fate-` prefix, e.g.: +``` +make fate-ffprobe_compact fate-ffprobe_xml +``` + +## FATE samples + +By default, FFmpeg uses only the standalone tests. To use the +collected FATE samples, you need download and configure the tests with +the FATE samples path. + +To upload or update the samples, run the command: +``` +make fate-rsync SAMPLES=/path/to/samples +``` + +Then you need to setup the path where the samples are located, either +when configuring with: +``` +./configure --samples=path/to/fate/samples +``` + +or when running the tests with: +``` +FATE_SAMPLES=path/to/fate/samples make fate +```