Skip to main content

Python Library for common code used across my packages.

Project description

https://travis-ci.org/kenlowrie/pylib.svg?branch=add%2Fdocs_and_unittests

PyLib is a library of useful (to me) functions and classes for building applications and packages written in Python. It supports both the 2.x and 3.x versions of Python.

Installing

pip install kenl380.pylib

Documentation

Read the documentation for PyLib. (TODO: hyperlink this to online docs)

Credits

PyLib was written and is maintained by Ken Lowrie

License

PyLib is released under the Apache 2.0 license

Developing

Start by setting up your environment using pipenv. Switch to the local copy of your repository and:

pipenv install

The pipenv install step is only required once to setup the virtual environment. After that, you can type pipenv shell to spawn a shell that’s setup for working on pylib.

pylib is installed in edit mode after running the pipenv install, so you can make changes directly to the code and test them interactively when working inside the pipenv shell prompt.

If you’re building an application, you can:

import kenl380.pylib as pylib

to load the methods and classes from pylib into your applications’ namespace.

Documentation

Sphinx is used to create the documentation for pylib. Be sure to add or update the docs for any changes you make. This is required if you plan on submitting a pull request.

The documentation is hosted online at kenl380pylib.readthedocs.io

Testing

Make sure that you write unittests for any new methods or classes that you add. You can test them using tox.

For example, to run unit tests, issue this command from your pipenv shell:

tox

PyLib’s tox.ini is configured to run all of the unittests on both Python 2.7 and 3.6, so you need to have both installed locally in order to run the tests. You can use Homebrew or Pyenv to get multiple versions installed on your local system.

Conclusion

If you have questions or comments, feel free to message me or email me. If you find an issue, please add 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

kenl380.pylib-1.0.0rc1.tar.gz (7.9 kB view hashes)

Uploaded Source

Built Distribution

kenl380.pylib-1.0.0rc1-py2.py3-none-any.whl (7.6 kB view hashes)

Uploaded Python 2 Python 3

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