GenAI Utils Structure

[keith-decker]

Description

This PR creates the Structure for the GenAI Utils package. The GenAI Utils package will include boilerplate and helpers to standardize instrumentation for Generative AI. Once implementation is complete, this package will provide APIs and decorators to minimize the work needed to instrument genai libraries, while providing standardization for generating both types of otel, "spans and metrics" and "spans, metrics and events"

Here's a link to the design document for the upcoming implementation: https://docs.google.com/document/d/1w9TbtKjuRX_wymS8DRSwPA03_VhrGlyx65hHAdNik1E/edit?tab=t.qneb4vabc1wc#heading=h.kh4j6stirken

Type of change

Please delete options that are not relevant.

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

N/A - No tests in this structure PR

• Test A

Does This PR Require a Core Repo Change?

• Yes. - Link to PR:
• No.

Checklist:

See contributing.md for styleguide, changelog guidelines, and more.

• Followed the style guidelines of this project
• Changelogs have been updated
• Unit tests have been added
• Documentation has been updated

[keith-decker]

@pmcollins - Mind taking a look?

[zhirafovod]

LGTM. @aabmass could you review it?

[pmcollins]

Added a comment -- other than that LGTM.

[aabmass]

The http util that lives in this same directory is a little different

• named opentelemetry-util-http
• python package is opentelemetry.util.http

WDYT of copying that pattern here? Asking because we can't easily change the package name on PyPI once published

[aabmass]

Can you also add this package to the Pyright config like we did in #3646?

I noticed we didn't add the tox boilerplate either, but we missed it for the other boilerplate PRs too. Please make sure it gets added in the future PRs, since that makes the tests run

[keith-decker]

The http util that lives in this same directory is a little different

• named opentelemetry-util-http
• python package is opentelemetry.util.http

WDYT of copying that pattern here? Asking because we can't easily change the package name on PyPI once published

I think that's fine, the name has been updated

[keith-decker]

Can you also add this package to the Pyright config like we did in #3646?

I noticed we didn't add the tox boilerplate either, but we missed it for the other boilerplate PRs too. Please make sure it gets added in the future PRs, since that makes the tests run

Tox Boilerplate has been added with a basic test for version check to make tox pass.

[keith-decker]

@aabmass The failing checks refer to a module "asyncclick". These checks showed up after merging main back into this branch.

Is this something I should investigate in this PR?

[aabmass]

Ty! One nit and I'll merge

[aabmass]

@aabmass The failing checks refer to a module "asyncclick". These checks showed up after merging main back into this branch.

Seems like an issue in main sorry

[aabmass]

Thanks for your patience. I reserved the package name on PyPI as well