Skip to main content

Order utilities for 0x applications

Project description

API documentation hosted at https://0x.readthedocs.io/projects/order-utils/en/latest/

Development

Edit/test cycle

pip install -e .[dev]

./setup.py build

./setup.py build_sphinx

./setup.py test

./setup.py lint

./setup.py clean --all

See ./setup.py --help-commands for more info.

Publishing

./setup.py sdist bdist_wheel will build the distribution into the dist folder. Once you're happy with it, you can use ./setup.py to upload it to the package index, as described below.

If you're just experimenting, and want to try out a publish without committing to it, consider using a "staging package;" that is, rename the package, in setup(name=...) in setup.py, to something like "0x-order-utils-staging". The reason is that PyPI will never let you re-publish to an already-used file name (which includes the package name and version), even if you delete that published version from the repo. With an alternate package name, you can increase the version number (required for a successful upload) for every little experiment, without "stealing" version numbers from the main package name.

Uploading to test.pypi.org

Create an account at test.pypi.org (this is independent of any account at pypi.org).

With an sdist folder populated as described above, do ./setup.py test_publish.

To run tests against the package deployed to test.pypi.org, run tox -erun_tests_against_test_deployment. Modify tox.ini to change the package name if you need to run against a -staging package.

Uploading to (the real) pypi.org

Create an account at pypi.org (this is independent of any account at test.pypi.org).

With an sdist folder populated as described above, do ./setup.py publish.

To run tests against the package deployed to PyPI, run tox -erun_tests_against_deployment. Modify tox.ini to change the package name if you need to run against a -staging package.

Documentation

Documentation is hosted at readthedocs.io, and it will be automatically rebuilt upon change to the development branch. If needed, you can sign up for an account there and get yourself added to the list of Maintainers for the projects 0x, 0x-order-utils, etc. You can view doc build logs, and manually trigger new builds, through the Project interface on readthedocs.io.

To have readthedocs.io build documentation from a branch, you should use a throwaway/staging Project on (eg 0x-order-utils-staging, in order to avoid pushing unstable documentation onto the main project page. (If creating a new Project, be sure to copy all of the settings from the production Project's Admin, Advanced Settings menu. At the time of this writing, the only important one to copy is the Python configuration file.) In the Admin, Advanced Settings for the staging Project, set the Default Branch appropriately.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for 0x-order-utils, version 0.1.0
Filename, size File type Python version Upload date Hashes
Filename, size 0x_order_utils-0.1.0-py3-none-any.whl (7.7 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size 0x-order-utils-0.1.0.tar.gz (7.2 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page