A small example package
Project description
mattermost-utils
Requirements
- pip package manager
- python version 3.8
Deployment on Linux
- Clone project on your local machine
git clone https://gitlab.tech.orange/dtrs-security/devops/mattermost-utils.git
Usage
Build
Make sure you have the latest versions of setuptools and wheel installed:
python3 -m pip install --user --upgrade setuptools wheel
Now run this command from the same directory where setup.py is located:
python setup.py sdist bdist_wheel
This command should output a lot of text and once completed should generate two files in the dist directory:
dist/
mattermost_post_utils-0.0.1-py3-none-any.whl
mattermost_post_utils-0.0.1.tar.gz
Uploading the distribution archives
The first thing you’ll need to do is register an account on PyPI
Now you’ll create a PyPI API token so you will be able to securely upload your project. Go to https://test.pypi.org/manage/account/#api-tokens and create a new API token; don’t limit its scope to a particular project, since you are creating a new project.
Don’t close the page until you have copied and saved the token — you won’t see that token again.
Now that you are registered, you can use twine to upload the distribution packages. You’ll need to install Twine:
python3 -m pip install --user --upgrade twine
Once installed, run Twine to upload all of the archives under dist:
python3 -m twine upload dist/*
You will be prompted for a username and password. For the username, use token. For the password, use the token value, including the pypi- prefix.
After the command completes, you should see output similar to this:
Uploading distributions to https://pypi.org/legacy/
Enter your username: __token__
Enter your password: <your_token>
Uploading example_pkg_YOUR_USERNAME_HERE-0.0.1-py3-none-any.whl
100%|█████████████████████| 4.65k/4.65k [00:01<00:00, 2.88kB/s]
Uploading example_pkg_YOUR_USERNAME_HERE-0.0.1.tar.gz
100%|█████████████████████| 4.25k/4.25k [00:01<00:00, 3.05kB/s]
Once uploaded your package should be viewable on TestPyPI, for example, https://pypi.org/project/example-pkg-YOUR-USERNAME-HERE
Installing your newly uploaded package
You can use pip to install your package and verify that it works.
python3 -m pip install --no-deps example-pkg-YOUR-USERNAME-HERE
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for mattermost_post_utils-0.0.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7e31b38249de2f3421cd9fb97679d4cf202e40691c095145dc0cc454f36b9560 |
|
MD5 | 8cce5d51192253d2fe3ef3335b0c9ce8 |
|
BLAKE2b-256 | c5ffc25071fa5b648cb524e5206deb15ab1a5df78a97a10b82cc5d5a9ea9ad21 |
Hashes for mattermost_post_utils-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cea898ca573d0e5dbc12a18ad864e91014e9fcf5278eff7ec77cd1ce3367be73 |
|
MD5 | 6b49772606773faeb7fc574fb40970f2 |
|
BLAKE2b-256 | 89d1bd245970d610d04a65b315403f1e41089fc8ac03245ffee05c7f77ffb5ba |