Skip to main content

Python LysKOM library

Project description

pylyskom is a Python library for communicating with LysKOM servers over LysKOM Protocol A.

The source code can be found at: https://github.com/osks/pylyskom

Packages are published on PyPI: https://pypi.org/project/pylyskom/

LysKOM Protocol A specification can be found here: https://www.lysator.liu.se/lyskom/protocol/

Background

pylyskom was originally based on python-lyskom. The following files originates from python-lyskom: kom.py, komauxitems.py, aux-items.txt and make_komauxitems. Most of the changes since then comes from httpkom’s use of kom.py. Httpkom also built some wrappers (komsession) around the kom.py code, to make it easier to use. Pylyskom was created as an attempt to break out komsession and the modifications to kom.py from httpkom.

Code status

https://travis-ci.org/osks/pylyskom.svg?branch=master

Development

Preparing a release

TODO: How do we update the documentation on github pages?

On master:

  1. Update and check CHANGELOG.md.

  2. Increment version number and remove +dev suffix (in pylyskom/version.py).

  3. Run tests locally with make test. Test manually by using jskom.

  4. Commit, push.

  5. Check CI build/test results.

  6. Tag (annotated) with v<version> (example: v0.1) and push the tag:

    git tag -a v0.1 -m "Version 0.1"
    git push origin v0.1
  7. Build PyPI dist: make dist

  8. Push to Test PyPI: twine upload --repository testpypi dist/* and check https://test.pypi.org/project/pylyskom/ .

  9. Push to PyPI: twine upload dist/* and check https://pypi.org/project/pylyskom/ .

  10. Add +dev suffix to version number, commit and push.

Tools

Install and update release tools with:

pip install --upgrade setuptools wheel pip twine

Twine is used for pushing the built dist to PyPI. The examples in the release process depends on a .pypirc file with config for the pypi and testpypi repositories.

Example of .pypirc:

[pypi]
username = __token__
password = pypi-...

[testpypi]
repository = https://test.pypi.org/legacy/
username = __token__
password = pypi-...

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

pylyskom-0.8.tar.gz (56.2 kB view details)

Uploaded Source

File details

Details for the file pylyskom-0.8.tar.gz.

File metadata

  • Download URL: pylyskom-0.8.tar.gz
  • Upload date:
  • Size: 56.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.8.2

File hashes

Hashes for pylyskom-0.8.tar.gz
Algorithm Hash digest
SHA256 88d22f0ca3759468e98039310110e143942810610e08218e80097c19c05301ec
MD5 126873bff4c4bbb4be28f3322119db3c
BLAKE2b-256 4708e2a18b63ecfe28f6c23bb80501d637a7fa33b135366119a9f3a5f429f877

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