Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudfoundry/python-buildpack
Cloud Foundry buildpack for the Python Language
https://github.com/cloudfoundry/python-buildpack
v2b
Last synced: 1 day ago
JSON representation
Cloud Foundry buildpack for the Python Language
- Host: GitHub
- URL: https://github.com/cloudfoundry/python-buildpack
- Owner: cloudfoundry
- License: apache-2.0
- Created: 2014-05-05T20:43:20.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-04-09T21:08:51.000Z (7 months ago)
- Last Synced: 2024-04-10T23:59:19.271Z (7 months ago)
- Topics: v2b
- Language: Go
- Homepage: http://docs.cloudfoundry.org/buildpacks/
- Size: 150 MB
- Stars: 118
- Watchers: 78
- Forks: 316
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-ibmcloud - python-buildpack - Cloud Foundry buildpack for the Python Language. (Platform)
README
# Cloud Foundry Python Buildpack
[ Join us on Slack](https://cloudfoundry.slack.com/messages/buildpacks/)
A Cloud Foundry [buildpack](http://docs.cloudfoundry.org/buildpacks/) for Python based apps.
This buildpack supports running Django and Flask apps.
### Buildpack User Documentation
Official buildpack documentation can be found at [python buildpack docs](http://docs.cloudfoundry.org/buildpacks/python/index.html).
### Building the Buildpack
To build this buildpack, run the following commands from the buildpack's directory:
1. Source the .envrc file in the buildpack directory.
```bash
source .envrc
```
To simplify the process in the future, install [direnv](https://direnv.net/) which will automatically source .envrc when you change directories.
1. Install buildpack-packager
```bash
go install github.com/cloudfoundry/libbuildpack/packager/buildpack-packager
```
1. Build the buildpack
```bash
buildpack-packager build [ --cached=(true|false) ]
```
1. Use in Cloud Foundry
Upload the buildpack to your Cloud Foundry and optionally specify it by name
```bash
cf create-buildpack [BUILDPACK_NAME] [BUILDPACK_ZIP_FILE_PATH] 1
cf push my_app [-b BUILDPACK_NAME]
```
### Testing
Buildpacks use the [Cutlass](https://github.com/cloudfoundry/libbuildpack/tree/master/cutlass) framework for running integration tests.
To test this buildpack, run the following commands from the buildpack's directory:
1. Source the .envrc file in the buildpack directory.
```bash
source .envrc
```
To simplify the process in the future, install [direnv](https://direnv.net/) which will automatically source .envrc when you change directories.
1. Run unit tests
```bash
./scripts/unit.sh
```
1. Run integration tests
Buildpacks use the [Cutlass](https://github.com/cloudfoundry/libbuildpack/tree/master/cutlass) framework for running integration tests against Cloud Foundry. Before running the integration tests, you need to login to your Cloud Foundry using the [cf cli](https://github.com/cloudfoundry/cli):
```bash
cf login -a https://api.your-cf.com -u [email protected] -p pa55woRD
```
Note that your user requires permissions to run `cf create-buildpack` and `cf update-buildpack`. To run the integration tests, run the following command from the buildpack's directory:
```bash
./scripts/integration.sh
```
1. Note: To run the network tests, you must have Docker installed.
### Contributing
Find our guidelines [here](./CONTRIBUTING.md).
### Help and Support
Join the #buildpacks channel in our [Slack community](http://slack.cloudfoundry.org/) if you need any further assistance.
### Reporting Issues
Open a GitHub issue on this project [here](https://github.com/cloudfoundry/python-buildpack/issues/new).
### Active Development
The project backlog is on [Pivotal Tracker](https://www.pivotaltracker.com/projects/1042066).