macro_traffic_sim 0.1.2

gRPC interface for macroscopic traffic simulation via 4-step demand model
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

## Bump version

Update version in the following files (replace `0.1.2` with the new version):

1. **Rust crate:** `Cargo.toml` -> `version = "0.1.2"`
2. **Python client:** `clients/python/pyproject.toml` -> `version = "0.1.2"`
3. **Go client:** versioned via git tag (see [Git tags](#git-tags--golang-client-tag-for-pkggodev) section below)

## Regenerate clients (if proto files changed)
```bash
# Python
./scripts/gen_python.sh

# Go
./scripts/gen_go.sh
```

## Run tests
```bash
cargo test --features server
```


## Build release binaries
```bash
./scripts/build_release.sh
```

## Publish to crates.io
```bash
cargo publish
```

## Publish python client to PyPI
```bash
cd clients/python

# Activate venv
source .venv/bin/activate

# Install build tools
pip install build twine

# Build package
python -m build

# Upload to PyPI
twine upload dist/*

cd ../..
```

## Build and push Docker images
```bash
# Build
docker build -f Dockerfile.server -t macro-traffic-sim/server:latest .

# Tag for Docker Hub
docker tag macro-traffic-sim/server:latest dimahkiin/macro-traffic-sim-server:0.1.2
docker tag macro-traffic-sim/server:latest dimahkiin/macro-traffic-sim-server:latest

# Tag for GitHub Container Registry
docker tag macro-traffic-sim/server:latest ghcr.io/lddl/macro-traffic-sim-server:0.1.2
docker tag macro-traffic-sim/server:latest ghcr.io/lddl/macro-traffic-sim-server:latest

# Push to Docker Hub
docker push dimahkiin/macro-traffic-sim-server:0.1.2
docker push dimahkiin/macro-traffic-sim-server:latest

# Push to GitHub Container Registry
docker push ghcr.io/lddl/macro-traffic-sim-server:0.1.2
docker push ghcr.io/lddl/macro-traffic-sim-server:latest
```

## Git tags (+ golang client tag for pkg.go.dev)
```bash
# Main repo tag
git tag v0.1.2
git push origin v0.1.2

# Go submodule tag (for pkg.go.dev)
git tag clients/go/v0.1.2
git push origin clients/go/v0.1.2
```

## Verify releases

- **crates.io:** https://crates.io/crates/macro_traffic_sim
- **PyPI:** https://pypi.org/project/macro-traffic-sim/
- **pkg.go.dev:** https://pkg.go.dev/github.com/LdDl/macro_traffic_sim_grpc/clients/go
- **Docker Hub:** https://hub.docker.com/r/dimahkiin/macro-traffic-sim-server/tags
- **GitHub Releases:** https://github.com/LdDl/macro_traffic_sim_grpc/releases