Method _register_fixture

src/_pytest/fixtures.py:1949–2025

Register a fixture :param name: The fixture's name. :param func: The fixture's implementation function. :param nodeid: The visibility of the fixture (deprecated, use node instead). The fixture will be available to the node with

(
        self,
        *,
        name: str,
        func: _FixtureFunc[object],
        nodeid: str | None | NotSetType = NOTSET,
        scope: Scope | ScopeName | Callable[[str, Config], ScopeName] = "function",
        params: Sequence[object] | None = None,
        ids: tuple[object | None, ...] | Callable[[Any], object | None] | None = None,
        autouse: bool = False,
        node: nodes.Node | NotSetType = NOTSET,
    )

        items[:] = reorder_items(items)

    def _register_fixture(
        self,
        *,
        name: str,
        func: _FixtureFunc[object],
        nodeid: str | None | NotSetType = NOTSET,
        scope: Scope | ScopeName | Callable[[str, Config], ScopeName] = class="st">"function",
        params: Sequence[object] | None = None,
        ids: tuple[object | None, ...] | Callable[[Any], object | None] | None = None,
        autouse: bool = False,
        node: nodes.Node | NotSetType = NOTSET,
    ) -> None:
        class="st">"""Register a fixture

        :param name:
            The fixture&class="cm">#x27;s name.
        :param func:
            The fixture&class="cm">#x27;s implementation function.
        :param nodeid:
            The visibility of the fixture (deprecated, use node instead).
            The fixture will be available to the node with this nodeid and
            its children in the collection tree. None means global visibility.
        :param node:
            The node where the fixture is defined (preferred over nodeid).
            When provided, enables node-based matching which is more robust.
        :param scope:
            The fixture&class="cm">#x27;s scope.
        :param params:
            The fixture&class="cm">#x27;s parametrization params.
        :param ids:
            The fixture&class="cm">#x27;s IDs.
        :param autouse:
            Whether this is an autouse fixture.
        class="st">"""
        class="cm"># Emit deprecation warning if nodeid string.
        if nodeid is not NOTSET or node is NOTSET:
            warnings.warn(FIXTURE_NODEID_DEPRECATED, stacklevel=2)
        fixture_def = FixtureDef(
            config=self.config,
            baseid=nodeid,
            argname=name,
            func=func,
            scope=scope,
            params=params,
            ids=ids,
            _ispytest=True,
            _autouse=autouse,
            node=node,
        )

        faclist = self._arg2fixturedefs.setdefault(name, [])
        class="cm"># Insert the fixturedef into the list while maintaining a partial order
        class="cm"># based on visibility: a fixturedef whose visibility is more specific
        class="cm"># sorts after a more general one, so that it takes precedence in the
        class="cm"># override chain (the last applicable fixturedef in the list is used
        class="cm"># first, see getfixturedefs).
        class="cm"># fixturedefs with the same visibility keep registration order, i.e. the
        class="cm"># last registered wins.