Implement Admin API

[jhamon]

Problem

Currently the Admin API is not supported in the python SDK.

Solution

Implement an Admin class with support for CRUD on projects and API keys.

Usage

Projects

from pinecone import Admin

# Use service account credentials
admin = Admin(client_id='foo', client_secret='bar')

# Example: Create a project
project = admin.project.create(
    name="example-project",
    max_pods=5
)
print(f"Project {project.id} was created")

# Example: Rename a project
project = admin.project.get(name='example-project')
admin.project.update(
    project_id=project.id, 
    name='my-awesome-project'
)

# Example: Enable CMEK on all projects
project_list = admin.projects.list()
for proj in project_list_response.data:
    admin.projects.update(
      project_id=proj.id, 
      force_encryption_with_cmek=True
  )

# Example: Set pod quota to 0 for all projects
project_list = admin.projects.list()
for proj in project_list_response.data:
    admin.projects.update(project_id=proj.id, max_pods=0)

# Delete the project
admin.project.delete(project_id=project.id)

API Keys

from pinecone import Admin

# Use service account credentials
admin = Admin(client_id='foo', client_secret='bar')

project = admin.project.get(name='my-project')

# Create an API key
api_key_response = admin.api_keys.create(
    project_id=project.id,
    name="ci-key",
   roles=["ProjectEditor"]
)
key = api_key_response.value # 'pcsk_....'

# Look up info on a key by id
key_info = admin.api_keys.get(
    api_key_id=api_key_response.key.id
)

# Delete a key
admin.api_keys.delete(
    api_key_id=api_key_response.key.id
)

Type of Change

• New feature (non-breaking change which adds functionality)
• Infrastructure change (CI configs, etc)
• Non-code change (docs, etc)

Test Plan

Tests added. Also incorporated into CI.

[jhamon]

A bit unrelated to this admin change, I figured out how to get the sphinx dev dependencies working even with our project supporting back to 3.9 by specifying different deps for different python versions. This was helpful for iterating on docs and making sure things look good in the rendered output.