docs/python
Tianon Gravi e2416c1ee3 Reflow all the language stack `README-content.md` files to 80 columns and incorporate Fred's changes
This also includes Fred's updates to the `README-short.txt` files, and a bunch of very minor changes for consistency (using "PHP" instead of "php", ending sentences that describe and lead into a code block with a ":", using "Go" instead of "Golang" and "Hy" instead of "Hylang" within prose, not using periods at the end of headlines, etc).

A really fun one included here is that Java mentioned both using GNU Make inside the container (and `java` doesn't include `make` presently), and some of the prose mentioned `go build` after we ran `javac`, which was extra neat.
2014-09-13 17:33:55 -06:00
..
.keep adding some directories for andrew to dump the short and long desc in 2014-07-31 15:09:43 -06:00
README-content.md Reflow all the language stack `README-content.md` files to 80 columns and incorporate Fred's changes 2014-09-13 17:33:55 -06:00
README-short.txt Reflow all the language stack `README-content.md` files to 80 columns and incorporate Fred's changes 2014-09-13 17:33:55 -06:00
README.md Apply the footer update from fred 2014-09-11 14:56:23 -06:00
logo.png logos for all the things 2014-08-06 16:37:56 -06:00

README.md

Tags and Dockerfile links

What is Python?

Python is a widely used general-purpose, high-level programming language. Its design philosophy emphasizes code readability, and its syntax allows programmers to express concepts in fewer lines of code than would be possible in languages such as C. The language provides constructs intended to enable clear programs on both a small and large scale.

wikipedia.org/wiki/Python_(programming_language)

How to use this image

Create a Dockerfile in your python app project.

FROM python:3
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
CMD [ "python", "./your-daemon-or-script.py" ]

or (if you need to use Python 2):

FROM python:2
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
CMD [ "python", "./your-daemon-or-script.py" ]

Then build and run the docker image.

docker build -t my-python-app
docker run -it --rm --name my-running-app my-python-app

Run a single python script.

For many single file projects, it may not be convenient to write a Dockerfile for your project. In such cases, you can run a python script by using the python docker image directly.

docker run -it --rm --name my-running-script -v "$(pwd)":/usr/src/myapp -w /usr/src/myapp python:3 python your-daemon-or-script.py

or (again, if you need to use Python 2):

docker run -it --rm --name my-running-script -v "$(pwd)":/usr/src/myapp -w /usr/src/myapp python:2 python your-daemon-or-script.py

User Feedback

Issues

If you have any problems with, or questions about this image, please contact us through a GitHub issue or via the IRC channel #docker-library on Freenode.

Contributing

You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.