Repository: kedro-org/kedro
File: kedro/io/data_catalog.py (Python)

Code before:
                case-insensitive string that conforms with operating system
                filename limitations, b) always return the latest version when
                sorted in lexicographical order.
            default_pattern: A dictionary of the default catch-all pattern that overrides the default
                pattern provided through the runners.
            config_resolver: An instance of CatalogConfigResolver to resolve dataset patterns and configurations.


        Example:
        ::

            >>> from kedro_datasets.pandas import CSVDataset
            >>>
            >>> cars = CSVDataset(filepath="cars.csv",
            >>>                   load_args=None,
            >>>                   save_args={"index": False})
            >>> catalog = DataCatalog(datasets={'cars': cars})
        """
        if not is_warning_suppressed():
            warnings.warn(
                "`DataCatalog` will be replaced by `KedroDataCatalog` in Kedro 1.0.0, "
                "while keeping the `DataCatalog` name. Several APIs currently available, "
                "including `datasets`, `get_datasets`, `_get_datasets`, `add`, `list`, "
                "`add_feed_dict`, and `shallow_copy`, will be removed or replaced. "
                "For more details, refer to the documentation: "
                "https://docs.kedro.org/en/stable/data/index.html#kedrodatacatalog-experimental-feature",
                KedroDeprecationWarning,
                stacklevel=2,
            )
        self._config_resolver = config_resolver or CatalogConfigResolver()
        # Kept to avoid breaking changes
        if not config_resolver:
            self._config_resolver._dataset_patterns = dataset_patterns or {}
            self._config_resolver._default_pattern = default_pattern or {}

        self._load_versions, self._save_version = _validate_versions(
            datasets, load_versions or {}, save_version
        )

        self._datasets: dict[str, AbstractDataset] = {}
        self.datasets: _FrozenDatasets | None = None

        self.add_all(datasets or {})

        self._use_rich_markup = _has_rich_handler()

        if feed_dict:
            self.add_feed_dict(feed_dict)

    def __repr__(self) -> str:  # pragma: no cover
        return self.datasets.__repr__()

Review comment (suggestion):
Maybe instead of mentioning `KedroDataCatalog`, we can do something like

```suggestion
                "Several `DataCatalog` APIs currently available, "
                "including `datasets`, `get_datasets`, `_get_datasets`, `add`, `list`, "
                "`add_feed_dict`, and `shallow_copy`, will be removed or replaced in Kedro 1.0.0. "
                "For more details, refer to the documentation: "
                "https://docs.kedro.org/en/stable/data/index.html#kedrodatacatalog-experimental-feature",
```

Code after:
                case-insensitive string that conforms with operating system
                filename limitations, b) always return the latest version when
                sorted in lexicographical order.
            default_pattern: A dictionary of the default catch-all pattern that overrides the default
                pattern provided through the runners.
            config_resolver: An instance of CatalogConfigResolver to resolve dataset patterns and configurations.


        Example:
        ::

            >>> from kedro_datasets.pandas import CSVDataset
            >>>
            >>> cars = CSVDataset(filepath="cars.csv",
            >>>                   load_args=None,
            >>>                   save_args={"index": False})
            >>> catalog = DataCatalog(datasets={'cars': cars})
        """
        if not is_warning_suppressed():
            warnings.warn(
                "Several APIs currently available, "
                "including `datasets`, `get_datasets`, `_get_datasets`, `add`, `list`, "
                "`add_feed_dict`, and `shallow_copy`, will be removed or replaced in Kedro 1.0.0. "
                "For more details, refer to the documentation: "
                "https://docs.kedro.org/en/0.19.13/data/index.html#kedrodatacatalog-experimental-feature",
                KedroDeprecationWarning,
                stacklevel=2,
            )
        self._config_resolver = config_resolver or CatalogConfigResolver()
        # Kept to avoid breaking changes
        if not config_resolver:
            self._config_resolver._dataset_patterns = dataset_patterns or {}
            self._config_resolver._default_pattern = default_pattern or {}

        self._load_versions, self._save_version = _validate_versions(
            datasets, load_versions or {}, save_version
        )

        self._datasets: dict[str, AbstractDataset] = {}
        self.datasets: _FrozenDatasets | None = None

        self.add_all(datasets or {})

        self._use_rich_markup = _has_rich_handler()

        if feed_dict:
            self.add_feed_dict(feed_dict)

    def __repr__(self) -> str:  # pragma: no cover
        return self.datasets.__repr__()