A collection of python utils for webapps.
Project description
:tulip: toolip :tulip:
A collection of python utils for webapps
Installation
pip install toolip
Contributing
If you want to contribute a small change/feature, the best is to just create a PR with your changes. For bigger changes/features it's best to open an issue first and discuss it to agree on the code organization and overall implementation before spending too much time on the code, unless you want to keep it in your own forked repo.
Setting up the development environment
We use the python poetry package to manage this package.
Follow the official instructions to install poetry on your system then once you clone
this repository just just need to do the following to install the dependencies from
the development environment, as well as install toolip
in
editable mode:
poetry install
Then you can start monitoring the code for changes and run the test suite this way:
poetry shell
scripts/test_watch.sh
Build and run documentation (lazydocs/mkdocs)
Documentation for this package is handled by lazydocs
and so it needs a few steps to generate it locally.
Inside poetry shell
:
lazydocs --overview-file="index.md" \
--src-base-url="https://github.com/SatelCreative/toolip/tree/main" \
--output-path="./docs/api-docs" \
--validate .
mkdocs build
mkdocs serve
The default URL is at 127.0.0.1:8000
.
Maintenance
We use poetry to manage the dependencies and flit to build and publish to pypi because unlike poetry it allows to set the metadata on pypi such as author or homepage.
Howto publish
- Change the version in the
pyproject.toml
andtoolip/__init__.py
files- you can use
poetry version XXXXX
to changepyproject.toml
- you can use
- Commit to git
- Run
poetry build
to create the package folders in/dist
- Run
flit publish
to publish to PyPI - Tag the release in git and push it to Github
Project details
Release history Release notifications | RSS feed
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
File details
Details for the file toolip-0.2.tar.gz
.
File metadata
- Download URL: toolip-0.2.tar.gz
- Upload date:
- Size: 35.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.26.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 85fb496aa81e6fd95dc793d8bbea463096cdf92b16926eb5929cc27a9fcf3506 |
|
MD5 | f189c51d7405af9e03ac7aac0c0b30fc |
|
BLAKE2b-256 | 8900dff021f3fa14637ba44a08d00866c862c815daa706e438e9e97a29709961 |
File details
Details for the file toolip-0.2-py2.py3-none-any.whl
.
File metadata
- Download URL: toolip-0.2-py2.py3-none-any.whl
- Upload date:
- Size: 8.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: python-requests/2.26.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2a8e3b6390e2a229e7d8ff27681439a8c9b5954f330d4de9948c07273ff1b60c |
|
MD5 | 8f47f467f1279ad91489f9fc65abd31a |
|
BLAKE2b-256 | 215b61592a29620bc754443f72a873633f6b32756555edde9d4f2d20cafc3b64 |