Troubleshooting

This section provides guidance on common issues, logging configurations, and reporting bugs.

Supported Platforms

• Operating Systems: The package has been developed and tested on Linux (Ubuntu 22.04 and later).

• Python Versions: This package is compatible with Python 3.10 and above.

Installation Issues

• Problem: “Package not found” or “No matching distribution found”

  • Possible cause: This usually occurs if the required Python version or dependencies are not satisfied.

  • Solution:

    1. Ensure you’re using Python 3.10 or newer:

    python --version
    

    2. Check the package name is correct:

    pip install pydruglogics
    

• Problem: “Permission denied” or “Could not install package”

  • Possible cause: Administrative privileges are required or there is a conflict in the environment.

  • Solution: Use a virtual environment:

    python -m venv venv
    source venv/bin/activate  # On Linux
    pip install pydruglogics
    

Setting Logging Level to DEBUG

To gather more information about program execution, you can set the logger level to DEBUG. This enables detailed logging that can help diagnose issues.

Here’s how to set the logging level:

from pydruglogics.utils.Logger import Logger
Logger.set_logger(level=logging.DEBUG)

Reporting Issues

If you encounter a bug or wish to request a feature, please report it on our GitHub issue tracker:

GitHub Issues Page

When reporting an issue, include:

• Your operating system and version (e.g, Ubuntu 22.04)

• Python version (e.g. Python 3.11.10)

• The error message and traceback (if applicable)

• Steps to reproduce the issue

Thank you for your help!