Note:
VERSION needs to be formatted following the MAJOR.MINOR.PATCH convention (we need to follow this convention to be able to retrieve versioned scripts)
Simple check list for release from AllenNLP repo: https://github.com/allenai/allennlp/blob/master/setup.py
To create the package for pypi.
-
Prerequisites:
- Dependencies:
- twine: "pip install twine"
- Create an account in (and join the 'datasets' project):
- PyPI: https://pypi.org/
- Test PyPI: https://test.pypi.org/
- Dependencies:
-
Change the version in:
- init.py
- setup.py
- docs/source/conf.py
-
Commit these changes: "git commit -m 'Release: VERSION'"
-
Add a tag in git to mark the release: "git tag VERSION -m 'Add tag VERSION for pypi'" Push the tag to remote: git push --tags origin master
-
Build both the sources and the wheel. Do not change anything in setup.py between creating the wheel and the source distribution (obviously).
First, delete any "build" directory that may exist from previous builds.
For the wheel, run: "python setup.py bdist_wheel" in the top level directory. (this will build a wheel for the python version you use to build it).
For the sources, run: "python setup.py sdist" You should now have a /dist directory with both .whl and .tar.gz source versions.
-
Check that everything looks correct by uploading the package to the pypi test server:
twine upload dist/* -r pypitest --repository-url=https://test.pypi.org/legacy/
Check that you can install it in a virtualenv/notebook by running: pip install huggingface_hub fsspec aiohttp pip install -U tqdm pip install -i https://testpypi.python.org/pypi datasets
-
Upload the final version to actual pypi: twine upload dist/* -r pypi
-
Fill release notes in the tag in github once everything is looking hunky-dory.
-
Update the documentation commit in .circleci/deploy.sh for the accurate documentation to be displayed. Update the version mapping in docs/source/_static/js/custom.js with: "python utils/release.py --version VERSION" Set version to X.X.X+1.dev0 (e.g. 1.8.0 -> 1.8.1.dev0) in:
- setup.py
- init.py
-
Commit these changes: "git commit -m 'Release docs'" Push the commit to remote: "git push origin master"
4 maintainers
Release files for datasets 1.13.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| datasets-1.13.2.tar.gz | 251.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| datasets-1.13.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 538.9 kB
Release files / datasets-1.13.2.tar.gz
| Download URL | datasets-1.13.2.tar.gz |
|---|---|
| Size | 251.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
44aae32e7819e2e120b2334fff4d11b885b03efa6f96ed30bbabd727de66c9a4
|
|
BLAKE2b-256 checksum How to use checksums |
a8a5913d5d8c23b1eb61cd0baf9e899c9964a78d81c5b301104e8ad47ce4ea27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.8.8
|
Release files / datasets-1.13.2-py3-none-any.whl
| Download URL | datasets-1.13.2-py3-none-any.whl |
|---|---|
| Size | 287.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f6ed8f789079d2e76727324a591815463e7d3b197e03451c75246b2bb5fef984
|
|
BLAKE2b-256 checksum How to use checksums |
2fe814b907a759548f8d848ea26c2f8f2c13fb58fe08940b58641ffa83129c95
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.4.2 importlib_metadata/4.6.1 pkginfo/1.7.1 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.62.2 CPython/3.8.8
|
