Metadata-Version: 2.4
Name: roundtripper
Version: 0.2.0
Summary: Roundtripping with Confluence
Project-URL: Documentation, https://github.com/holtgrewe/roundtripper
Project-URL: Issues, https://github.com/holtgrewe/roundtripper/issues
Project-URL: Source, https://github.com/holtgrewe/roundtripper
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: atlassian-python-api>=3.41.0
Requires-Dist: cyclopts>=4.4.4
Requires-Dist: httpx>=0.28.1
Requires-Dist: jmespath>=1.0.1
Requires-Dist: pydantic-settings>=2.7.0
Requires-Dist: pydantic>=2.10.6
Requires-Dist: questionary>=2.0.1
Requires-Dist: rich>=13.9.4
Requires-Dist: tqdm>=4.66.0
Description-Content-Type: text/markdown

# roundtripper

Roundtripping with Confluence

## Setup

Setup Python with uv

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
uv python install 3.13
```

Clone the repository

```bash
git clone https://github.com/mholtgrewe/roundtripper.git
```

Run Tests

```bash
cd roundtripper
uv sync --group dev
make test
```

## Development

### Check Code Quality

```bash
make check
```

### Format Code

```bash
make fix
```

### Run Tests

```bash
make test
```

### Update Dependencies

```bash
make lock
```

## Usage

```bash
roundtripper --help
```

### Configure Confluence

Configure your Confluence credentials and connection settings:

```bash
roundtripper confluence config
```

This will open an interactive configuration menu. Configuration is stored in `~/.config/roundtripper/config.json` following the XDG Base Directory specification.

To view your current configuration:

```bash
roundtripper confluence config --show
```

To jump directly to a specific configuration section:

```bash
roundtripper confluence config --jump-to auth.confluence
```

## Acknowledgments

This project includes code adapted from [confluence-markdown-exporter](https://github.com/Spenhouet/confluence-markdown-exporter) by Sebastian Penhouet.
