gitrepoxmlparser 0.3.3

Provides Details for your GitRepo master manifest file

GitRepoXMLParser

Capable of processing the AOSP repo's manifest file differentiating from the supplier

GitRepoXMLParser helps you visualize your AOSP manifest files that is fed for repo tool Rich-powered visualization.

Manifest file example

<manifest >
    <remote fetch = "url" name = "pj-gerrit" review = "" / >
    <include name = "supplier.xml" / >
    <include name = "pj_apps.xml" / >
    <remove-project name = "pathto/projec" / >
    <project name = "supplier/pathto/projectrepo" path = "company/pathto/projectrepo" remote = "pj-gerrit" revision = "branch_name" / >
    <project name = "PJ/pathto/projectrepo1" path = "vendor/pathto/projectrepo1" remote = "pj-gerrit" revision = "branch_name" / >
    <project name = "PJ/pathto/projectrepo2" path = "vendor/pathto/projectrepo2" remote = "pj-gerrit" revision = "branch_name" / >
</manifest >

Features

• Visualize your manifest.xml files visually
• The table size depends on the screensize of the command line utility that you are running the script
• HTML report supports global search across all tables and sortable columns

Installation

gitrepoxmlparser requires Rich 12.5.1+.

pip install gitrepoxmlparser

Install from source using Make (cross-platform)

make install

Usage

cmd>gitrepoxmlparser -h
usage: -m [-h] -f F -c C -s S [-x]

options:
  -h, --help  show this help message and exit
  -f F        manifest xml file
  -c C        Your company name (Should match with companies folder name in the stack)
  -s S        Supplier's Company name (just contrasts with only one vendor)
  -x, --html  For html report
  -p PORT, --port PORT  Port for web server (default: 8080)

HTML Report

Generate an interactive HTML report with the -x flag:

gitrepoxmlparser -f manifest.xml -c company_name -s supplier_name -x

The HTML report uses Flask + Jinja2 for professional, responsive table rendering:

• Full-width tables that adapt to screen size
• Beautiful gradient header and statistics dashboard
• Clean typography and proper spacing
• Hover effects and alternating row colors for readability
• Emoji icons for visual distinction of sections
• Global search input to filter rows across all rendered tables
• Click-to-sort columns on every table (ascending/descending toggle)

Optional: specify a custom port for the web server (default: 8080):

gitrepoxmlparser -f manifest.xml -c company_name -s supplier_name -x -p 9090

To activate the virtual env

poetry shell

Installing dependencies only

poetry install --no-root

To install the dependencies and install the package (reads the poetry.lock or pyproject.toml file )

poetry install

Run tests

poetry run pytest

Build package artifacts

poetry build

Automation

• CI workflow: .github/workflows/ci.yml
  • Runs on push/PR
  • Installs dependencies
  • Runs tests
  • Builds package artifacts
• Release workflow: .github/workflows/release.yml
  • Runs when a tag like v0.3.1 is pushed
  • Builds artifacts and creates a GitHub Release with attached dist/* files

License

MIT

Free Software, Hell Yeah!