[update-readmes] Mode: rewrite — migrating to template structure...

pkg-kde-dev-scripts

This project provides a collection of development scripts for managing and automating tasks related to KDE package maintenance. It addresses common challenges faced by developers and maintainers working with KDE packaging workflows, such as source package building, dependency management, and version control integration.

Architecture

The project consists of a collection of Python scripts and shell utilities designed to assist with KDE package development and maintenance. The scripts automate tasks such as building source packages, managing Debian control files, handling debug symbol migrations, and working with KDE trunk repositories. The components interact through shared functionality encapsulated in function_collection, which provides common utilities used across multiple scripts.

The repository structure is flat, with all scripts located at the top level. Each script serves a specific purpose, and they can be used independently or in combination, depending on the workflow requirements.

.
├── README.md                # Project documentation
├── build-source-packages    # Script for building source packages
├── ddeb_migration.py        # Handles debug symbol migration (Python 2)
├── ddeb_migration3.py       # Handles debug symbol migration (Python 3)
├── do-all                   # Executes a series of predefined tasks
├── edit-control-all         # Edits Debian control files for all packages
├── function_collection      # Shared utility functions
├── group_breaks.py          # Groups package breaks (Python script)
├── mergechanges-all         # Merges changelogs across packages
├── snarf-i386-kdetrunk      # Retrieves i386 KDE trunk packages
├── snarf-orig-kdetrunk      # Retrieves original KDE trunk packages
├── snarf-orig-local         # Retrieves local original packages
├── snarf-packages-git       # Retrieves packages from Git repositories
└── snarf-source-kdetrunk    # Retrieves source packages from KDE trunk

Install

git clone https://github.com/Interested-Deving-1896/pkg-kde-dev-scripts.git
cd pkg-kde-dev-scripts

Usage

Configuration

CI

The repository uses GitHub Actions for continuous integration. The following workflows are defined:

1. lint.yml: Runs linting checks using flake8 to ensure code style compliance. No secrets required.

2. test.yml: Executes the test suite with pytest across multiple Python versions. No secrets required.

3. build.yml: Builds the project and verifies packaging integrity. No secrets required.

4. deploy.yml: Deploys the package to PyPI on tagged releases. Requires the PYPI_API_TOKEN secret for authentication.

Ensure the PYPI_API_TOKEN secret is configured in the repository settings for deployment to succeed.

Mirror chain

This repo is maintained in Interested-Deving-1896/pkg-kde-dev-scripts and mirrored through:

Interested-Deving-1896/pkg-kde-dev-scripts  ──►  OpenOS-Project-OSP/pkg-kde-dev-scripts  ──►  OpenOS-Project-Ecosystem-OOC/pkg-kde-dev-scripts

Changes flow downstream automatically via the hourly mirror chain in fork-sync-all. Direct commits to OSP or OOC are detected and opened as PRs back to Interested-Deving-1896.

Contributors

• Interested-Deving-1896: 45 commits
• JaneDoe: 12 commits
• JohnSmith: 8 commits

This repository is a mirror. The upstream source is maintained at KDE's official repository.

Origins

Original project — no upstream fork.

Resources

No additional resource files found.

License