Skip to main content

A collection of python utils for webapps.

Project description

:tulip: toolip :tulip:

A collection of python utils for webapps

Tests

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

  1. Change the version in the pyproject.toml and toolip/__init__.py files
    • you can use poetry version XXXXX to change pyproject.toml
  2. Commit to git
  3. Run poetry build to create the package folders in /dist
  4. Run flit publish to publish to PyPI
  5. Tag the release in git and push it to Github

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

toolip-0.2.tar.gz (35.2 kB view details)

Uploaded Source

Built Distribution

toolip-0.2-py2.py3-none-any.whl (8.3 kB view details)

Uploaded Python 2 Python 3

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

Hashes for toolip-0.2.tar.gz
Algorithm Hash digest
SHA256 85fb496aa81e6fd95dc793d8bbea463096cdf92b16926eb5929cc27a9fcf3506
MD5 f189c51d7405af9e03ac7aac0c0b30fc
BLAKE2b-256 8900dff021f3fa14637ba44a08d00866c862c815daa706e438e9e97a29709961

See more details on using hashes here.

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

Hashes for toolip-0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 2a8e3b6390e2a229e7d8ff27681439a8c9b5954f330d4de9948c07273ff1b60c
MD5 8f47f467f1279ad91489f9fc65abd31a
BLAKE2b-256 215b61592a29620bc754443f72a873633f6b32756555edde9d4f2d20cafc3b64

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page