setup.py 7.11 KB
Newer Older
1
2
3
4
5
"""
Simple check list from AllenNLP repo: https://github.com/allenai/allennlp/blob/master/setup.py

To create the package for pypi.

6
7
8
1. Change the version in __init__.py, setup.py as well as docs/source/conf.py. Remove the master from the links in
   the new models of the README:
   (https://huggingface.co/transformers/master/model_doc/ -> https://huggingface.co/transformers/model_doc/)
sgugger's avatar
sgugger committed
9
   then run `make fix-copies` to fix the index of the documentation.
10

Sylvain Gugger's avatar
Sylvain Gugger committed
11
2. Unpin specific versions from setup.py that use a git install.
Lysandre's avatar
Lysandre committed
12

13
14
15
16
17
18
19
20
2. Commit these changes with the message: "Release: VERSION"

3. Add a tag in git to mark the release: "git tag VERSION -m'Adds tag VERSION for pypi' "
   Push the tag to git: git push --tags origin master

4. Build both the sources and the wheel. Do not change anything in setup.py between
   creating the wheel and the source distribution (obviously).

thomwolf's avatar
thomwolf committed
21
   For the wheel, run: "python setup.py bdist_wheel" in the top level directory.
22
   (this will build a wheel for the python version you use to build it).
23
24

   For the sources, run: "python setup.py sdist"
thomwolf's avatar
thomwolf committed
25
   You should now have a /dist directory with both .whl and .tar.gz source versions.
26
27
28
29
30

5. Check that everything looks correct by uploading the package to the pypi test server:

   twine upload dist/* -r pypitest
   (pypi suggest using twine as other methods upload files via plaintext.)
Lysandre's avatar
Lysandre committed
31
32
   You may have to specify the repository url, use the following command then:
   twine upload dist/* -r pypitest --repository-url=https://test.pypi.org/legacy/
33
34

   Check that you can install it in a virtualenv by running:
35
   pip install -i https://testpypi.python.org/pypi transformers
36
37
38
39
40
41

6. Upload the final version to actual pypi:
   twine upload dist/* -r pypi

7. Copy the release notes from RELEASE.md to the tag in github once everything is looking hunky-dory.

Lysandre's avatar
Lysandre committed
42
8. Add the release version to docs/source/_static/js/custom.js and .circleci/deploy.sh
43
44

9. Update README.md to redirect to correct documentation.
45
46

10. Update the version in __init__.py, setup.py to the new version "-dev" and push to master.
47
"""
Aymeric Augustin's avatar
Aymeric Augustin committed
48

Stas Bekman's avatar
Stas Bekman committed
49
import os
50
51
52
import shutil
from pathlib import Path

thomwolf's avatar
thomwolf committed
53
54
from setuptools import find_packages, setup

55

56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# Remove stale transformers.egg-info directory to avoid https://github.com/pypa/pip/issues/5466
stale_egg_info = Path(__file__).parent / "transformers.egg-info"
if stale_egg_info.exists():
    print(
        (
            "Warning: {} exists.\n\n"
            "If you recently updated transformers to 3.0 or later, this is expected,\n"
            "but it may prevent transformers from installing in editable mode.\n\n"
            "This directory is automatically generated by Python's packaging tools.\n"
            "I will remove it now.\n\n"
            "See https://github.com/pypa/pip/issues/5466 for details.\n"
        ).format(stale_egg_info)
    )
    shutil.rmtree(stale_egg_info)


72
73
extras = {}

74
extras["ja"] = ["fugashi>=1.0", "ipadic>=1.0.0,<2.0", "unidic_lite>=1.0.7", "unidic>=1.0.2"]
75
extras["sklearn"] = ["scikit-learn"]
76
77
78

# keras2onnx and onnxconverter-common version is specific through a commit until 1.7.0 lands on pypi
extras["tf"] = [
sgugger's avatar
sgugger committed
79
    "tensorflow>=2.0",
Lysandre's avatar
Lysandre committed
80
81
82
83
    "onnxconverter-common",
    "keras2onnx"
    # "onnxconverter-common @ git+git://github.com/microsoft/onnxconverter-common.git@f64ca15989b6dc95a1f3507ff6e4c395ba12dff5#egg=onnxconverter-common",
    # "keras2onnx @ git+git://github.com/onnx/keras-onnx.git@cbdc75cb950b16db7f0a67be96a278f8d2953b48#egg=keras2onnx",
84
85
]
extras["tf-cpu"] = [
sgugger's avatar
sgugger committed
86
    "tensorflow-cpu>=2.0",
Lysandre's avatar
Lysandre committed
87
88
89
90
    "onnxconverter-common",
    "keras2onnx"
    # "onnxconverter-common @ git+git://github.com/microsoft/onnxconverter-common.git@f64ca15989b6dc95a1f3507ff6e4c395ba12dff5#egg=onnxconverter-common",
    # "keras2onnx @ git+git://github.com/onnx/keras-onnx.git@cbdc75cb950b16db7f0a67be96a278f8d2953b48#egg=keras2onnx",
91
]
sgugger's avatar
sgugger committed
92
extras["torch"] = ["torch>=1.0"]
Stas Bekman's avatar
Stas Bekman committed
93
94

if os.name == "nt":  # windows
95
    extras["retrieval"] = ["datasets"] # faiss is not supported on windows
Stas Bekman's avatar
Stas Bekman committed
96
    extras["flax"] = [] # jax is not supported on windows
97
98
99
else:
    extras["retrieval"] = ["faiss-cpu", "datasets"]
    extras["flax"] = ["jaxlib==0.1.55", "jax>=0.2.0", "flax==0.2.2"]
Stas Bekman's avatar
Stas Bekman committed
100

101
extras["tokenizers"] = ["tokenizers==0.9.4"]
102
extras["onnxruntime"] = ["onnxruntime>=1.4.0", "onnxruntime-tools>=1.4.2"]
103
extras["modelcreation"] = ["cookiecutter==1.7.2"]
104

105
extras["serving"] = ["pydantic", "uvicorn", "fastapi", "starlette"]
106

107
extras["sentencepiece"] = ["sentencepiece==0.1.91", "protobuf"]
Ola Piktus's avatar
Ola Piktus committed
108
extras["retrieval"] = ["faiss-cpu", "datasets"]
109
extras["testing"] = ["pytest", "pytest-xdist", "timeout-decorator", "parameterized", "psutil"] + extras["retrieval"] + extras["modelcreation"]
110
# sphinx-rtd-theme==0.5.0 introduced big changes in the style.
Sylvain Gugger's avatar
Sylvain Gugger committed
111
extras["docs"] = ["recommonmark", "sphinx==3.2.1", "sphinx-markdown-tables", "sphinx-rtd-theme==0.4.3", "sphinx-copybutton"]
Sylvain Gugger's avatar
Sylvain Gugger committed
112
extras["quality"] = ["black >= 20.8b1", "isort >= 5.5.4", "flake8 >= 3.8.3"]
Stas Bekman's avatar
Stas Bekman committed
113
114
115
116


extras["all"] = extras["tf"] + extras["torch"] + extras["flax"] + extras["sentencepiece"] + extras["tokenizers"]

117
extras["dev"] = extras["all"] + extras["testing"] + extras["quality"] + extras["ja"] + extras["docs"] + extras["sklearn"] + extras["modelcreation"]
Stas Bekman's avatar
Stas Bekman committed
118

119

thomwolf's avatar
thomwolf committed
120
setup(
121
    name="transformers",
LysandreJik's avatar
LysandreJik committed
122
    version="4.0.0-rc-1",
sgugger's avatar
sgugger committed
123
    author="Thomas Wolf, Lysandre Debut, Victor Sanh, Julien Chaumond, Sam Shleifer, Patrick von Platen, Sylvain Gugger, Google AI Language Team Authors, Open AI team Authors, Facebook AI Authors, Carnegie Mellon University Authors",
thomwolf's avatar
thomwolf committed
124
    author_email="thomas@huggingface.co",
thomwolf's avatar
thomwolf committed
125
    description="State-of-the-art Natural Language Processing for TensorFlow 2.0 and PyTorch",
126
    long_description=open("README.md", "r", encoding="utf-8").read(),
thomwolf's avatar
thomwolf committed
127
    long_description_content_type="text/markdown",
128
129
    keywords="NLP deep learning transformer pytorch tensorflow BERT GPT GPT-2 google openai CMU",
    license="Apache",
130
    url="https://github.com/huggingface/transformers",
Aymeric Augustin's avatar
Aymeric Augustin committed
131
    package_dir={"": "src"},
132
    packages=find_packages("src"),
133
134
    install_requires=[
        "numpy",
135
        "tokenizers == 0.9.4",
136
137
        # dataclasses for Python versions that don't have it
        "dataclasses;python_version<'3.7'",
138
139
        # utilities from PyPA to e.g. compare versions
        "packaging",
Aymeric Augustin's avatar
Aymeric Augustin committed
140
        # filesystem locks e.g. to prevent parallel downloads
141
        "filelock",
Aymeric Augustin's avatar
Aymeric Augustin committed
142
        # for downloading models over HTTPS
143
        "requests",
Aymeric Augustin's avatar
Aymeric Augustin committed
144
        # progress bars in model download and training scripts
145
        "tqdm >= 4.27",
Aymeric Augustin's avatar
Aymeric Augustin committed
146
        # for OpenAI GPT
147
        "regex != 2019.12.17",
Aymeric Augustin's avatar
Aymeric Augustin committed
148
        # for XLM
149
        "sacremoses",
thomwolf's avatar
thomwolf committed
150
    ],
151
    extras_require=extras,
152
    entry_points={"console_scripts": ["transformers-cli=transformers.commands.transformers_cli:main"]},
153
    python_requires=">=3.6.0",
thomwolf's avatar
thomwolf committed
154
    classifiers=[
Aymeric Augustin's avatar
Aymeric Augustin committed
155
156
157
        "Development Status :: 5 - Production/Stable",
        "Intended Audience :: Developers",
        "Intended Audience :: Education",
158
159
        "Intended Audience :: Science/Research",
        "License :: OSI Approved :: Apache Software License",
Aymeric Augustin's avatar
Aymeric Augustin committed
160
        "Operating System :: OS Independent",
161
        "Programming Language :: Python :: 3",
Aymeric Augustin's avatar
Aymeric Augustin committed
162
163
        "Programming Language :: Python :: 3.6",
        "Programming Language :: Python :: 3.7",
164
        "Topic :: Scientific/Engineering :: Artificial Intelligence",
thomwolf's avatar
thomwolf committed
165
166
    ],
)