setup.py 6.25 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.

LysandreJik's avatar
LysandreJik committed
6
1. Change the version in __init__.py, setup.py as well as docs/source/conf.py.
7

Lysandre's avatar
Lysandre committed
8
9
2. Unpin specific versions from setup.py (like isort).

10
11
12
13
14
15
16
17
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
18
   For the wheel, run: "python setup.py bdist_wheel" in the top level directory.
19
   (this will build a wheel for the python version you use to build it).
20
21

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

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
28
29
   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/
30
31

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

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
39
8. Add the release version to docs/source/_static/js/custom.js and .circleci/deploy.sh
40
41

9. Update README.md to redirect to correct documentation.
42
"""
Aymeric Augustin's avatar
Aymeric Augustin committed
43

44
45
46
import shutil
from pathlib import Path

thomwolf's avatar
thomwolf committed
47
48
from setuptools import find_packages, setup

49

50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
# 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)


66
67
extras = {}

68
extras["ja"] = ["fugashi>=1.0", "ipadic>=1.0.0,<2.0", "unidic_lite>=1.0.7", "unidic>=1.0.2"]
69
extras["sklearn"] = ["scikit-learn"]
70
71
72

# keras2onnx and onnxconverter-common version is specific through a commit until 1.7.0 lands on pypi
extras["tf"] = [
sgugger's avatar
sgugger committed
73
    "tensorflow>=2.0",
Lysandre's avatar
Lysandre committed
74
75
76
77
    "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",
78
79
]
extras["tf-cpu"] = [
sgugger's avatar
sgugger committed
80
    "tensorflow-cpu>=2.0",
Lysandre's avatar
Lysandre committed
81
82
83
84
    "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",
85
]
sgugger's avatar
sgugger committed
86
extras["torch"] = ["torch>=1.0"]
87
extras["onnxruntime"] = ["onnxruntime>=1.4.0", "onnxruntime-tools>=1.4.2"]
88

89
extras["serving"] = ["pydantic", "uvicorn", "fastapi", "starlette"]
Julien Plu's avatar
Julien Plu committed
90
extras["all"] = extras["serving"] + ["tensorflow", "torch"]
91

Ola Piktus's avatar
Ola Piktus committed
92
93
extras["retrieval"] = ["faiss-cpu", "datasets"]
extras["testing"] = ["pytest", "pytest-xdist", "timeout-decorator", "parameterized", "psutil"] + extras["retrieval"]
94
# sphinx-rtd-theme==0.5.0 introduced big changes in the style.
95
extras["docs"] = ["recommonmark", "sphinx", "sphinx-markdown-tables", "sphinx-rtd-theme==0.4.3", "sphinx-copybutton"]
96
extras["quality"] = ["black >= 20.8b1", "isort >= 5", "flake8 >= 3.8.3"]
97
extras["dev"] = extras["testing"] + extras["quality"] + extras["ja"] + ["scikit-learn", "tensorflow", "torch"]
98

thomwolf's avatar
thomwolf committed
99
setup(
100
    name="transformers",
Lysandre's avatar
Lysandre committed
101
    version="3.3.0",
sgugger's avatar
sgugger committed
102
    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
103
    author_email="thomas@huggingface.co",
thomwolf's avatar
thomwolf committed
104
    description="State-of-the-art Natural Language Processing for TensorFlow 2.0 and PyTorch",
105
    long_description=open("README.md", "r", encoding="utf-8").read(),
thomwolf's avatar
thomwolf committed
106
    long_description_content_type="text/markdown",
107
108
    keywords="NLP deep learning transformer pytorch tensorflow BERT GPT GPT-2 google openai CMU",
    license="Apache",
109
    url="https://github.com/huggingface/transformers",
Aymeric Augustin's avatar
Aymeric Augustin committed
110
    package_dir={"": "src"},
111
    packages=find_packages("src"),
112
113
    install_requires=[
        "numpy",
114
        "tokenizers == 0.8.1.rc2",
115
116
        # dataclasses for Python versions that don't have it
        "dataclasses;python_version<'3.7'",
117
118
        # utilities from PyPA to e.g. compare versions
        "packaging",
Aymeric Augustin's avatar
Aymeric Augustin committed
119
        # filesystem locks e.g. to prevent parallel downloads
120
        "filelock",
Aymeric Augustin's avatar
Aymeric Augustin committed
121
        # for downloading models over HTTPS
122
        "requests",
Aymeric Augustin's avatar
Aymeric Augustin committed
123
        # progress bars in model download and training scripts
124
        "tqdm >= 4.27",
Aymeric Augustin's avatar
Aymeric Augustin committed
125
        # for OpenAI GPT
126
        "regex != 2019.12.17",
Aymeric Augustin's avatar
Aymeric Augustin committed
127
        # for XLNet
128
        "sentencepiece != 0.1.92",
Aymeric Augustin's avatar
Aymeric Augustin committed
129
        # for XLM
130
        "sacremoses",
thomwolf's avatar
thomwolf committed
131
    ],
132
    extras_require=extras,
133
134
135
    entry_points={
        "console_scripts": ["transformers-cli=transformers.commands.transformers_cli:main"]
    },
136
    python_requires=">=3.6.0",
thomwolf's avatar
thomwolf committed
137
    classifiers=[
Aymeric Augustin's avatar
Aymeric Augustin committed
138
139
140
        "Development Status :: 5 - Production/Stable",
        "Intended Audience :: Developers",
        "Intended Audience :: Education",
141
142
        "Intended Audience :: Science/Research",
        "License :: OSI Approved :: Apache Software License",
Aymeric Augustin's avatar
Aymeric Augustin committed
143
        "Operating System :: OS Independent",
144
        "Programming Language :: Python :: 3",
Aymeric Augustin's avatar
Aymeric Augustin committed
145
146
        "Programming Language :: Python :: 3.6",
        "Programming Language :: Python :: 3.7",
147
        "Topic :: Scientific/Engineering :: Artificial Intelligence",
thomwolf's avatar
thomwolf committed
148
149
    ],
)