Metadata-Version: 2.1
Name: cerbos
Version: 0.0.0
Summary: SDK for working with Cerbos: an open core, language-agnostic, scalable authorization solution
Author-email: Cerbos Developers <sdk+python@cerbos.dev>
License: Apache-2.0
Project-URL: Homepage, https://cerbos.dev
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Security
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: anyio (>=3.6.1)
Requires-Dist: circuitbreaker (>=2.1.3)
Requires-Dist: dataclasses-json (>=0.5.7)
Requires-Dist: googleapis-common-protos (>=1.62.0)
Requires-Dist: grpcio-status (>=1.73.0)
Requires-Dist: grpcio-tools (>=1.54.2)
Requires-Dist: httpx[http2] (>=0.22.0)
Requires-Dist: protobuf (>=6.31.0)
Requires-Dist: protoc-gen-openapiv2 (>=0.0.1)
Requires-Dist: requests-toolbelt (>=0.9.1)
Requires-Dist: tenacity (>=8.1.0)
Requires-Dist: types-protobuf (>=4.24.0.1)
Provides-Extra: testcontainers
Requires-Dist: testcontainers (>=4.13.3) ; extra == 'testcontainers'

# python-cerbos Debian package

This repository contains the Debian package to use [cerbos](https://cerbos.dev) in UCS 5.2.

The cerbos SDK is licensed under the Apache-2.0 license.

From the `cerbos` README:

SDK for working with Cerbos:
an open core, language-agnostic, scalable authorization solution.

## Update version

- Update `$VERSION` in `Makefile`
- Provide `cerbos-${VERSION}.tar.gz.sha256` (e.g. via `make hash`)
- Update changelog (`dch -i`)
- Update `DEBIAN_RELEASE` and `DEBIAN_SCOPE` in `.gitlab-ci.yml` and/or repository settings.
- Commit and push changes
- Either build manually (e.g. by triggering the pipeline via GitLab UI),
  or push a git tag, then the CI pipeline will build the package.

## Manual build

```bash
@omar repo_admin.py -G "https://git.knut.univention.de/univention/dev/libraries/python-cerbos.git" -p python-cerbos -b "main" -P . -s errata5.2-6 -r 5.2
@ladda build-package-ng -r 5.2 -s errata5.2-6 -p python-cerbos
```

## Merge request

Every branch or MR build publishes the `.deb` to a per-branch Aptly repo
(`debian-aptly`). Install it on a UCS server to test your branch. Replace
`<branch>` with your branch.

```
deb [trusted=yes] http://omar.knut.univention.de/build2/git/python-cerbos <branch> main
```

## UCS package builds on the main branch

Pipeline jobs automatically builds the debian package via repo-ng after pushing to `main`.

**You need to bump the version in `debian/changelog`**

The package is available in the internal apt repository:

```bash
deb [trusted=yes] http://omar.knut.univention.de/build2/ ucs_5.2-0-errata5.2-6/all/
deb [trusted=yes] http://omar.knut.univention.de/build2/ ucs_5.2-0-errata5.2-6/$(ARCH)/
```

and in the external errata test component, used by the jenkins tests.

The UCS version for the build system can be configured in `.gitlab-ci.yml`.

## UCS Release

Just as normal errata release (scope errataX.X-X), or as part of a UCS major, minor or patchlevel
release (scope: ucsX.X-X).
