Merge pull request #2472 from jorisv/topic/new_version_task

Add a task to easily release a new EigenPy version

.github/workflows/linux.yml

@@ -12,6 +12,7 @@ on:
       - colcon.pkg
       - .pre-commit-config.yaml
       - CHANGELOG.md
+      - development/*.md
   pull_request:
     paths-ignore:
       - doc/**
@@ -23,6 +24,7 @@ on:
       - colcon.pkg
       - .pre-commit-config.yaml
       - CHANGELOG.md
+      - development/*.md
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true

.github/workflows/macos-linux-windows-pixi.yml

@@ -14,6 +14,7 @@ on:
       - colcon.pkg
       - .pre-commit-config.yaml
       - CHANGELOG.md
+      - development/*.md
   pull_request:
     paths-ignore:
       - doc/**
@@ -25,6 +26,7 @@ on:
       - colcon.pkg
       - .pre-commit-config.yaml
       - CHANGELOG.md
+      - development/*.md
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true

.github/workflows/nix.yml

@@ -2,6 +2,15 @@ name: "CI - Nix"
 
 on:
   push:
+    paths-ignore:
+      - doc/**
+      - .gitlab-ci.yml
+      - .gitignore
+      - '*.md'
+      - CITATION.*
+      - COPYING.LESSER
+      - .pre-commit-config.yaml
+      - CHANGELOG.md
 
 jobs:
   nix:

.github/workflows/ros-ci.yml

@@ -13,8 +13,10 @@ on:
       - '*.md'
       - CITATION.*
       - COPYING.LESSER
+      - colcon.pkg
       - .pre-commit-config.yaml
       - CHANGELOG.md
+      - development/*.md
   pull_request:
     paths-ignore:
       - doc/**
@@ -23,8 +25,10 @@ on:
       - '*.md'
       - CITATION.*
       - COPYING.LESSER
+      - colcon.pkg
       - .pre-commit-config.yaml
       - CHANGELOG.md
+      - development/*.md
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true

.github/workflows/update_pixi_lockfile.yml

@@ -45,6 +45,8 @@ jobs:
           body-path: diff.md
           branch: topic/update-pixi
           base: devel
-          labels: pixi
+          labels: |
+            pixi
+            no changelog
           delete-branch: true
           add-paths: pixi.lock

.gitignore

@@ -1,4 +1,4 @@
-build*
+build*/
 Xcode*
 *~
 *.pyc

README.md

@@ -156,7 +156,13 @@ The [master branch](https://github.com/stack-of-tasks/pinocchio/tree/master/) on
 
 **Pinocchio** can be easily installed on various Linux (Ubuntu, Fedora, etc.) and Unix distributions (Mac OS X, BSD, etc.). Please refer to the [installation procedure](http://stack-of-tasks.github.io/pinocchio/download.html).
 
-If you only need the Python bindings of Pinocchio, you may prefer to install it through [Conda](https://docs.conda.io/en/latest/). Please follow the procedure described [here](https://github.com/conda-forge/pinocchio-feedstock#installing-pinocchio).
+### Conda
+
+You simply need this simple line:
+
+```bash
+conda install pinocchio -c conda-forge
+```
 
 ### ROS
 
@@ -190,23 +196,6 @@ Please note that we always advise including the `pinocchio/fwd.hpp` header as th
 |             |                                                                                                                                                                            |      | **Humble**   | [![](https://build.ros2.org/job/Hbin_uJ64__pinocchio__ubuntu_jammy_amd64__binary/badge/icon)](https://build.ros2.org/job/Hbin_uJ64__pinocchio__ubuntu_jammy_amd64__binary) |
 |             |                                                                                                                                                                            |      | **Rolling**  | [![](https://build.ros2.org/job/Rbin_uJ64__pinocchio__ubuntu_jammy_amd64__binary/badge/icon)](https://build.ros2.org/job/Rbin_uJ64__pinocchio__ubuntu_jammy_amd64__binary) |
 
-## Build/install from source with Pixi
-
-To build **Pinocchio** from source the easiest way is to use [Pixi](https://pixi.sh/latest/#installation).
-
-[Pixi](https://pixi.sh/latest/) is a cross-platform package management tool for developers that
-will install all required dependencies in `.pixi` directory.
-It's used by our CI agent so you have the guarantee to get the right dependencies.
-
-Run the following command to install dependencies, configure, build and test the project:
-
-```bash
-pixi run test
-```
-
-The project will be built in the `build` directory.
-You can run `pixi shell` and build the project with `cmake` and `ninja` manually.
-
 ## Visualization
 
 **Pinocchio** provides support for many open-source and free visualizers:

development/build.md

@@ -0,0 +1,16 @@
+# Build and install from source with Pixi
+
+To build **Pinocchio** from source the easiest way is to use [Pixi](https://pixi.sh/latest/#installation).
+
+[Pixi](https://pixi.sh/latest/) is a cross-platform package management tool for developers that
+will install all required dependencies in `.pixi` directory.
+It's used by our CI agent so you have the guarantee to get the right dependencies.
+
+Run the following command to install dependencies, configure, build and test the project:
+
+```bash
+pixi run test
+```
+
+The project will be built in the `build` directory.
+You can run `pixi shell` and build the project with `cmake` and `ninja` manually.

development/release.md

@@ -0,0 +1,34 @@
+# Release with Pixi
+
+To create a release with Pixi run the following commands on the **devel** branch:
+
+```bash
+PINOCCHIO_VERSION=X.Y.Z pixi run release_new_version
+git push origin
+git push origin vX.Y.Z
+git push origin devel:master
+```
+
+Where `X.Y.Z` is the new version.
+Be careful to follow the [Semantic Versioning](https://semver.org/spec/v2.0.0.html) rules.
+
+You will find the following assets:
+- `./build_new_version/pinocchio-X.Y.Z.tar.gz`
+- `./build_new_version/pinocchio-X.Y.Z.tar.gz.sig`
+
+Then, create a new release on [GitHub](https://github.com/stack-of-tasks/pinocchio/releases/new) with:
+
+* Tag: vX.Y.Z
+* Title: pinocchio X.Y.Z
+* Body:
+```
+## What's Changed
+
+CHANGELOG CONTENT
+
+**Full Changelog**: https://github.com/stack-of-tasks/pinocchio/compare/vXX.YY.ZZ...vX.Y.Z
+```
+
+Where `XX.YY.ZZ` is the last release version.
+
+Then upload `pinocchio-X.Y.Z.tar.gz` and `pinocchio-X.Y.Z.tar.gz.sig` and publish the release.