Skip to content

Internal Packages

The Internal Packages are the collection of reusable modules that provide the foundational building blocks for building APIs using Atlas.

Each package encapsulates a specific concern, ranging from application layers, database abstraction and error handling to DTO validation, environment management, and utility functions.

You can learn more about each package by checking out this section's topics in the left panel.

Hierarchy

The hierarchical structure of internal packages follows the format below. Higher level packages depend on lower level packages. Level 0 are the fundamental, independent packages.

  • Level 0: atlas.core, atlas.exceptions

  • Level 1: atlas.constrained, atlas.utils

  • Level 2: atlas.common, atlas.dto

  • Level 3: atlas.http

  • Level 4: atlas.decorators

  • Level 5: atlas.layers

  • Level 6: atlas.debug

Importing

These packages are automatically included within the project’s Lambda Layers, meaning they can be imported directly into any API module using the following syntax:

from atlas.<package> import <component>

Some examples: 

from atlas.core import Entity, SessionManager
from atlas.common import ModelMapper, Messages
from atlas.layers import Service, Repository
from atlas.decorators import controller_method