Skip to content

Conversation

@semuadmin
Copy link
Contributor

@semuadmin semuadmin commented Oct 27, 2025

pygnssutils Pull Request Template

Description

  1. Add support for TLS connections in SocketServer. Introduces two alternative client request handler classes - ClientHandler (HTTP) or ClientHandlerTLS (HTTPS). TLS operation requires a suitable TLS certificate/key pair (in pem format) to be located at a path designated by environment variable PYGNSSUTILS_PEMPATH - the default path is $HOME/pygnssutils.pem. See Sphinx documentation for details.

    A self-signed pem file suitable for test and demonstration purposes can be created thus:

    openssl req -x509 -newkey rsa:4096 -keyout pygnssutils.pem -out pygnssutils.pem -sha256 -days 3650 -nodes
  2. Additional --cliout option OUTPUT_SOCKET_TLS (6) added to gnssserver, gnssstreamer, gnssntripclient and gnssmqttclient cli utilities (remember to set PYGNSSUTILS_PEMPATH), e.g.:

    gnssstreamer -P /dev/tty.usbmodem101 --format 2 --cliout 6 --output '0.0.0.0:8443' --verbosity 2

Testing

Please test all changes, however trivial, against the supplied pytest suite tests/test_*.py. Please describe any test cases you have amended or added to this suite to maintain >= 99% code coverage.

  • Test A
  • Test B

Checklist:

  • I agree to abide by the code of conduct (see CODE_OF_CONDUCT.md).
  • My code follows the style guidelines of this project (see CONTRIBUTING.md).
  • I have performed a self-review of my own code.
  • (if appropriate) I have cited my u-blox documentation source(s).
  • I have commented my code, particularly in hard-to-understand areas.
  • I have made corresponding changes to the documentation.
  • (if appropriate) I have added test cases to the tests/test_*.py unittest suite to maintain >= 99% code coverage.
  • I have tested my code against the full tests/test_*.py unittest suite.
  • My changes generate no new warnings.
  • Any dependent changes have been merged and published in downstream modules.
  • I have signed my commits.
  • I understand and acknowledge that the code will be published under a BSD 3-Clause license.

@semuadmin semuadmin added this to the RC 1.1.19 milestone Oct 27, 2025
@semuadmin semuadmin requested a review from a team October 27, 2025 13:07
@semuadmin semuadmin self-assigned this Oct 27, 2025
@semuadmin semuadmin added the enhancement New feature or request label Oct 27, 2025
@semuadmin semuadmin marked this pull request as draft October 27, 2025 13:09
@semuadmin semuadmin force-pushed the RC-1.1.19 branch 3 times, most recently from 9d5735b to 091817b Compare October 31, 2025 08:36
@semuadmin semuadmin marked this pull request as ready for review October 31, 2025 08:40
@semuadmin semuadmin marked this pull request as draft October 31, 2025 19:55
@semuadmin semuadmin marked this pull request as ready for review November 1, 2025 07:34
@semuadmin semuadmin merged commit 6f76c38 into main Nov 1, 2025
5 checks passed
@semuadmin semuadmin deleted the RC-1.1.19 branch November 1, 2025 07:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants