Rename utils -> shared (#68)

# Motivation
<!-- Why is this change necessary? -->

# Content
<!-- Please include a summary of the change -->
# Testing
<!-- How was the change tested? -->
# Please check the following before marking your PR as ready for review

- [x] I have added tests for my changes
- [x] I have updated the documentation or added new documentation as
needed
- [x] I have read and agree to the [Contributor License
Agreement](../CLA.md)

src/codegen/git/models/pr_options.py

@@ -1,6 +1,6 @@
 from pydantic import BaseModel
 
-from codegen.utils.decorators.docs import apidoc
+from codegen.shared.decorators.docs import apidoc
 
 
 @apidoc

src/codegen/git/repo_operator/remote_repo_operator.py

@@ -16,7 +16,7 @@
 from codegen.git.utils.clone_url import get_clone_url_for_repo_config, url_to_github
 from codegen.git.utils.codeowner_utils import create_codeowners_parser_for_repo
 from codegen.git.utils.remote_progress import CustomRemoteProgress
-from codegen.utils.performance.stopwatch_utils import stopwatch
+from codegen.shared.performance.stopwatch_utils import stopwatch
 
 logger = logging.getLogger(__name__)
 

src/codegen/git/repo_operator/repo_operator.py

@@ -17,8 +17,8 @@
 from codegen.git.configs.constants import CODEGEN_BOT_EMAIL, CODEGEN_BOT_NAME
 from codegen.git.schemas.enums import CheckoutResult, FetchResult
 from codegen.git.schemas.repo_config import BaseRepoConfig
-from codegen.utils.performance.stopwatch_utils import stopwatch
-from codegen.utils.performance.time_utils import humanize_duration
+from codegen.shared.performance.stopwatch_utils import stopwatch
+from codegen.shared.performance.time_utils import humanize_duration
 
 logger = logging.getLogger(__name__)
 

src/codegen/git/utils/branch_sync.py

@@ -8,7 +8,7 @@
 from codegen.git.schemas.enums import FetchResult
 from codegen.git.schemas.github import GithubType
 from codegen.git.utils.clone_url import get_authenticated_clone_url_for_repo_config
-from codegen.utils.performance.stopwatch_utils import stopwatch
+from codegen.shared.performance.stopwatch_utils import stopwatch
 
 logger = logging.getLogger(__name__)
 

src/codegen/git/utils/clone.py

@@ -5,7 +5,7 @@
 from codegen.git.schemas.github import GithubType
 from codegen.git.schemas.repo_config import RepoConfig
 from codegen.git.utils.clone_url import get_authenticated_clone_url_for_repo_config
-from codegen.utils.performance.stopwatch_utils import subprocess_with_stopwatch
+from codegen.shared.performance.stopwatch_utils import subprocess_with_stopwatch
 
 logger = logging.getLogger(__name__)
 

src/codegen/gscli/generate/runner_imports.py

@@ -19,7 +19,7 @@
 """
 # TODO: these should also be made public (i.e. included in the docs site)
 GS_PRIVATE_IMPORTS = """
-from codegen.utils.exceptions.control_flow import StopCodemodException
+from codegen.shared.exceptions.control_flow import StopCodemodException
 """.strip()
 
 IMPORT_STRING_TEMPLATE = """

src/codegen/runner/diff/syntax_highlight.py

@@ -8,7 +8,7 @@
 
 from unidiff import PatchedFile, PatchSet
 
-from codegen.utils.performance.stopwatch_utils import stopwatch
+from codegen.shared.performance.stopwatch_utils import stopwatch
 
 logger = logging.getLogger(__name__)
 

src/codegen/runner/sandbox/executor.py

@@ -17,8 +17,8 @@
 from codegen.sdk.codebase.flagging.code_flag import CodeFlag
 from codegen.sdk.codebase.flagging.group import Group
 from codegen.sdk.codebase.flagging.groupers.utils import get_grouper_by_group_by
-from codegen.utils.exceptions.control_flow import StopCodemodException
-from codegen.utils.performance.stopwatch_utils import stopwatch
+from codegen.shared.exceptions.control_flow import StopCodemodException
+from codegen.shared.performance.stopwatch_utils import stopwatch
 from codegen.visualizations.viz_utils import get_graph_json
 
 logger = logging.getLogger(__name__)

src/codegen/runner/sandbox/middlewares.py

@@ -12,7 +12,7 @@
 
 from codegen.runner.models.apis import ServerInfo
 from codegen.runner.sandbox.runner import SandboxRunner
-from codegen.utils.exceptions.compilation import UserCodeException
+from codegen.shared.exceptions.compilation import UserCodeException
 
 logger = logging.getLogger(__name__)
 

src/codegen/runner/sandbox/runner.py

@@ -13,8 +13,8 @@
 from codegen.sdk.codebase.factory.codebase_factory import CodebaseType
 from codegen.sdk.core.codebase import Codebase
 from codegen.sdk.enums import ProgrammingLanguage
-from codegen.utils.compilation.string_to_code import create_execute_function_from_codeblock
-from codegen.utils.performance.stopwatch_utils import stopwatch
+from codegen.shared.compilation.string_to_code import create_execute_function_from_codeblock
+from codegen.shared.performance.stopwatch_utils import stopwatch
 
 logger = logging.getLogger(__name__)
 

src/codegen/runner/sandbox/server.py

@@ -24,7 +24,7 @@
 from codegen.runner.models.configs import get_repo_config
 from codegen.runner.sandbox.middlewares import CodemodRunMiddleware
 from codegen.runner.sandbox.runner import SandboxRunner
-from codegen.utils.performance.memory_utils import get_memory_stats
+from codegen.shared.performance.memory_utils import get_memory_stats
 
 logger = logging.getLogger(__name__)
 

src/codegen/runner/utils/exception_utils.py

@@ -1,4 +1,4 @@
-from codegen.utils.exceptions.control_flow import StopCodemodException
+from codegen.shared.exceptions.control_flow import StopCodemodException
 
 
 def update_observation_meta(

src/codegen/sdk/code_generation/current_code_codebase.py

@@ -9,7 +9,7 @@
 from codegen.sdk.codebase.config import CodebaseConfig, DefaultConfig, ProjectConfig
 from codegen.sdk.core.codebase import Codebase, CodebaseType
 from codegen.sdk.enums import ProgrammingLanguage
-from codegen.utils.decorators.docs import DocumentedObject, apidoc_objects, no_apidoc_objects, py_apidoc_objects, ts_apidoc_objects
+from codegen.shared.decorators.docs import DocumentedObject, apidoc_objects, no_apidoc_objects, py_apidoc_objects, ts_apidoc_objects
 
 logger = logging.getLogger(__name__)
 

src/codegen/sdk/codebase/codebase_graph.py

@@ -33,8 +33,8 @@
 from codegen.sdk.extensions.sort import sort_editables
 from codegen.sdk.extensions.utils import uncache_all
 from codegen.sdk.typescript.external.ts_declassify.ts_declassify import TSDeclassify
-from codegen.utils.exceptions.control_flow import StopCodemodException
-from codegen.utils.performance.stopwatch_utils import stopwatch, stopwatch_with_sentry
+from codegen.shared.exceptions.control_flow import StopCodemodException
+from codegen.shared.performance.stopwatch_utils import stopwatch, stopwatch_with_sentry
 
 if TYPE_CHECKING:
     from codegen.sdk.codebase.node_classes.node_classes import NodeClasses

src/codegen/sdk/codebase/flagging/enums.py

@@ -3,7 +3,7 @@
 
 from typing_extensions import ReadOnly
 
-from codegen.utils.decorators.docs import apidoc
+from codegen.shared.decorators.docs import apidoc
 
 
 @apidoc

src/codegen/sdk/codebase/flagging/flags.py

@@ -4,7 +4,7 @@
 from codegen.sdk.codebase.flagging.enums import MessageType
 from codegen.sdk.codebase.flagging.group import Group
 from codegen.sdk.core.interfaces.editable import Editable
-from codegen.utils.decorators.docs import noapidoc
+from codegen.shared.decorators.docs import noapidoc
 
 
 @dataclass

src/codegen/sdk/codebase/flagging/groupers/file_chunk_grouper.py

@@ -5,7 +5,7 @@
 from codegen.sdk.codebase.flagging.group import Group
 from codegen.sdk.codebase.flagging.groupers.base_grouper import BaseGrouper
 from codegen.sdk.codebase.flagging.groupers.enums import GroupBy
-from codegen.utils.string.csv_utils import comma_separated_to_list, list_to_comma_separated
+from codegen.shared.string.csv_utils import comma_separated_to_list, list_to_comma_separated
 
 logger = logging.getLogger(__name__)
 

src/codegen/sdk/codebase/span.py

@@ -4,7 +4,7 @@
 from pydantic_core.core_schema import ValidationInfo
 from tree_sitter import Point, Range
 
-from codegen.utils.decorators.docs import apidoc
+from codegen.shared.decorators.docs import apidoc
 
 
 def validate_range(value: Any, info: ValidationInfo) -> Range:

src/codegen/sdk/codebase/transaction_manager.py

@@ -13,7 +13,7 @@
     Transaction,
     TransactionPriority,
 )
-from codegen.utils.exceptions.control_flow import MaxPreviewTimeExceeded, MaxTransactionsExceeded
+from codegen.shared.exceptions.control_flow import MaxPreviewTimeExceeded, MaxTransactionsExceeded
 
 if TYPE_CHECKING:
     from codegen.sdk.core.file import File

src/codegen/sdk/core/assignment.py

@@ -30,7 +30,7 @@
 from codegen.sdk.extensions.sort import sort_editables
 from codegen.sdk.typescript.expressions.object_type import TSObjectType
 from codegen.sdk.utils import find_index
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.expressions.type import Type

src/codegen/sdk/core/class_definition.py

@@ -30,7 +30,7 @@
 from codegen.sdk.core.symbol_groups.parents import Parents
 from codegen.sdk.enums import SymbolType
 from codegen.sdk.extensions.utils import cached_property
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 from codegen.visualizations.enums import VizNode
 
 if TYPE_CHECKING:

src/codegen/sdk/core/codebase.py

@@ -70,9 +70,9 @@
 from codegen.sdk.typescript.symbol import TSSymbol
 from codegen.sdk.typescript.type_alias import TSTypeAlias
 from codegen.sdk.utils import determine_project_language
-from codegen.utils.decorators.docs import apidoc, noapidoc
-from codegen.utils.exceptions.control_flow import MaxAIRequestsError
-from codegen.utils.performance.stopwatch_utils import stopwatch
+from codegen.shared.decorators.docs import apidoc, noapidoc
+from codegen.shared.exceptions.control_flow import MaxAIRequestsError
+from codegen.shared.performance.stopwatch_utils import stopwatch
 from codegen.visualizations.visualization_manager import VisualizationManager
 
 logger = logging.getLogger(__name__)

src/codegen/sdk/core/dataclasses/usage.py

@@ -6,7 +6,7 @@
 
 from dataclasses_json import dataclass_json
 
-from codegen.utils.decorators.docs import apidoc
+from codegen.shared.decorators.docs import apidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.detached_symbols.function_call import FunctionCall

src/codegen/sdk/core/detached_symbols/argument.py

@@ -15,7 +15,7 @@
 from codegen.sdk.core.interfaces.importable import Importable
 from codegen.sdk.core.node_id_factory import NodeId
 from codegen.sdk.extensions.autocommit import commiter
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.codebase.codebase_graph import CodebaseGraph

src/codegen/sdk/core/detached_symbols/code_block.py

@@ -25,7 +25,7 @@
 from codegen.sdk.extensions.sort import sort_editables
 from codegen.sdk.extensions.utils import find_line_start_and_end_nodes
 from codegen.sdk.output.ast import AST
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.interfaces.has_block import HasBlock

src/codegen/sdk/core/detached_symbols/decorator.py

@@ -11,7 +11,7 @@
 from codegen.sdk.core.expressions import Expression
 from codegen.sdk.core.expressions.name import Name
 from codegen.sdk.core.interfaces.has_name import HasName
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.class_definition import Class

src/codegen/sdk/core/detached_symbols/function_call.py

@@ -25,7 +25,7 @@
 from codegen.sdk.extensions.utils import cached_property, is_descendant_of
 from codegen.sdk.typescript.enums import TSFunctionTypeNames
 from codegen.sdk.utils import find_first_ancestor
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.codebase.codebase_graph import CodebaseGraph

src/codegen/sdk/core/detached_symbols/parameter.py

@@ -21,7 +21,7 @@
 from codegen.sdk.extensions.autocommit import commiter
 from codegen.sdk.extensions.resolution import UsageKind
 from codegen.sdk.utils import find_first_descendant
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.expressions.type import Type

src/codegen/sdk/core/directory.py

@@ -3,7 +3,7 @@
 from pathlib import Path
 from typing import TYPE_CHECKING, Generic, Self, TypeVar
 
-from codegen.utils.decorators.docs import apidoc
+from codegen.shared.decorators.docs import apidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.assignment import Assignment

src/codegen/sdk/core/export.py

@@ -10,7 +10,7 @@
 from codegen.sdk.core.node_id_factory import NodeId
 from codegen.sdk.core.symbol_groups.collection import Collection
 from codegen.sdk.extensions.autocommit import commiter
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.statements.export_statement import ExportStatement

src/codegen/sdk/core/expressions/await_expression.py

@@ -6,7 +6,7 @@
 from codegen.sdk.core.interfaces.has_value import HasValue
 from codegen.sdk.core.interfaces.wrapper_expression import IWrapper
 from codegen.sdk.extensions.autocommit import reader
-from codegen.utils.decorators.docs import apidoc
+from codegen.shared.decorators.docs import apidoc
 
 Parent = TypeVar("Parent", bound="Editable")
 

src/codegen/sdk/core/expressions/binary_expression.py

@@ -16,7 +16,7 @@
 from codegen.sdk.core.symbol_groups.expression_group import ExpressionGroup
 from codegen.sdk.extensions.autocommit import commiter, reader
 from codegen.sdk.extensions.sort import sort_editables
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 Parent = TypeVar("Parent", bound="Editable")
 

src/codegen/sdk/core/expressions/boolean.py

@@ -5,7 +5,7 @@
 from codegen.sdk.core.expressions.builtin import Builtin
 from codegen.sdk.core.interfaces.has_name import HasName
 from codegen.sdk.extensions.autocommit import commiter
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 Parent = TypeVar("Parent", bound="Expression")
 

src/codegen/sdk/core/expressions/builtin.py

@@ -5,7 +5,7 @@
 from codegen.sdk.core.interfaces.chainable import Chainable
 from codegen.sdk.core.interfaces.has_attribute import HasAttribute
 from codegen.sdk.extensions.autocommit import reader
-from codegen.utils.decorators.docs import noapidoc
+from codegen.shared.decorators.docs import noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.external_module import ExternalModule

src/codegen/sdk/core/expressions/chained_attribute.py

@@ -12,7 +12,7 @@
 from codegen.sdk.core.interfaces.has_attribute import HasAttribute
 from codegen.sdk.core.interfaces.resolvable import Resolvable
 from codegen.sdk.extensions.autocommit import commiter
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.interfaces.has_name import HasName

src/codegen/sdk/core/expressions/comparison_expression.py

@@ -4,7 +4,7 @@
 from codegen.sdk.core.expressions import Expression
 from codegen.sdk.core.expressions.binary_expression import BinaryExpression
 from codegen.sdk.core.symbol_groups.expression_group import ExpressionGroup
-from codegen.utils.decorators.docs import apidoc
+from codegen.shared.decorators.docs import apidoc
 
 Parent = TypeVar("Parent")
 

src/codegen/sdk/core/expressions/defined_name.py

@@ -4,7 +4,7 @@
 from codegen.sdk.codebase.resolution_stack import ResolutionStack
 from codegen.sdk.core.expressions import Name
 from codegen.sdk.extensions.autocommit import reader
-from codegen.utils.decorators.docs import noapidoc
+from codegen.shared.decorators.docs import noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.symbol import Symbol

src/codegen/sdk/core/expressions/expression.py

@@ -6,7 +6,7 @@
 from codegen.sdk.core.interfaces.editable import Editable
 from codegen.sdk.enums import NodeType
 from codegen.sdk.extensions.autocommit import reader
-from codegen.utils.decorators.docs import apidoc
+from codegen.shared.decorators.docs import apidoc
 
 Parent = TypeVar("Parent", bound="Editable")
 

src/codegen/sdk/core/expressions/generic_type.py

@@ -13,7 +13,7 @@
 from codegen.sdk.core.node_id_factory import NodeId
 from codegen.sdk.core.symbol_groups.collection import Collection
 from codegen.sdk.extensions.resolution import ResolutionStack
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.codebase.codebase_graph import CodebaseGraph

src/codegen/sdk/core/expressions/multi_expression.py

@@ -9,7 +9,7 @@
 from codegen.sdk.core.interfaces.has_name import HasName
 from codegen.sdk.core.node_id_factory import NodeId
 from codegen.sdk.extensions.autocommit import commiter
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.codebase.codebase_graph import CodebaseGraph

src/codegen/sdk/core/expressions/name.py

@@ -7,7 +7,7 @@
 from codegen.sdk.core.expressions.expression import Expression
 from codegen.sdk.core.interfaces.resolvable import Resolvable
 from codegen.sdk.extensions.autocommit import commiter
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.core.interfaces.has_name import HasName

src/codegen/sdk/core/expressions/named_type.py

@@ -14,7 +14,7 @@
 from codegen.sdk.core.interfaces.importable import Importable
 from codegen.sdk.core.interfaces.resolvable import Resolvable
 from codegen.sdk.core.node_id_factory import NodeId
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     from codegen.sdk.codebase.codebase_graph import CodebaseGraph

src/codegen/sdk/core/expressions/none_type.py

@@ -7,7 +7,7 @@
 from codegen.sdk.core.interfaces.editable import Editable
 from codegen.sdk.core.interfaces.importable import Importable
 from codegen.sdk.extensions.autocommit import reader
-from codegen.utils.decorators.docs import apidoc, noapidoc
+from codegen.shared.decorators.docs import apidoc, noapidoc
 
 if TYPE_CHECKING:
     pass