Search Namespace Explorer

A helper that lists available Cognitive Services Search client modules by leveraging the provided search namespace dependency, keeping Python 2 environments aware of all installed service packages.

Capabilities

Discovers installed services

• When service packages live on different sys.path entries under the search namespace, discovery returns all of them as sorted dotted names (for example, azure.cognitiveservices.search.alpha and azure.cognitiveservices.search.beta). @test

Allows temporary paths

• When extra filesystem paths are provided for discovery, their namespace contributions are considered while the call runs and cleaned up afterward. @test

Flags legacy azure 0.x

• If a legacy monolithic azure 0.x distribution is installed, discovery aborts with a clear instruction to uninstall it. @test

Ignores non-service content

• Files or directories under the namespace that are not packages are ignored and do not appear in results. @test

Implementation

@generates

API

def list_search_services(additional_paths=None):
    """
    Return a sorted list of dotted module names for available search service clients beneath the shared namespace.
    additional_paths: optional iterable of filesystem paths temporarily added to sys.path for discovery.
    Raises RuntimeError if a legacy azure 0.x distribution is present.
    """

Dependencies { .dependencies }

azure-cognitiveservices-search-nspkg { .dependency }

Provides the search namespace package for Python 2 environments so discovery of service client packages works reliably.