Azure Cognitive Services Vision Namespace Package

A Python namespace package that provides the infrastructure for Azure Cognitive Services Vision modules. This package creates the azure.cognitiveservices.vision namespace hierarchy, allowing other Azure SDK packages to extend this namespace with their specific functionality.

Package Information

• Package Name: azure-cognitiveservices-vision-nspkg
• Package Type: Python namespace package
• Language: Python
• Installation: pip install azure-cognitiveservices-vision-nspkg
• License: MIT License
• Version: 3.0.1

Core Imports

Important: This package provides no direct imports and is not intended for direct usage. It serves purely as namespace infrastructure for other Azure Cognitive Services Vision packages.

The namespace is utilized indirectly when importing dependent packages:

# This package creates the namespace that enables these imports:
from azure.cognitiveservices.vision.computervision import ComputerVisionClient
from azure.cognitiveservices.vision.face import FaceClient
from azure.cognitiveservices.vision.customvision.training import CustomVisionTrainingClient

Basic Usage

This package has no direct usage pattern as it contains no public API. It is automatically utilized when other Azure Cognitive Services Vision packages are installed and imported.

Examples of dependent packages that utilize this namespace infrastructure:

# Computer Vision package
from azure.cognitiveservices.vision.computervision import ComputerVisionClient

# Face Recognition package  
from azure.cognitiveservices.vision.face import FaceClient

# Content Moderator package
from azure.cognitiveservices.vision.contentmoderator import ContentModeratorClient

# Custom Vision Training package
from azure.cognitiveservices.vision.customvision.training import CustomVisionTrainingClient

Each of these imports is made possible by the namespace infrastructure provided by this package.

Architecture

This package implements Python namespace packages using two different strategies:

• Python 2.7: Uses traditional namespace packages with pkgutil.extend_path()
• Python 3.x: Relies on PEP 420 implicit namespace packages (empty installation)

The namespace hierarchy created:

• azure (root namespace)
• azure.cognitiveservices (cognitive services namespace)
• azure.cognitiveservices.vision (vision-specific namespace)

Capabilities

Namespace Infrastructure

This package provides the namespace infrastructure that enables other Azure Vision SDK packages to extend the azure.cognitiveservices.vision namespace.

No public API: This package exports no functions, classes, constants, or types for end-user consumption.

Namespace modules: Contains only __init__.py files with namespace extension code:

# Content of each __init__.py file:
__path__ = __import__('pkgutil').extend_path(__path__, __name__)

Dependencies

Requires the broader Azure Cognitive Services namespace package:

• azure-cognitiveservices-nspkg>=3.0.0

Platform Compatibility

• Python Versions: 2.7, 3.4, 3.5, 3.6, 3.7+
• Platforms: Cross-platform (Windows, macOS, Linux)
• Installation Method: pip from PyPI

Usage Notes

• End users should not install this package directly
• No importable functionality - contains only namespace infrastructure
• Automatically installed as a dependency of other Azure Vision SDK packages
• Version compatibility handled automatically through dependency management
• Namespace strategy varies by Python version for optimal compatibility

Related Packages

This namespace package enables extension by packages such as:

• azure-cognitiveservices-vision-computervision - Computer Vision API client
• azure-cognitiveservices-vision-contentmoderator - Content Moderator API client
• azure-cognitiveservices-vision-customvision - Custom Vision API client
• azure-cognitiveservices-vision-face - Face API client

When these packages are installed, they extend the namespace created by this infrastructure package, allowing imports like from azure.cognitiveservices.vision.computervision import ...