simple_aws_lambda 0.3.1__tar.gz

simple_aws_lambda-0.3.1/AUTHORS.rst

@@ -0,0 +1,15 @@
+.. _about_author:
+
+About the Author
+------------------------------------------------------------------------------
+::
+
+   (\ (\
+   ( -.-)o
+   o_(")(")
+
+**Sanhe Hu** is a seasoned software engineer with a deep passion for Python development since 2010. As an author and maintainer of `150+ open-source Python projects <https://pypi.org/user/machugwu/>`_, with over `15 million monthly downloads <https://github.com/MacHu-GWU>`_, I bring a wealth of experience to the table. As a Senior Solution Architect and Subject Matter Expert in AI, Data, Amazon Web Services, Cloud Engineering, DevOps, I thrive on helping clients with platform design, enterprise architecture, and strategic roadmaps.
+
+Talk is cheap, show me the code:
+
+- My Github: https://github.com/MacHu-GWU

simple_aws_lambda-0.3.1/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sanhe Hu <husanhe@email.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

simple_aws_lambda-0.3.1/PKG-INFO

@@ -0,0 +1,134 @@
+Metadata-Version: 2.4
+Name: simple_aws_lambda
+Version: 0.3.1
+Summary: Objective Oriented Python SDK for AWS Lambda.
+Author-email: Sanhe Hu <husanhe@gmail.com>
+Maintainer-email: Sanhe Hu <husanhe@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/MacHu-GWU/simple_aws_lambda-project
+Project-URL: Documentation, https://simple-aws-lambda.readthedocs.io/en/latest/
+Project-URL: Repository, https://github.com/MacHu-GWU/simple_aws_lambda-project
+Project-URL: Issues, https://github.com/MacHu-GWU/simple_aws_lambda-project/issues
+Project-URL: Changelog, https://github.com/MacHu-GWU/simple_aws_lambda-project/blob/main/release-history.rst
+Project-URL: Download, https://pypi.org/pypi/simple-aws-lambda#files
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Unix
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <4.0,>=3.11
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+License-File: AUTHORS.rst
+Requires-Dist: boto3<2.0.0,>=1.35.99
+Requires-Dist: iterproxy<1.0.0,>=0.3.1
+Requires-Dist: func_args<2.0.0,>=1.0.1
+Provides-Extra: dev
+Requires-Dist: rich<15.0.0,>=14.3.4; extra == "dev"
+Requires-Dist: boto3-stubs[lambda]<2.0.0,>=1.35.99; extra == "dev"
+Provides-Extra: test
+Requires-Dist: pytest<10.0.0,>=9.1.1; extra == "test"
+Requires-Dist: pytest-cov<8.0.0,>=7.1.0; extra == "test"
+Requires-Dist: moto<6.0.0,>=5.1.10; extra == "test"
+Provides-Extra: doc
+Requires-Dist: Sphinx<9.0.0,>=8.2.3; extra == "doc"
+Requires-Dist: sphinx-copybutton<1.0.0,>=0.5.2; extra == "doc"
+Requires-Dist: sphinx-design<1.0.0,>=0.7.0; extra == "doc"
+Requires-Dist: sphinx-jinja<3.0.0,>=2.0.2; extra == "doc"
+Requires-Dist: furo==2025.12.19; extra == "doc"
+Requires-Dist: pygments<3.0.0,>=2.18.0; extra == "doc"
+Requires-Dist: ipython<8.19.0,>=8.18.1; extra == "doc"
+Requires-Dist: ipykernel<8.0.0,>=7.3.0; extra == "doc"
+Requires-Dist: nbsphinx<1.0.0,>=0.9.8; extra == "doc"
+Requires-Dist: rstobj<3.0.0,>=2.0.0; extra == "doc"
+Requires-Dist: docfly<4.0.0,>=3.0.3; extra == "doc"
+Provides-Extra: mise
+Requires-Dist: PyGithub<3.0.0,>=2.8.0; extra == "mise"
+Requires-Dist: httpx2<3.0.0,>=2.13.1; extra == "mise"
+Dynamic: license-file
+
+
+.. image:: https://readthedocs.org/projects/simple-aws-lambda/badge/?version=latest
+    :target: https://simple-aws-lambda.readthedocs.io/en/latest/
+    :alt: Documentation Status
+
+.. image:: https://github.com/MacHu-GWU/simple_aws_lambda-project/actions/workflows/main.yml/badge.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project/actions?query=workflow:CI
+
+.. image:: https://codecov.io/gh/MacHu-GWU/simple_aws_lambda-project/branch/main/graph/badge.svg
+    :target: https://codecov.io/gh/MacHu-GWU/simple_aws_lambda-project
+
+.. image:: https://img.shields.io/pypi/v/simple-aws-lambda.svg
+    :target: https://pypi.python.org/pypi/simple-aws-lambda
+
+.. image:: https://img.shields.io/pypi/l/simple-aws-lambda.svg
+    :target: https://pypi.python.org/pypi/simple-aws-lambda
+
+.. image:: https://img.shields.io/pypi/pyversions/simple-aws-lambda.svg
+    :target: https://pypi.python.org/pypi/simple-aws-lambda
+
+.. image:: https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project/blob/main/release-history.rst
+
+.. image:: https://img.shields.io/badge/⭐_Star_me_on_GitHub!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project
+
+------
+
+.. image:: https://img.shields.io/badge/Link-API-blue.svg
+    :target: https://simple-aws-lambda.readthedocs.io/en/latest/py-modindex.html
+
+.. image:: https://img.shields.io/badge/Link-Install-blue.svg
+    :target: `install`_
+
+.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project
+
+.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Download-blue.svg
+    :target: https://pypi.org/pypi/simple-aws-lambda#files
+
+
+Welcome to ``simple_aws_lambda`` Documentation
+==============================================================================
+.. image:: https://simple-aws-lambda.readthedocs.io/en/latest/_static/simple_aws_lambda-logo.png
+    :target: https://simple-aws-lambda.readthedocs.io/en/latest/
+
+simple_aws_lambda is a Pythonic library that provides a simplified, high-level interface for AWS Lambda operations. Built on top of boto3, it offers intuitive data models, property-based access patterns, and comprehensive type hints to make working with AWS Lambda resources more developer-friendly and maintainable.
+
+**Key Features:**
+
+`Data Models <https://simple-aws-lambda.readthedocs.io/en/latest/02-Data-Model/index.html>`_ - Transform raw boto3 responses into Pythonic objects with property-based access, following the Raw Data Storage, Property-Based Access, and Core Data Extraction patterns to ensure API resilience and clean interfaces.
+
+`Better Client <https://simple-aws-lambda.readthedocs.io/en/latest/01-Quick-Start/index.html>`_ - Enhance the standard boto3 Lambda client with idempotent operations, automatic pagination, better error handling, and direct return of data model objects instead of raw dictionaries.
+
+`Recipes <https://simple-aws-lambda.readthedocs.io/en/latest/03-Cleanup-Old-Layer-Versions/index.html>`_ - Provide high-level functions for common Lambda layer management tasks such as version cleanup, cross-account access management, and intelligent layer discovery that combine multiple API calls with best practices.
+
+
+.. _install:
+
+Install
+------------------------------------------------------------------------------
+
+``simple_aws_lambda`` is released on PyPI, so all you need is to:
+
+.. code-block:: console
+
+    $ pip install simple-aws-lambda
+
+To upgrade to latest version:
+
+.. code-block:: console
+
+    $ pip install --upgrade simple-aws-lambda

simple_aws_lambda-0.3.1/README.rst

@@ -0,0 +1,79 @@
+
+.. image:: https://readthedocs.org/projects/simple-aws-lambda/badge/?version=latest
+    :target: https://simple-aws-lambda.readthedocs.io/en/latest/
+    :alt: Documentation Status
+
+.. image:: https://github.com/MacHu-GWU/simple_aws_lambda-project/actions/workflows/main.yml/badge.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project/actions?query=workflow:CI
+
+.. image:: https://codecov.io/gh/MacHu-GWU/simple_aws_lambda-project/branch/main/graph/badge.svg
+    :target: https://codecov.io/gh/MacHu-GWU/simple_aws_lambda-project
+
+.. image:: https://img.shields.io/pypi/v/simple-aws-lambda.svg
+    :target: https://pypi.python.org/pypi/simple-aws-lambda
+
+.. image:: https://img.shields.io/pypi/l/simple-aws-lambda.svg
+    :target: https://pypi.python.org/pypi/simple-aws-lambda
+
+.. image:: https://img.shields.io/pypi/pyversions/simple-aws-lambda.svg
+    :target: https://pypi.python.org/pypi/simple-aws-lambda
+
+.. image:: https://img.shields.io/badge/✍️_Release_History!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project/blob/main/release-history.rst
+
+.. image:: https://img.shields.io/badge/⭐_Star_me_on_GitHub!--None.svg?style=social&logo=github
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project
+
+------
+
+.. image:: https://img.shields.io/badge/Link-API-blue.svg
+    :target: https://simple-aws-lambda.readthedocs.io/en/latest/py-modindex.html
+
+.. image:: https://img.shields.io/badge/Link-Install-blue.svg
+    :target: `install`_
+
+.. image:: https://img.shields.io/badge/Link-GitHub-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project
+
+.. image:: https://img.shields.io/badge/Link-Submit_Issue-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Request_Feature-blue.svg
+    :target: https://github.com/MacHu-GWU/simple_aws_lambda-project/issues
+
+.. image:: https://img.shields.io/badge/Link-Download-blue.svg
+    :target: https://pypi.org/pypi/simple-aws-lambda#files
+
+
+Welcome to ``simple_aws_lambda`` Documentation
+==============================================================================
+.. image:: https://simple-aws-lambda.readthedocs.io/en/latest/_static/simple_aws_lambda-logo.png
+    :target: https://simple-aws-lambda.readthedocs.io/en/latest/
+
+simple_aws_lambda is a Pythonic library that provides a simplified, high-level interface for AWS Lambda operations. Built on top of boto3, it offers intuitive data models, property-based access patterns, and comprehensive type hints to make working with AWS Lambda resources more developer-friendly and maintainable.
+
+**Key Features:**
+
+`Data Models <https://simple-aws-lambda.readthedocs.io/en/latest/02-Data-Model/index.html>`_ - Transform raw boto3 responses into Pythonic objects with property-based access, following the Raw Data Storage, Property-Based Access, and Core Data Extraction patterns to ensure API resilience and clean interfaces.
+
+`Better Client <https://simple-aws-lambda.readthedocs.io/en/latest/01-Quick-Start/index.html>`_ - Enhance the standard boto3 Lambda client with idempotent operations, automatic pagination, better error handling, and direct return of data model objects instead of raw dictionaries.
+
+`Recipes <https://simple-aws-lambda.readthedocs.io/en/latest/03-Cleanup-Old-Layer-Versions/index.html>`_ - Provide high-level functions for common Lambda layer management tasks such as version cleanup, cross-account access management, and intelligent layer discovery that combine multiple API calls with best practices.
+
+
+.. _install:
+
+Install
+------------------------------------------------------------------------------
+
+``simple_aws_lambda`` is released on PyPI, so all you need is to:
+
+.. code-block:: console
+
+    $ pip install simple-aws-lambda
+
+To upgrade to latest version:
+
+.. code-block:: console
+
+    $ pip install --upgrade simple-aws-lambda

simple_aws_lambda-0.3.1/pyproject.toml

@@ -0,0 +1,129 @@
+# [project] table: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
+[project]
+name = "simple_aws_lambda"
+# Bump before each release (https://semver.org/), then ``mise run inst`` to update ``uv.lock``.
+version = "0.3.1"
+description = "Objective Oriented Python SDK for AWS Lambda."
+# An SPDX license expression (PEP 639); keep ``LICENSE.txt`` in sync.
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#license-and-license-files
+# Valid identifiers: https://spdx.org/licenses/
+license = "MIT"
+license-files = ["LICENSE.txt", "AUTHORS.rst"]
+authors = [
+    { name = "Sanhe Hu", email = "husanhe@gmail.com" },
+]
+maintainers = [
+    { name = "Sanhe Hu", email = "husanhe@gmail.com" },
+]
+keywords = []
+readme = "README.rst"
+requires-python = ">=3.11,<4.0"
+# Read: https://pypi.org/classifiers/
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Natural Language :: English",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: MacOS",
+    "Operating System :: Unix",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+]
+
+# --- Dependencies ---
+# Edit these lists, then ``mise run inst`` to update ``uv.lock`` and ``.venv``.
+dependencies = [
+    "boto3>=1.35.99,<2.0.0",
+    "iterproxy>=0.3.1,<1.0.0",
+    "func_args>=1.0.1,<2.0.0",
+]
+
+# --- Optional dependencies (extras) ---
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#dependencies-optional-dependencies
+# Each one must support every Python version in ``requires-python``.
+[project.optional-dependencies]
+
+# local development
+dev = [
+    "rich>=14.3.4,<15.0.0",
+    "boto3-stubs[lambda]>=1.35.99,<2.0.0", # IDE autocompletion for the lambda client
+]
+
+# tests and coverage
+test = [
+    "pytest>=9.1.1,<10.0.0",
+    "pytest-cov>=7.1.0,<8.0.0",
+    "moto>=5.1.10,<6.0.0", # mock AWS, so tests never call real AWS
+]
+
+# docs build
+doc = [
+    "Sphinx>=8.2.3,<9.0.0", # held below 9 until its autodoc rewrite is verified
+    "sphinx-copybutton>=0.5.2,<1.0.0", # copy button on code blocks
+    "sphinx-design>=0.7.0,<1.0.0", # cards, tabs, grids
+    "sphinx-jinja>=2.0.2,<3.0.0", # jinja in reST
+    "furo==2025.12.19", # theme
+    "pygments>=2.18.0,<3.0.0", # syntax highlighting
+    "ipython>=8.18.1,<8.19.0", # notebook execution
+    "ipykernel>=7.3.0,<8.0.0", # notebook kernel
+    "nbsphinx>=0.9.8,<1.0.0", # notebooks as doc pages
+    "rstobj>=2.0.0,<3.0.0", # reST from Python
+    "docfly>=3.0.3,<4.0.0", # toctree and API reference
+]
+
+# mise tasks
+mise = [
+    "PyGithub>=2.8.0,<3.0.0", # GitHub API client
+    "httpx2>=2.13.1,<3.0.0", # Codecov and Read the Docs APIs
+]
+
+[project.urls]
+Homepage = "https://github.com/MacHu-GWU/simple_aws_lambda-project"
+Documentation = "https://simple-aws-lambda.readthedocs.io/en/latest/"
+Repository = "https://github.com/MacHu-GWU/simple_aws_lambda-project"
+Issues = "https://github.com/MacHu-GWU/simple_aws_lambda-project/issues"
+Changelog = "https://github.com/MacHu-GWU/simple_aws_lambda-project/blob/main/release-history.rst"
+Download = "https://pypi.org/pypi/simple-aws-lambda#files"
+
+# Read: https://packaging.python.org/en/latest/guides/writing-pyproject-toml/#creating-executable-scripts
+[project.scripts]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = [
+    "simple_aws_lambda*",
+]
+exclude = [
+    "simple_aws_lambda.tests",
+    "simple_aws_lambda.tests.*",
+    "simple_aws_lambda.docs",
+    "simple_aws_lambda.docs.*",
+]
+
+# --- ruff: ``mise run format`` / ``mise run lint`` ---
+[tool.ruff]
+extend-exclude = [
+    "simple_aws_lambda/vendor",
+    ".claude/skills/*/assets", # templates, not valid Python
+]
+
+[tool.ruff.lint.per-file-ignores]
+# re-export modules
+"**/__init__.py" = ["F401"]
+"**/api.py" = ["F401"]
+
+# --- pytest 9+ native table ---
+# Read: https://docs.pytest.org/en/stable/reference/customize.html#pyproject-toml
+[tool.pytest]
+testpaths = ["tests"]
+# strict = true # only with a pinned pytest
+# filterwarnings = ["error"]
+# markers = ["slow: tests that take more than a few seconds"]
+
+# --- Build (``mise run build``); setuptools 77+ for PEP 639 ``license`` ---
+[build-system]
+requires = ["setuptools>=77.0"]
+build-backend = "setuptools.build_meta"

simple_aws_lambda-0.3.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

simple_aws_lambda-0.3.1/simple_aws_lambda/__init__.py

@@ -0,0 +1 @@
+# -*- coding: utf-8 -*-

simple_aws_lambda-0.3.1/simple_aws_lambda/api.py

@@ -0,0 +1,22 @@
+# -*- coding: utf-8 -*-
+
+"""
+Public API. Users import from here::
+
+    from simple_aws_lambda.api import list_layers
+    import simple_aws_lambda.api as simple_aws_lambda
+"""
+
+from .model import LatestMatchingLayerVersion
+from .model import Layer
+from .model import LayerIterproxy
+from .model import LayerContent
+from .model import LayerVersion
+from .model import LayerVersionIterproxy
+from .client import list_layers
+from .client import list_layer_versions
+from .client import get_layer_version
+from .recipe import get_latest_layer_version
+from .recipe import cleanup_old_layer_versions
+from .recipe import grant_aws_account_or_aws_organization_lambda_layer_version_access
+from .recipe import revoke_aws_account_or_aws_organization_lambda_layer_version_access

simple_aws_lambda-0.3.1/simple_aws_lambda/client.py

@@ -0,0 +1,140 @@
+# -*- coding: utf-8 -*-
+
+"""
+Improve the original lambda boto3 API.
+
+Ref:
+
+- https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda.html
+"""
+
+from __future__ import annotations
+
+import typing as T
+
+import botocore.exceptions
+from func_args.api import OPT
+from func_args.api import remove_optional
+
+from .model import Layer
+from .model import LayerVersion
+from .model import LayerIterproxy
+from .model import LayerVersionIterproxy
+
+if T.TYPE_CHECKING:  # pragma: no cover
+    from mypy_boto3_lambda.client import LambdaClient
+
+
+def list_layers(
+    lambda_client: LambdaClient,
+    compatible_runtime: str = OPT,
+    compatible_architecture: str = OPT,
+    max_items: int = 9999,
+    page_size: int = 50,
+) -> LayerIterproxy:
+    """
+    List available AWS Lambda layers in the account.
+
+    Ref:
+
+    - `list_layers <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/list_layers.html>`_
+    """
+
+    def func():
+        paginator = lambda_client.get_paginator("list_layers")
+        response_iterator = paginator.paginate(
+            **remove_optional(
+                CompatibleRuntime=compatible_runtime,
+                CompatibleArchitecture=compatible_architecture,
+                PaginationConfig={
+                    "MaxItems": max_items,
+                    "PageSize": page_size,
+                },
+            )
+        )
+        for response in response_iterator:
+            for _data in response.get("Layers", []):
+                yield Layer(_data=_data)
+
+    return LayerIterproxy(func())
+
+
+def list_layer_versions(
+    lambda_client: LambdaClient,
+    layer_name: str,
+    compatible_runtime: str = OPT,
+    compatible_architecture: str = OPT,
+    max_items: int = 9999,
+    page_size: int = 50,
+    _sort_descending: bool = False,
+) -> LayerVersionIterproxy:
+    """
+    List all versions of Lambda layers in the account.
+
+    :param _sort_descending: if True, load all layer versions in to memory and
+        then sort them in memory in descending order by version number. This is
+        the default behavior of official AWS API. However, the test tool moto does not
+        implement it correctly (it returns in ascending order). So this parameter
+        is a workaround for moto only. You don't need to set this parameter
+        when you run against real AWS API.
+
+    .. note::
+
+        this API always returns the latest version first.
+
+    Ref:
+
+    - `list_layer_versions <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/list_layer_versions.html>`_
+    """
+
+    def func():
+        paginator = lambda_client.get_paginator("list_layer_versions")
+        response_iterator = paginator.paginate(
+            **remove_optional(
+                LayerName=layer_name,
+                CompatibleRuntime=compatible_runtime,
+                CompatibleArchitecture=compatible_architecture,
+                PaginationConfig={
+                    "MaxItems": max_items,
+                    "PageSize": page_size,
+                },
+            )
+        )
+        for response in response_iterator:
+            for _data in response.get("LayerVersions", []):
+                yield LayerVersion(_data=_data)
+
+    if _sort_descending:
+        return LayerVersionIterproxy(
+            sorted(
+                func(),
+                key=lambda v: v.version,
+                reverse=True,
+            )
+        )
+    else:
+        return LayerVersionIterproxy(func())
+
+
+def get_layer_version(
+    lambda_client: LambdaClient,
+    layer_name: str,
+    version_number: int,
+) -> LayerVersion | None:
+    """
+    Retrieve details for a specific Lambda layer version.
+
+    Ref:
+
+    - `get_layer_version <https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/lambda/client/get_layer_version.html>`_
+    """
+    try:
+        response = lambda_client.get_layer_version(
+            LayerName=layer_name,
+            VersionNumber=version_number,
+        )
+        return LayerVersion(_data=response)
+    except botocore.exceptions.ClientError as e:
+        if e.response["Error"]["Code"] == "ResourceNotFoundException":
+            return None
+        raise  # pragma: no cover