Method add_collection

invoke/collection.py:285–324

Add `.Collection` ``coll`` as a sub-collection of this one. :param coll: The `.Collection` to add. :param str name: The name to attach the collection as. Defaults to the collection's own internal name. :param default: Whether th

(
        self,
        coll: "Collection",
        name: Optional[str] = None,
        default: Optional[bool] = None,
    )

            self.default = name

    def add_collection(
        self,
        coll: "Collection",
        name: Optional[str] = None,
        default: Optional[bool] = None,
    ) -> None:
        """
        Add `.Collection` ``coll`` as a sub-collection of this one.

        :param coll: The `.Collection` to add.

        :param str name:
            The name to attach the collection as. Defaults to the collection's
            own internal name.

        :param default:
            Whether this sub-collection('s default task-or-collection) should
            be the default invocation of the parent collection.

        .. versionadded:: 1.0
        .. versionchanged:: 1.5
            Added the ``default`` parameter.
        """
        # Handle module-as-collection
        if isinstance(coll, ModuleType):
            coll = Collection.from_module(coll)
        # Ensure we have a name, or die trying
        name = name or coll.name
        if not name:
            raise ValueError("Non-root collections must have a name!")
        name = self.transform(name)
        # Test for conflict
        if name in self.tasks:
            err = "Name conflict: this collection has a task named {!r} already"  # noqa
            raise ValueError(err.format(name))
        # Insert
        self.collections[name] = coll
        if default:
            self._check_default_collision(name)
            self.default = name

    def _check_default_collision(self, name: str) -> None:
        if self.default: