Metadata-Version: 2.4
Name: toolforge-replica-cnf
Version: 0.1.1
Summary: Thin API to handle replica credentials on toolforge and paws.
License-Expression: Apache-2.0
License-File: LICENSE
Author: David CAro
Author-email: dcaro@wikimedia.org
Requires-Python: >=3.13,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Requires-Dist: flask (>=3.1.3,<4.0.0)
Requires-Dist: jinja2 (>=3.1.6,<4.0.0)
Requires-Dist: ldap3 (==2.8.1)
Requires-Dist: markupsafe (>=3.0.4,<4.0.0)
Requires-Dist: pymysql (>=1.2.3,<2.0.0)
Requires-Dist: pyyaml (>=6.0.3,<7.0.0)
Requires-Dist: requests (>=2.34.2,<3.0.0)
Requires-Dist: toolforge-weld (>=1.6.15,<2.0.0)
Description-Content-Type: text/markdown

# This REST API service is used to manage toolforge replica.my.cnf.

It decouples the functionality of reading and writing replica.my.cnf files away from this repository and into its server environment.


## Local development environment (guideline)

### Requirements

You need to have [Poetry](https://github.com/python-poetry/poetry) installed
globally. Follow the official instructions here:
<https://python-poetry.org/docs/master#installation>

### Testing with tox on debian

Clone the repo (instructions here
<https://gitlab.wikimedia.org/repos/cloud/toolforge/replica-cnf>).

Install tox (this is the only debian-specific part):

```bash
~:$ apt install tox
```

Or, you can install tox with pipx (recommended) if you prefer.

Move to the directory where you cloned the repo, and run tox:

```bash
/path/to/repo/replica-cnf:$ tox
```

That will run the tests and create a virtualenv that you can use to manually
debug anything you need, to enter it:

```bash
/path/to/repo/replica-cnf:$ source .tox/py3-unit/bin/activate
```

## Deployment

This package follows the standard procedure outlined here:

https://wikitech.wikimedia.org/wiki/Portal:Toolforge/Admin/Packaging#Using_existing_automation

## License

This project is licensed under Apache 2.0 License. See the LICENSE file for details.

