# cqpkg

**Repository Path**: wangtiaoke/cqpkg

## Basic Information

- **Project Name**: cqpkg
- **Description**: CqOS utility for working with dist-git
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: develop
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 5
- **Forks**: 1
- **Created**: 2025-01-22
- **Last Updated**: 2025-08-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cqpkg

A tool for working with CqOS dist-git

Cqpkg is a wrapper for `rpkg` that interacts with RPM git repositories like the
ones hosted at [internal Gitlab](http://192.168.10.152).  Rpkg also provides
some convenience methods/commands for local builds via `mock` or `rpmbuild`, for
interacting with Koji, and for generating patches.

Not all typical `rpkg` commands have been implemented yet.  If the command you
are looking for doesn't appear to work, please open an issue or make a PR.

This repository provides a console script, `cqpkg`.

## cqpkg

The `cqpkg` script allows you to interact with CqOS dist-git.

## Installation (for cqos)

Use `curl` to download the script and execute it with `bash`:

```sh
curl -LsSf https://gitee.com/wangtiaoke/cqpkg/raw/develop/install | bash
```

If your system doesn't have `curl`, you can use `wget`:

```sh
wget -qO- https://gitee.com/wangtiaoke/cqpkg/raw/develop/install | bash
```

Because CQOS was modified inconsistently with the upstream Linux distro.
We maintain a separate installation script for it. This script also handles 
environment setup and configuration updates for cqos.

Use this script solely for updating Koji's configuration:

```sh
curl -LsSf https://gitee.com/wangtiaoke/cqpkg/raw/develop/install | bash -s -- --update-koji-config
```

Use this script solely for updating Mock's configuration:

```sh
curl -LsSf https://gitee.com/wangtiaoke/cqpkg/raw/develop/install | bash -s -- --update-mock-config
```

## Supported commands

Here is the list of supported commands by cqpkg:

- rpmbuild wrapper: local, prep, build, install...
- mock-config

Here is the list of supported commands by cqpkg-oa:

- sources

## Contribution

Some features are still missing, and we'd love to have your help in implementing
them! If you have a feature in mind that isn't currently available, please don't
hesitate to:

- Open an issue to discuss the feature.
- Submit a pull request with your implementation.

Thank you for contributing to the project!

## Development

### Setting Up the Development Environment

**Prerequisites:**

```sh
sudo dnf install -y libcurl-devel python3-devel gcc openssl-devel
```

### Developing

To clone the repository and install the package:

```sh
git clone https://gitee.com/wangtiaoke/cqpkg.git
cd cqpkg
make install
```

### User Level Global Install

To install the package globally for current user:

```bash
uv tool install -e . --with ./lib/rpkg/ --with python-gitlab --with dotenv
```

Although we do not have `pyproject.toml`, we can still use `uv tool install` to install this project.

### Build RPM package

Modify cqpkg.spec and create a tag:

```sh
git tag 0.0.4 # In Makefile will use tag as version
make mockbuild
```

Note: Current .spec for Cqos 24

### koji config

To config koji API for cqpkg. You can use the following config, save it as `~/.koji/config`:

```conf
[koji]
server = http://192.168.10.142/kojihub
weburl = http://192.168.10.142/koji
topurl = http://192.168.10.142/kojifiles
```