Release 10.0.0

[thinkh]

Release notes

• Added loginMenu to properties of ATDPApplication Added loginMenu to properties of ATDPApplication #333
• Added extension point to manage database migrations Added extension point to manage database migrations #292
• Migrate to jest for testing Migrate to jest for testing #299
• Avoid raising an exception in DBMigrationManager Avoid raising an exception in DBMigrationManager #340
• Make LineUp v4 RegExp filter serialization backwards compatible Make LineUp v4 RegExp filter serialization backwards compatible #345
• Ignore live preview events Ignore live preview events #351
• Fix overlapping entries in add column dialog Fix overlapping entries in add column dialog #355
• Fix LineUp CMD bug Fix LineUp CMD bug #358
• Change the overflow of the SidePanel to be compatible with lineup-v4 Change the overflow of the SidePanel to be compatible with lineup-v4 #356
• Fix typos in locale file Fix typos in locale file #360
• Update author name Update author name #362
• Update README.md circleci links & logo Update README.md circleci links & logo #363
• Fix group height in overview mode Fix group height in overview mode #366
• Support for multiple database migrations Support for multiple database migrations #368
• Update README.md Update README.md #369
• Call itemRowHeight function also for groups Call itemRowHeight function also for groups #376
• Added listener to ADD_DESC to update side panel options Added listener to ADD_DESC to update side panel options #375
• Avoid deleting the HTML node when destroying ViewWrapper instance and set visible state correctly Avoid deleting the HTML node when destroying ViewWrapper instance and set visible state correctly #337
• Fix truncated select2 and select3 placholder Fix truncated select2 and select3 placholder #382
• Use data values instead of formulas for XSLX files Use data values instead of formulas for XSLX files #384
• Persist expand/collapse state for aggregated groups in the provenance graph Persist expand/collapse state for aggregated groups in the provenance graph #380
• Track in provenance graph thegroupingChanged LineUp event Track in provenance graph thegroupingChanged LineUp event #385
• Add missing spaces in tdp locale Add missing spaces in tdp locale #388
• Disable propagation of aggregation state for child groups in ARankingView Disable propagation of aggregation state for child groups in ARankingView #387
• Derive set column categories automatically Derive set column categories automatically #353
• Fix numbers as text in Excel download Fix numbers as text in Excel download #391
• ProxyView: Entity selection and external link swapped ProxyView: Entity selection and external link swapped #393
• RankingView: Increase z-index of overview button on hover RankingView: Increase z-index of overview button on hover #395
• Improve tour documentation and add doubleClick and submitForm helper Improve tour documentation and add doubleClick and submitForm helper #398
• Remove unused date column check Remove unused date column check #397
• Changed CSS selector for main LineUp ranking Changed CSS selector for main LineUp ranking #402
• Merge the two different versions of _view_lineup.scss Merge the two different versions of _view_lineup.scss #403
• Re-add missing select2 placeholder of PR Fix truncated select2 and select3 placholder #382 Re-add missing select2 placeholder of PR #382 #404
• Fix position of the overview warning message Fix position of the overview warning message #405

Checklists

Release preparation

• Create new release-x.x.x branch (based on develop branch)
• Collect changes and write release notes
• Draft release PR in GitHub that merges the release-x.x.x into the master branch

Release dependencies first

In case of dependent Phovea/TDP repositories follow dependency tree from the top:

• Release dependent repositories if they contain changes first before proceeding here
• Replace git dependencies in package.json with new version range (e.g., "phovea_core": "^2.3.1" when published on npm or "phovea_core": "github:datavisyn/tdp_core#semver:^8.0.0" for non-published repositories)
• Replace git dependencies in requirements.txt with new version range (e.g., phovea_server>=2.3.0,<3.0.0 when published on pipy or -e git+https://github.com/datavisyn/tdp_core.git@v8.0.0#egg=tdp_core for non-published repositories)
• Commit and push new dependencies
• Wait until build is successful
• Repeat with other repositories/dependencies or proceed with next section

Update version

• Check version numbers of dependencies again
• Check if build is successful
• Update this version number following semver
• Commit and push package.json with new version number
• Assign reviewer and wait for final review
• Merge this pull request into master branch
• Add release label (i.e., release: major, release: minor, or release: patch)

Publish pip release

The steps of this section are only necessary if the code is public and should be published to the pypi registry.

• chmod -R o+w . in the cloned repository directory (to provide write access to the CircleCI Linux user)
• rm -rf dist && rm -rf build
• docker run -it -v $(pwd):/phovea circleci/python:3.7-buster-node-browsers /bin/bash and continue inside the container
• cd /phovea
• sudo pip install -r requirements.txt && sudo pip install -r requirements_dev.txt && sudo pip install twine
• npm run dist:python
• Ensure only two files are in the dist directory (*.whl and *.tar.gz)
• Ensure that both files contain the new version number
• twine upload --repository-url https://upload.pypi.org/legacy/ dist/*
• Login with caleydo-bot
• Check release on pipy.org

Publish npm release

The steps of this section are only necessary if the code is public and should be published to the npm registry.

• chmod -R o+w . in the cloned repository directory (to provide write access to the CircleCI Linux user)
• rm -rf dist && rm -rf build && rm -rf node_modules/ && rm -rf package-lock.json
• docker run -it -v $(pwd):/phovea circleci/node:12.13-buster-browsers /bin/bash and continue inside the container
• cd /phovea
• npm install
• npm run build:web to build the bundles
• npm login as caleydo-bot
• npm publish
• Check release on npmjs.com

Create GitHub release

• Draft a new release (Code -> Releases -> Draft a new release)
• Use new version number as tag (e.g., v2.3.1)
• Copy release notes
• Publish release

Prepeare next develop release

• Switch to develop branch
• Merge master branch into develop (git merge origin/master)
• Update version in package.json to <next patch version>-SNAPSHOT (e.g., 2.3.1 to 2.3.2-SNAPSHOT)
• Revert dependencies in package.json to develop branches (e.g., "phovea_core": "github:phovea/phovea_core#develop")
• Revert dependencies in requirements.txt to develop branches (e.g., -e git+https://github.com/phovea/phovea_server.git@develop#egg=phovea_server)
• Commit and push changes

🏁 Finish line

• Inform colleagues and customers about the release
• Celebrate the new release 🥳