lupin-sw-ut-report 1.0.1.dev0

Tool used to generate a test reports.

lupin_sw_ut_report

This project converts test files (in .txt and .xml formats) into Markdown reports. The goal is to facilitate the documentation of software test results by providing readable Markdown files that can be used for comprehensive reporting.

Features

• TXT and XML File Conversion: Converts test files into structured Markdown files for better readability.
• Support for Given-When-Then Formats: Parses and converts test files defined using the Given, When, Then format.
• Combined Report Generation: Creates a single Markdown file summarizing all tests found in the specified folder.
• Command-Line Interface (CLI) with Typer: A CLI tool for easy execution of conversions.

Installation

Run pip install lupin-sw-ut-report

Usage

This project provides a command-line interface to generate reports from a folder containing test files (.txt and .xml).

To run the script, use the following command:

sw-ut-report --input-folder <path/to/your/input-folder>

Manual Publishing to PyPI

Note: For a fully automated deployment process, see the next section on using the provided PowerShell script.

To publish this package to PyPI, follow these manual steps:

1. Update the Version

You must update the version number in both of these files:

• src/sw_ut_report/__init__.py (e.g., __version__ = "0.1.0")
• pyproject.toml (e.g., version = "0.1.0")

Make sure the version numbers match in both files. This is required for a successful and consistent release.

2. Build the Package

Install the build tool if you haven't already:

pip install build

Run the following command from the root of the project:

python -m build --no-isolation

This will generate distribution files in the dist/ directory.

3. Prepare for Upload: PyPI Token and .pypirc

• Create an API token on your PyPI account.
• Create a .pypirc file in the root of your repository (but do not commit it to git!).
• The .pypirc file is already listed in .gitignore by default, but always double-check before committing.

Example .pypirc file:

[distutils]
index-servers =
    pypi

[pypi]
username = __token__  # Do not change this value; it must remain exactly as shown
password = <your-pypi-api-token-here>  # Provide your token without any quotes or extra characters

Replace <your-pypi-api-token-here> with your actual PyPI API token.

• Do not add any quotation marks (" or ') or extra characters around the token.
• The line username = __token__ must remain exactly as written.

Important:

• Never share your PyPI token.
• Never commit .pypirc to version control, even if it is already in .gitignore.

4. Upload to PyPI

Install Twine if you haven't already:

pip install twine

Upload your package using Twine and your .pypirc configuration:

twine upload --config-file ./.pypirc dist/*

If successful, your package will be published to PyPI.

Security Reminder

• Keep your PyPI API token secret.
• Do not share your .pypirc file or its contents.
• Always verify you are uploading the correct version and files.

Automated Publishing with PowerShell

You can automate the version update, build, and upload process using the provided PowerShell script:

Prerequisites

• Windows with PowerShell 7 or later
• Python installed and available in your PATH
• .pypirc file present in the project root (see above for details)

Usage

From the project root, run:

pwsh ./publish-to-pypi.ps1 -Version "0.1.2"

Replace 0.1.2 with your desired version number.

What the Script Does

• Checks for the presence of .pypirc and stops if missing
• Installs build and twine if not already installed
• Updates the version in both src/sw_ut_report/__init__.py and pyproject.toml
• Cleans the dist/ directory
• Builds the package
• Uploads the package to PyPI using your .pypirc configuration
• Stops and reports at the first error

This script streamlines the release process and helps ensure consistency between your code and published package.