Rooba
/
pyodide
mirror of https://github.com/pyodide/pyodide.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Make mkpkg command more prominent in the docs (#567) 

* Make mkpkg command more prominent in the docs

Under "adding new packages", information on the mkpkg command is
buried under "meta.yaml". To make it easier to find,
give this command its own section.

* Update docs/new_packages.md

Co-Authored-By: Michael Droettboom <mdboom@gmail.com>
This commit is contained in:
William Lachance 2019-11-19 14:51:12 -05:00 committed by Michael Droettboom
parent f14c3fe5c8
commit ef01e7039d
1 changed files with 14 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
docs/new_packages.md
View File

@ -1,9 +1,7 @@
# Creating a Pyodide package # Creating a Pyodide package
Pyodide includes a set of automatic tools to make it easier to add new Pyodide includes a toolchain to make it easier to add new third-party Python
third-party Python libraries to the build. libraries to the build. We automate the following steps:
These tools automate the following steps to build a package:
- Download a source tarball (usually from PyPI) - Download a source tarball (usually from PyPI)
- Confirm integrity of the package by comparing it to a checksum - Confirm integrity of the package by comparing it to a checksum
@ -26,6 +24,18 @@ Lastly, a `packages.json` file is output containing the dependency tree of all
packages, so `pyodide.loadPackage` can load a package's dependencies packages, so `pyodide.loadPackage` can load a package's dependencies
automatically. automatically.
## mkpkg
If you wish to create a new package for pyodide, the easiest place to start is
with the `mkpkg` tool. If your package is on PyPI, just run:
`bin/pyodide mkpkg $PACKAGE_NAME`
This will generate a `meta.yaml` (see below) that should work out of the box
for many pure Python packages. This tool will populate the latest version, download
link and sha256 hash by querying PyPI. It doesn't currently handle package
dependencies, so you will need to specify those yourself.
## The meta.yaml file ## The meta.yaml file
Packages are defined by writing a `meta.yaml` file. The format of these files is Packages are defined by writing a `meta.yaml` file. The format of these files is
@ -41,13 +51,6 @@ expect Conda packages to "just work" with Pyodide. (In the longer term, Pyodide
may use conda as its packaging system, and this should hopefully ease that may use conda as its packaging system, and this should hopefully ease that
transition.) transition.)
There is a helper tool that will generate a `meta.yaml` for packages on PyPI
that will work for many pure Python packages. This tool will populate the latest
version, download link and sha256 hash by querying PyPI. It doesn't currently
handle package dependencies. To run it, do:
`bin/pyodide mkpkg $PACKAGE_NAME`
The supported keys in the `meta.yaml` file are described below. The supported keys in the `meta.yaml` file are described below.
### `package` ### `package`