docs/hylang
Tianon Gravi acb7edfd20 Update "Tags" section to be labelled "Supported tags" instead, to make it clear that this isn't the full list of tags, but is instead the list of tags that are currently supported for active usage 2014-09-15 17:29:16 -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 Better hy description 2014-09-05 14:29:32 -06:00
README.md Update "Tags" section to be labelled "Supported tags" instead, to make it clear that this isn't the full list of tags, but is instead the list of tags that are currently supported for active usage 2014-09-15 17:29:16 -06:00
logo.png Added hylang logo 2014-08-22 14:21:07 -06:00

README.md

Supported tags and respective Dockerfile links

What is Hy?

Hy (a.k.a., Hylang) is a dialect of the Lisp programming language designed to interoperate with Python by translating expressions into Python's abstract syntax tree (AST). Similar to Clojure's mapping of s-expressions onto the JVM, Hy is meant to operate as a transparent Lisp front end to Python's abstract syntax. Hy also allows for Python libraries (including the standard library) to be imported and accessed alongside Hy code with a compilation step, converting the data structure of both into Python's AST.

wikipedia.org/wiki/Hy

How to use this image

Create a Dockerfile in your Hy project

FROM hylang:0.10
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp
CMD [ "hy", "./your-daemon-or-script.hy" ]

You can then build and run the Docker image:

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

Run a single Hy script

For many simple, single file projects, you may find it inconvenient to write a complete Dockerfile. In such cases, you can run a Hy script by using the Hy Docker image directly:

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

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.