Registry / aws / cdk-serverless-clamscan

cdk-serverless-clamscan

library2.13.47pypypi✓ verified 84d ago

An AWS CDK construct library that provides a serverless architecture to scan objects in Amazon S3 for viruses using ClamAV. Current version 2.13.47, requires Python ~=3.9. Development is active with frequent releases (multiple per week).

aws devops

pip install cdk-serverless-clamscan

github ↗package ↗

INSTALL

IMPORT

SIG · CDK-SERVERLESS-CLA

cdk-serverless-clamscan

awspythonv2.13.47

Install

17.9s avg

Import

—

Disk

399MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.13.47 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 361.7MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 17.9s · import 0.000s · 362MB

399MB installed

● package 399MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ServerlessClamscan

✓ from cdk_serverless_clamscan import ServerlessClamscan

✗ from cdk_serverless_clamscan import ClamScan

ServerlessClamscanLoggingProps

✓ from cdk_serverless_clamscan import ServerlessClamscanLoggingProps

ServerlessClamscanProps

✓ from cdk_serverless_clamscan import ServerlessClamscanProps

Deploys the serverless ClamAV scanning infrastructure in a CDK stack.

from constructs import Construct from aws_cdk import Stack from cdk_serverless_clamscan import ClamScan, ClamScanProps class ScanStack(Stack): def __init__(self, scope: Construct, id: str, **kwargs): super().__init__(scope, id, **kwargs) ClamScan( self, 'ClamScan', props=ClamScanProps( definition_pipeline_schedule='rate(1 hour)' ) )

Debug

Known issues

breakingConstructor signature changed in v2.0.0: 'ClamScanProps' is now passed as 'props' keyword argument, not as positional dict.

fix

Use ClamScan(self, 'Id', props=ClamScanProps(...)).

affects: >=2.0.0

breakingIn v2, the 'scan_role_arn' property is no longer automatically created; you must supply a role with appropriate IAM permissions if you need custom scanning roles.

fix

Pass an existing role via 'scan_role_arn' in ClamScanProps.

affects: >=2.0.0

gotchaThe construct automatically attaches to S3 buckets via S3 Event Notifications. If you already have event notifications on the bucket, you must explicitly set 'add_event_notifications: False' in ClamScanProps to avoid duplication.

fix

Set ClamScanProps(add_event_notifications=False) and manually add the S3 notification.

affects: all

gotchaThe ClamAV virus definitions update pipeline requires 'definition_pipeline_schedule' - if omitted, it defaults to no schedule and definitions might become stale.

fix

Always specify definition_pipeline_schedule as a rate or cron expression, e.g., 'rate(1 hour)'.

affects: all

Upgrade

Version history

2.13.47latest on PyPI · released Jan 16, 2026

Audit

Dependencies

aws-cdk-librequiredThe construct extends CDK constructs and requires CDK to deploy.

Agent activity

17 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/awslabs/cdk-serverless-clamscan ↗

packagehttps://pypi.org/project/cdk-serverless-clamscan/ ↗