From patchwork Thu May 4 12:37:45 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Juraj_Linke=C5=A1?= X-Patchwork-Id: 126680 Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id A315042A5D; Thu, 4 May 2023 14:37:55 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 39DF241144; Thu, 4 May 2023 14:37:55 +0200 (CEST) Received: from mail-ed1-f53.google.com (mail-ed1-f53.google.com [209.85.208.53]) by mails.dpdk.org (Postfix) with ESMTP id 0933A410DC for ; Thu, 4 May 2023 14:37:53 +0200 (CEST) Received: by mail-ed1-f53.google.com with SMTP id 4fb4d7f45d1cf-50bd87539c2so688852a12.0 for ; Thu, 04 May 2023 05:37:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=pantheon-tech.20221208.gappssmtp.com; s=20221208; t=1683203873; x=1685795873; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=Ei1M4C7oS/P6hXpdV1Fh608SOtzPEffAjZSsqRAcaes=; b=N78f0wL5dwKuPZg8bLl9JQqkBySIR7d32sQyBdVW9qVYo0dUmQBjoIYofzGFLiubkc zTZkF9PYJxTq4cTU9Ab5l1vS71cNCxjAKTVHhYSjJ89cyzbAsbxF8ajNkjTC5cWH4+4o 56XFWaQwBsAHoOP651f1i1j9gWIkX59KlUcVpU8tfc2Qmop3Q3heyVMwE9TsW9SZuIvp 7F6uo+Af0KgISleEXV6Ss1DDHXGoqe727xYfMxkP5hnT2kNZyAkoBJhJutj/dDTIjS7I E8QI/eTP1aaV8zP8UDfJkryrq+EC6ebJQ8sLQAIch2mLMuaeOwiFc3oEgHyudwGDMJ8E EYNw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1683203873; x=1685795873; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Ei1M4C7oS/P6hXpdV1Fh608SOtzPEffAjZSsqRAcaes=; b=Y4pWf5x5l+SvBMkpCbrBl0WNQJwi6DIcQ7yNA9T1eLgRwkWC5K7TYLsmfU7XWL2vWr h3eTOpBnm9NF5/j/DhnsLzBqoRdMjtfrRehGNXv/3Zznf2IIAuZrYvTMyEv4ZfojMgeH MXqbgrspQ4qzqQnUrS59RiO2/djxI5Hll+5T/ZPKwEBBWBLjFkFx4JneuNcL+nMsPOoh b0L867REAY5+FMHhJcUHyZ8KwezYFKGIphn29hkhSSyNfcqRJT0LP8TktojDMsh5ncGg Dax8UW9KFPqFE+HyniWWvropU90/+GI7nGetcKF2dlas+oBGsbWntENkIXd/dsoH1pir YEog== X-Gm-Message-State: AC+VfDzJxWf69AYlN/+VphD96rPSLhGmphhH0bnBVOtRKzf1d0huZVYp eqqh8kYEKO0aCf18Kkg4BkbsLQ== X-Google-Smtp-Source: ACHHUZ5zpwbaOpXCRlLXS0TJRa+8F9JkiPxrr6OSVRkGxmmKyaiIbEt4gWhe83bvZySnnIFw2nCTgA== X-Received: by 2002:a17:907:70a:b0:95e:c549:9ace with SMTP id xb10-20020a170907070a00b0095ec5499acemr6075602ejb.62.1683203873506; Thu, 04 May 2023 05:37:53 -0700 (PDT) Received: from localhost.localdomain (ip-46.34.246.203.o2inet.sk. [46.34.246.203]) by smtp.gmail.com with ESMTPSA id wz13-20020a170906fe4d00b00959c6b9dac8sm13679157ejb.197.2023.05.04.05.37.52 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 04 May 2023 05:37:53 -0700 (PDT) From: =?utf-8?q?Juraj_Linke=C5=A1?= To: thomas@monjalon.net, Honnappa.Nagarahalli@arm.com, lijuan.tu@intel.com, bruce.richardson@intel.com, wathsala.vithanage@arm.com, jspewock@iol.unh.edu, probb@iol.unh.edu Cc: dev@dpdk.org, =?utf-8?q?Juraj_Linke=C5=A1?= Subject: [RFC PATCH v2 0/4] dts: add dts api docs Date: Thu, 4 May 2023 14:37:45 +0200 Message-Id: <20230504123749.1417259-1-juraj.linkes@pantheon.tech> X-Mailer: git-send-email 2.30.2 In-Reply-To: <20230323104040.484708-1-juraj.linkes@pantheon.tech> References: <20230323104040.484708-1-juraj.linkes@pantheon.tech> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Augment the meson build system with dts api generation. The api docs are generated from Python docstrings in DTS using Sphinx. The format of choice is the Google format [0]. The guide html sphinx configuration is used to preserve the same style. The build requires the same Python version and dependencies as DTS, because Sphinx imports the Python modules. Dependencies are installed using Poetry from the dts directory: poetry install --with docs After installing, enter the Poetry shell: poetry shell And then run the build: ninja -C dts/doc There's only one properly documented module that serves as a demonstration of the style - framework.testbed_model.node. [0] https://google.github.io/styleguide/pyguide.html#s3.8.4-comments-in-classes Juraj Linkeš (4): dts: code adjustments for sphinx dts: add doc generation dependencies dts: add doc generation dts: format docstrigs to google format doc/api/meson.build | 1 + doc/guides/conf.py | 22 +- doc/guides/meson.build | 1 + doc/guides/tools/dts.rst | 29 + dts/doc/doc-index.rst | 20 + dts/doc/meson.build | 50 ++ dts/framework/config/__init__.py | 11 + .../{testbed_model/hw => config}/cpu.py | 13 + dts/framework/dts.py | 8 +- dts/framework/remote_session/__init__.py | 3 +- dts/framework/remote_session/linux_session.py | 2 +- dts/framework/remote_session/os_session.py | 12 +- .../remote_session/remote/__init__.py | 16 - .../{remote => }/remote_session.py | 0 .../{remote => }/ssh_session.py | 0 dts/framework/settings.py | 55 +- dts/framework/testbed_model/__init__.py | 10 +- dts/framework/testbed_model/hw/__init__.py | 27 - dts/framework/testbed_model/node.py | 164 ++-- dts/framework/testbed_model/sut_node.py | 9 +- .../testbed_model/{hw => }/virtual_device.py | 0 dts/main.py | 3 +- dts/meson.build | 16 + dts/poetry.lock | 770 ++++++++++++++++-- dts/pyproject.toml | 7 + dts/tests/TestSuite_hello_world.py | 6 +- meson.build | 1 + meson_options.txt | 2 + 28 files changed, 1038 insertions(+), 220 deletions(-) create mode 100644 dts/doc/doc-index.rst create mode 100644 dts/doc/meson.build rename dts/framework/{testbed_model/hw => config}/cpu.py (95%) delete mode 100644 dts/framework/remote_session/remote/__init__.py rename dts/framework/remote_session/{remote => }/remote_session.py (100%) rename dts/framework/remote_session/{remote => }/ssh_session.py (100%) delete mode 100644 dts/framework/testbed_model/hw/__init__.py rename dts/framework/testbed_model/{hw => }/virtual_device.py (100%) create mode 100644 dts/meson.build