Docs: Packaging Assets with Pants

[TonySherman]

What were you searching in the docs?

The Micro Function Pattern with Event Handler.

Is this related to an existing documentation section?

https://docs.powertools.aws.dev/lambda/python/latest/core/event_handler/api_gateway/#micro-function

How can we improve?

There is a link that references using lambda layers or Pants Build to package lambda code. Pants has made significant improvements in packaging lambdas and packaging lambda layers and using rust to infer both internal and external dependencies.

It would be nice to see some examples of how to package lambda functions with Pants.

Got a suggestion in mind?

Pants does have some initial setup that is well documented, but it does take some time to set up instrumentation. Code snippets can be helpful, but a fully instrumented demo repo might be the best way to show how Pants can really help with packaging lambda code.

Acknowledgment

• I understand the final update might be different from my proposed suggestion, or refused.

[boring-cyborg]

Thanks for opening your first issue here! We'll come back to you as soon as we can.
In the meantime, check out the #python channel on our Powertools for AWS Lambda Discord: Invite link

[rubenfonseca]

@TonySherman thank you so much for opening this issue. Pants is something that have been on my radar for quite some time but I never had the proper time to give it a try. I agree that more people could benefit from such as example. Is this something you can contribute with? I would love to review it and give it a try.

[TonySherman]

I am happy to help contribute! I also asked in the Pants slack if they would be interested in a serverless demo repo. They have several demo repos already and I wonder if a demo repo would help since it could be a full example with Pants tooling setup. I feel like the initial configuration for Pants takes a little time but it's certainly worth it once set up.

[anafalcao]

Hey @TonySherman ! This is great. I know it's been a while, but would you still be interested in sending a PR?

[leandrodamascena]

I had a conversation with @TonySherman and he can help with some questions related to Pants.

My idea is to create a new documentation section that will show customers how to package Lambda functions using various tools such as:

• poetry
• uv
• pants
• pip
• other relevant tools

This new section will demonstrate different packaging approaches for Lambda functions + Powertools, giving developers more options and guidance.

[TonySherman]

Once @leandrodamascena has a section on packaging, I can contribute to the Pants portion!