prepare for tagging

Author: d-led

.github/workflows/publish-conan.yml

@@ -0,0 +1,70 @@
+name: Publish to Conan Center
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+    
+    - name: Extract version from tag
+      id: version
+      run: |
+        VERSION=${GITHUB_REF#refs/tags/v}
+        echo "version=${VERSION}" >> $GITHUB_OUTPUT
+        echo "Tag: ${GITHUB_REF}, Version: ${VERSION}"
+    
+    - name: Setup Git
+      run: |
+        git config --global user.name "github-actions[bot]"
+        git config --global user.email "github-actions[bot]@users.noreply.github.com"
+    
+    - name: Checkout conan-center-index
+      uses: actions/checkout@v4
+      with:
+        repository: d-led/conan-center-index
+        path: conan-center-index
+        token: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Setup conan-center-index upstream
+      working-directory: conan-center-index
+      run: |
+        git remote add upstream https://github.com/conan-io/conan-center-index.git || true
+        git fetch upstream master
+        git checkout master || git checkout -b master
+        git merge upstream/master || true
+    
+    - name: Install GitHub CLI
+      run: |
+        type -p curl >/dev/null || (apt update && apt install curl -y)
+        curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \
+        && chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg \
+        && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
+        && apt update \
+        && apt install gh -y
+    
+    - name: Authenticate GitHub CLI
+      run: |
+        echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token
+    
+    - name: Publish to Conan Center
+      env:
+        GITHUB_REPO: d-led/influxdb-cpp-rest
+        CONAN_INDEX_FORK: d-led/conan-center-index
+        CONAN_INDEX_UPSTREAM: conan-io/conan-center-index
+        CONAN_INDEX_DIR: ${{ github.workspace }}/conan-center-index
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+      run: |
+        ./scripts/publish-conan-version.sh "${{ steps.version.outputs.version }}"
+

docs/development.md

@@ -158,66 +158,97 @@ These bundled dependencies may be migrated to Conan in the future.
 
 ## Publishing to Conan Center
 
-### Prerequisites
+The package is published to [Conan Center](https://conan.io/center) via pull requests to the [conan-center-index](https://github.com/conan-io/conan-center-index) repository. The recipe is maintained at `recipes/influxdb-cpp-rest/` in that repository.
 
-1. Conan 2.0+
-2. Conan account at https://conan.io/
-3. GitHub repository (public)
+### Initial Setup (One-time)
 
-### Publishing Steps
+1. Fork https://github.com/conan-io/conan-center-index
+2. Clone your fork locally
+3. Set upstream remote: `git remote add upstream https://github.com/conan-io/conan-center-index.git`
 
-1. **Update version in conanfile.py**
+### Publishing a New Version
 
-   Update the `version` field in `conanfile.py`:
-   ```python
-   version = "1.0.0"  # or your new version
-   ```
-
-2. **Create Conan recipe (if not exists)**
+Use the automated script (recommended):
 
-   The `conanfile.py` should export all necessary files and define requirements.
+```bash
+./scripts/publish-conan-version.sh 1.0.0
+```
 
-3. **Test the recipe locally**
+Or manually:
 
+1. **Create a GitHub release/tag** for the version (if not already exists)
+2. **Navigate to conan-center-index repository**:
    ```bash
-   conan create . --version 1.0.0
+   cd ../conan-center-index  # or wherever you cloned it
+   git checkout master
+   git pull upstream master
    ```
-
-   Test with different configurations:
+3. **Create version branch**:
+   ```bash
+   git checkout -b recipes/influxdb-cpp-rest/X.Y.Z
+   ```
+4. **Create recipe directory and files**:
    ```bash
-   conan create . --version 1.0.0 -s compiler=gcc -s compiler.version=11
-   conan create . --version 1.0.0 -s compiler=clang -s compiler.version=14
+   mkdir -p recipes/influxdb-cpp-rest/X.Y.Z
+   # Copy conanfile.py template and adapt for conan-center-index format
+   # Create conandata.yml with source URL and SHA256
+   ```
+5. **Commit and push**:
+   ```bash
+   git add recipes/influxdb-cpp-rest/X.Y.Z/
+   git commit -m "Add influxdb-cpp-rest/X.Y.Z"
+   git push origin recipes/influxdb-cpp-rest/X.Y.Z
+   ```
+6. **Create pull request**:
+   ```bash
+   gh pr create --repo conan-io/conan-center-index --title "Add influxdb-cpp-rest/X.Y.Z"
    ```
 
-4. **Export recipe**
+See [Publishing New Versions](#publishing-new-versions) section below for details.
 
+## Publishing New Versions
+
+When releasing a new version of influxdb-cpp-rest:
+
+1. **Create and push a Git tag** (e.g., `v1.0.0`):
    ```bash
-   conan export . --version 1.0.0
+   ./scripts/tag-version.sh patch  # or major/minor
+   git push --tags
    ```
 
-5. **Upload to Conan Center**
+2. **Automatic publishing**: Pushing a tag starting with `v` (e.g., `v1.0.0`) automatically triggers the GitHub Actions workflow that:
+   - Calculates the SHA256 hash of the source tarball
+   - Creates the recipe files in the correct format
+   - Commits and pushes to your conan-center-index fork
+   - Creates a pull request to conan-center-index
 
-   First, create a pull request to Conan Center Index:
-   
-   - Fork https://github.com/conan-io/conan-center-index
-   - Create branch: `recipes/influxdb-cpp-rest/x.y.z` (where x.y.z is version)
-   - Copy your `conanfile.py` to `recipes/influxdb-cpp-rest/x.y.z/conanfile.py`
-   - Add recipe files to the index repository
-   - Open a pull request
+3. **Monitor the PR**: The Conan Center CI will automatically test the recipe. Address any review comments or CI failures.
 
-   The Conan Center team will review and merge your recipe.
+### Manual Publishing (Alternative)
 
-6. **Alternative: Upload to your own remote**
+If you need to publish manually or the automated workflow fails:
 
-   If you want to publish to your own Conan remote:
-   
-   ```bash
-   # Add your remote
-   conan remote add myremote https://your-conan-server.com
-   
-   # Upload
-   conan upload influxdb-cpp-rest/1.0.0 -r myremote --all
-   ```
+```bash
+./scripts/publish-conan-version.sh 1.0.0
+```
+
+This script will:
+- Clone/update your conan-center-index fork if needed
+- Calculate the SHA256 hash of the source tarball
+- Create the recipe files in the correct format
+- Commit and push the changes
+- Create a pull request to conan-center-index
+
+### Recipe Format for Conan Center
+
+The recipe in conan-center-index differs from the local `conanfile.py`:
+
+- **No `version` field** - version comes from directory path
+- **`source()` method** - downloads from GitHub release/tag
+- **`conandata.yml`** - contains source URL and SHA256 checksum
+- **No `exports_sources`** - source is downloaded, not exported
+
+The automation script handles these differences automatically.
 
 ### Conan Recipe Checklist
 
@@ -229,13 +260,24 @@ These bundled dependencies may be migrated to Conan in the future.
 - [ ] Compatible with major compilers (GCC, Clang, MSVC)
 - [ ] Works on Linux, macOS, Windows
 
+### Testing Locally
+
+Before publishing, test the recipe locally:
+
+```bash
+# In your conan-center-index fork
+cd recipes/influxdb-cpp-rest/1.0.0
+conan create . influxdb-cpp-rest/1.0.0@
+```
+
 ### Conan Center Requirements
 
 - Recipe must be in conan-center-index repository
 - Must pass automated CI checks
 - All dependencies must also be in Conan Center
 - License must be compatible with Conan Center
 - Source code must be publicly accessible
+- GitHub tag/release must exist for the version
 
 ### Versioning