A Serverless v1.x plugin to automatically bundle dependencies from requirements.txt and make them available in your PYTHONPATH.

Requires Serverless >= v1.12

sls plugin install -n serverless-python-requirements

🍎🍺🐍 Mac Brew installed Python notes

Compiling non-pure-Python modules or fetching their manylinux wheels is supported on non-linux OSs via the use of Docker and the docker-lambda image. To enable docker usage, add the following to your serverless.yml:

custom:
  pythonRequirements:
    dockerizePip: true

The dockerizePip option supports a special case in addition to booleans of 'non-linux' which makes it dockerize only on non-linux environments.

To utilize your own Docker container instead of the default, add the following to your serverless.yml:

custom:
  pythonRequirements:
    dockerImage: <image name>:tag

This must be the full image name and tag to use, including the runtime specific tag if applicable.

🏁 Windows notes

If you include a Pipfile and have pipenv installed instead of a requirements.txt this will use pipenv lock --r to generate them. It is fully compatible with all options such as zip and dockerizePip. If you don't want this plugin to generate it for you, set the following option:

custom:
  pythonRequirements:
    usePipenv: false

To help deal with potentially large dependencies (for example: numpy, scipy and scikit-learn) there is support for compressing the libraries. This does require a minor change to your code to decompress them. To enable this add the following to your serverless.yml:

custom:
  pythonRequirements:
    zip: true

and add this to your handler module before any code that imports your deps:

try:
  import unzip_requirements
except ImportError:
  pass

You can omit a package from deployment with the noDeploy option. Note that dependencies of omitted packages must explicitly be omitted too. By default, this will not install the AWS SDKs that are already installed on Lambda. This example makes it instead omit pytest:

custom:
  pythonRequirements:
    noDeploy:
      - pytest

You can specify extra arguments to be passed to pip like this:

custom:
  pythonRequirements:
      dockerizePip: true
      pipCmdExtraArgs:
          - --cache-dir
          - .requirements-cache

Some pip workflows involve using requirements files not named requirements.txt. To support these, this plugin has the following option:

custom:
  pythonRequirements:
    fileName: requirements-prod.txt

Sometimes your Python executable isn't available on your $PATH as python2.7 or python3.6 (for example, windows or using pyenv). To support this, this plugin has the following option:

custom:
  pythonRequirements:
    pythonBin: /opt/python3.6/bin/python

The .requirements and requirements.zip(if using zip support) files are left behind to speed things up on subsequent deploys. To clean them up, run sls requirements clean. You can also create them (and unzip_requirements if using zip support) manually with sls requirements install.

If you are using your own Python library, you have to cleanup .requirements on any update. You can use the following option to cleanup .requirements everytime you package.

custom:
  pythonRequirements:
    invalidateCaches: true

Brew wilfully breaks the --target option with no seeming intention to fix it which causes issues since this uses that option. There are a few easy workarounds for this:

• Install Python from python.org and specify it with the pythonBin option.

OR

• Create a virtualenv and activate it while using serverless.

OR

• Install Docker and use the dockerizePip option.

For usage of dockerizePip on Windows do Step 1 only if running serverless on windows, or do both Step 1 & 2 if running serverless inside WSL.

1. Enabling shared volume in Windows Docker Taskbar settings
2. Installing the Docker client on Windows Subsystem for Linux (Ubuntu)

• @dschep - Lead developer & maintainer
• @azurelogic - logging & documentation fixes
• @abetomo - style & linting
• @angstwad - deploy --function support
• @mather - the cache invalidation option
• @rmax - the extra pip args option
• @bsamuel-ui - Python 3 support
• @suxor42 - fixing permission issues with Docker on Linux
• @mbeltran213 - fixing docker linux -u option bug
• @Tethik - adding usePipenv option
• @miketheman - fixing bug with includes when using zip option
• @wattdave - fixing bug when using deploymentBucket
• @heri16 - fixing Docker support in Windows.