Metadata-Version: 2.4
Name: charmed-kubeflow-chisme
Version: 0.4.18
Summary: A collection of helpers for Charms maintained by the Charmed Kubeflow team
Home-page: https://github.com/canonical/charmed-kubeflow-chisme
Author: Charmed Kubeflow
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: deepdiff<=6.2.1
Requires-Dist: jinja2
Requires-Dist: lightkube>0.10.0
Requires-Dist: ops>1.2.0
Requires-Dist: serialized-data-interface
Requires-Dist: ruamel.yaml
Requires-Dist: tenacity
Requires-Dist: juju
Requires-Dist: httpx<0.28.0
Requires-Dist: kubernetes>=30.1.0
Requires-Dist: aiohttp<4.0,>=3.8
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: black; extra == "test"
Dynamic: license-file

# Charmed Kubeflow Chisme

Chisme: a Spanish word for gossip, or a story worth telling to your friends.  

This repository is for chisme within the Charmed Kubeflow team's codebase - it is a collection of helpers for use in 
both the Charmed Operators maintained by the [Charmed Kubeflow](ckf) team as well as anyone else who benefits from them.

# Contents

* [Exceptions](./src/charmed_kubeflow_chisme/exceptions/README.md): A collection of standard Exceptions for use when writing charms.
* [Kubernetes](./src/charmed_kubeflow_chisme/kubernetes/README.md): Helpers for interacting with Kubernetes
* [Lightkube](./src/charmed_kubeflow_chisme/lightkube/README.md): Helpers specific to using or extending [Lightkube](lightkube-rtd)
* [Pebble](./src/charmed_kubeflow_chisme/pebble/README.md): Helpers for managing pebble when writing charms
* [Reusable Charm Components](./src/charmed_kubeflow_chisme/components/README.md): The `Component` abstraction that encapsulates any piece of logic for a Charm, a reusable reconcile function `CharmReconciler` that executes `Components`, and a collection of `Components` for things like running Pebble containers or deploying Kubernetes resources
* [Rock](./src/charmed_kubeflow_chisme/README.md): Utilities for testing rocks
* [Status Handling](./src/charmed_kubeflow_chisme/status_handling/README.md): Helpers for working with Charm Status objects
* [Testing](./src/charmed_kubeflow_chisme/testing/README.md): Utilities for testing Charms
* [Types](./src/charmed_kubeflow_chisme/types/README.md): Reusable typing definitions, useful for adding type hints

[ckf]: https://charmed-kubeflow.io/
[lightkube-rtd]: https://lightkube.readthedocs.io/en/latest/

# Publishing to PyPi

To publish a new release to Pypi:
1. Update [setup.cfg](https://github.com/canonical/charmed-kubeflow-chisme/blob/main/setup.cfg#L3) to the new version 
   and commit it to the repo via a completed PR
2. Apply local git tag according to the format `X.X.X` (semantic versioning) on the main branch
3. Push tag to the repo. Example: `git push origin 0.0.8`
4. GitHub Action will create a new release on GitHub
5. Edit release via GitHub UI and click publish
6. GitHub Action will automatically publish the same commit to PyPi repository 
