feat: [CG-10650] codebase.codeowners interface

[clee-codegen]

Motivation

Easier access to code owners of a codebase and files owned by them.

Content

Introduces CodeOwner class and codeowners property on the Codebase class. Refactored methods around source file inspection into a separate base class for other file container interfaces in the futures.

Testing

Testing WIP.

Please check the following before marking your PR as ready for review

• I have added tests for my changes
• I have updated the documentation or added new documentation as needed

[christinewangcw]

can we add some unit tests?

[clee-codegen]

can we add some unit tests?

yep will add tests if this is what we're looking for, but it looks we want to be able to access symbols as well.

for codeowner in codebase.codeowners:
    for symbol in codeowner.symbols:  # behaves like SourceFile or Directory
        ...

[clee-codegen]

As a side note, I feel like:

TFile = TypeVar("TFile", bound="File")
TSymbol = TypeVar("TSymbol", bound="Symbol")
TImportStatement = TypeVar("TImportStatement", bound="ImportStatement")
TGlobalVar = TypeVar("TGlobalVar", bound="Assignment")
TClass = TypeVar("TClass", bound="Class")
TFunction = TypeVar("TFunction", bound="Function")
TImport = TypeVar("TImport", bound="Import")

we can have a types module to store and import these from

[codecov]

❌ 1 Tests Failed:

Tests completed	Failed	Passed	Skipped
27	1	26	0

View the top 1 failed test(s) by shortest run time

::tests.unit.codegen.sdk.core.test_directory

Stack Traces | 0s run time

ImportError while importing test module '.../sdk/core/test_directory.py'.
Hint: make sure your test modules/packages have valid Python names.
Traceback:
.../sdk/core/test_directory.py:8: in <module>
    from codegen.sdk.codebase.codebase_graph import CodebaseGraph
E   ModuleNotFoundError: No module named 'codegen.sdk.codebase.codebase_graph'

To view more test analytics, go to the Test Analytics Dashboard
_{📋 Got 3 mins? Take this short survey to help us improve Test Analytics.}

[clee-codegen]

@bagel897 @EdwardJXLi what do ya'll think about this refactor for this "directory-like" API referred to in the ticket ?

[clee-codegen]

unit tests are wip

[github-actions]

🎉 This PR is included in version 0.7.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀