From nobody Mon Feb 9 11:30:37 2026 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=philmd@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=philmd@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1632762216; cv=none; d=zohomail.com; s=zohoarc; b=e+3qYiQBI5Gd2XHfp5ZB0rUbJmTfp6yQf4KxSBZfNAHxC5RU3sXpq5jD2Uv/Ts/sHG8goU4BEYee1ibQuRrFbedrG0AS1eWyDFC7ePRNOcwc7xJnVMpc70YxMoP+0F8Vi00S/fOEIIsgvbAaK67Ix9bmSrGvhx2jVkly433Nr3Q= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1632762216; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=VcZeajeug5FjjL0Vw6aTUbYAKJ2OWK+8xl7oF2aw2Yg=; b=PiJrVZRXT5YS4Og4XTPCb8bRWUgyJNWExjIzZBsZh24gQYa9M7fGRbfOlC39NG9m9twoOA/Z3ccte9xsfJgFAq0XDQI/7EO9t7I9AGRlBJR+0lpxBId6gYZPwuZMdM2D2CTTqST6DkT7bPVhL5ORF7CYAqzcHXCJuxDOSWwcAIc= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=philmd@redhat.com; dmarc=pass header.from= (p=none dis=none) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 16327622167091019.5274367252471; Mon, 27 Sep 2021 10:03:36 -0700 (PDT) Received: from mail-wr1-f70.google.com (mail-wr1-f70.google.com [209.85.221.70]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-508-rqoKSDVsPKetKaMIRCh2tQ-1; Mon, 27 Sep 2021 13:03:33 -0400 Received: by mail-wr1-f70.google.com with SMTP id x2-20020a5d54c2000000b0015dfd2b4e34so14330639wrv.6 for ; Mon, 27 Sep 2021 10:03:33 -0700 (PDT) Return-Path: Return-Path: Received: from x1w.redhat.com (118.red-83-35-24.dynamicip.rima-tde.net. [83.35.24.118]) by smtp.gmail.com with ESMTPSA id i1sm18026488wrb.93.2021.09.27.10.03.31 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 27 Sep 2021 10:03:31 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1632762214; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=VcZeajeug5FjjL0Vw6aTUbYAKJ2OWK+8xl7oF2aw2Yg=; b=IsWLFHZZnt9YOUePVkcGOJGfWtR1hr/YhbYhkFkZ4qsz/4dkXMjDL7gWkQWLVKEXqNLW+/ 2Gvts5t14BXqBUF47MsubZewOG1L9CW439KcDfZSL1dP0el/J1QMouaF6sEbW1grPQtRet gdVTcihq6cKoTAfE91VecT4T2cbHy+s= X-MC-Unique: rqoKSDVsPKetKaMIRCh2tQ-1 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:in-reply-to :references:mime-version:content-transfer-encoding; bh=VcZeajeug5FjjL0Vw6aTUbYAKJ2OWK+8xl7oF2aw2Yg=; b=ZJEr6fCMGbOMnfbcdpcCRj4A5uV+VBrj77UBN4U1775U72sdz+f6y/CQ9mTNgg9eKX rtdIylvToMDP0ETmkWwDpx7ecNfZ5lsSxGIKE+wkWROM02iwrqd8XPLrvJ2nhHHlmr92 2UsN38FYbts914b5tz0uN9f9S5bIh2JzN7GF155FEZT6bssSHsBJQTW9DKMh1cVMQcHE ORNytw1jHl+6hRD0/ShazfNCnkVMG1nYOw+LI3BywjIhQgxhxc7DXFjkRBrV/Axm/eTK a5pttKgJS170sHoxSgWWVA+bGAkhKQ1mYr29nKvTDjd4bGrUonPa9oP6GUEqjg7AY0GJ TE0g== X-Gm-Message-State: AOAM531LpIZ4QCBTG2FRH5H0u0dRq4hA/PNqqRfpGYZ78eZt0SVob74w vOzKzTKuoFkIpxm0DCRmMkAG/XzRmcDygOJleJ/6Nnuv6I02nr8HaGrxhJZS7Q5fmuKFMMmnRpL cufPEaB+P2sIgAQ== X-Received: by 2002:a5d:43ca:: with SMTP id v10mr1073676wrr.139.1632762212092; Mon, 27 Sep 2021 10:03:32 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy0rm/vrSaFMIpx0IL74+ni1jvPIBw7S8oZns+HLKILW4h1j6iMoqkqGTGKgBiSZ7K80DyXpQ== X-Received: by 2002:a5d:43ca:: with SMTP id v10mr1073658wrr.139.1632762211937; Mon, 27 Sep 2021 10:03:31 -0700 (PDT) From: =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= To: qemu-devel@nongnu.org Cc: Willian Rampazzo , =?UTF-8?q?Philippe=20Mathieu-Daud=C3=A9?= Subject: [PULL 14/21] docs/devel/testing: add instruction to run a single acceptance test Date: Mon, 27 Sep 2021 19:02:20 +0200 Message-Id: <20210927170227.2014482-15-philmd@redhat.com> X-Mailer: git-send-email 2.31.1 In-Reply-To: <20210927170227.2014482-1-philmd@redhat.com> References: <20210927170227.2014482-1-philmd@redhat.com> MIME-Version: 1.0 Authentication-Results: relay.mimecast.com; auth=pass smtp.auth=CUSA124A263 smtp.mailfrom=philmd@redhat.com X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1632762219753100001 From: Willian Rampazzo Add instructions to the Acceptance tests section about running a single test file or a test within the test file. Signed-off-by: Willian Rampazzo Reviewed-by: Philippe Mathieu-Daud=C3=A9 Signed-off-by: Philippe Mathieu-Daud=C3=A9 Message-Id: <20210923161141.232208-3-willianr@redhat.com> --- docs/devel/testing.rst | 28 ++++++++++++++++++++++++++++ 1 file changed, 28 insertions(+) diff --git a/docs/devel/testing.rst b/docs/devel/testing.rst index d1841e35d57..c9f6b97f876 100644 --- a/docs/devel/testing.rst +++ b/docs/devel/testing.rst @@ -754,6 +754,34 @@ may be invoked by running: =20 tests/venv/bin/avocado run $OPTION1 $OPTION2 tests/acceptance/ =20 +Note that if ``make check-acceptance`` was not executed before, it is +possible to create the Python virtual environment with the dependencies +needed running: + + .. code:: + + make check-venv + +It is also possible to run tests from a single file or a single test within +a test file. To run tests from a single file within the build tree, use: + + .. code:: + + tests/venv/bin/avocado run tests/acceptance/$TESTFILE + +To run a single test within a test file, use: + + .. code:: + + tests/venv/bin/avocado run tests/acceptance/$TESTFILE:$TESTCLASS.$TESTNA= ME + +Valid test names are visible in the output from any previous execution +of Avocado or ``make check-acceptance``, and can also be queried using: + + .. code:: + + tests/venv/bin/avocado list tests/acceptance + Manual Installation ------------------- =20 --=20 2.31.1