boostorg / boost-tasks

Various scripts for boost

Boost Update Scripts

Script to handle various Boost tasks, such as:

• Updating the submodules in the super project.
• Updating a mirror of the Boost repositories.
• Fetching the pull request data from GitHub.

Getting started.

These scripts require PHP 5.3 or above (preferably 5.4 or above), and composer.

1. Clone this repo.
2. Install the dependencies using composer install.
3. Create a config.neon configuration file in the 'var' directory, using Neon synatx.

Example configuration file:

# Path to directory where script stores data
# (Paths resolve relative to config file)
data: data

# GitHub login details
# (remember to restrict read permissions).
username: github-username
password: github-password

# Path to directory where website stores data
website-data: /home/www/shared/data

# Set to true to push to github, false when you're testing
push-to-repo: false

# Branches to update (comment out to disable a branch)
superproject-branches:
    develop: develop
    master: master

# Extra configuration files:
config-paths:
    - /home/www/shared/branches.neon

data is the path to the directory that will hold data for this script.

username and password are the GitHub login details for the account that the script will use.

website-data is the path to the website's data folder, where any data generated for the website (currently only the pull request report) is placed. This is optional, if it's absent the data will be written to stdout.

If push-to-repo is true then any git changes made (such as updating the submodules) will be pushed to GitHub. Don't want this to happen when testing the script.

The keys in superproject-branches specifies the branches in the super project to update, the values are the branches to update from.

---

The new script release-from-artifactory requires git version 2.x or higher. Upgrade git with these steps:

sudo apt-get install -y software-properties-common
sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt install -y git

---

More documentation can be found in the docs/ directory of the php7 branch.

The current branches are -

• master - the default branch. Uses php5. This is what ought to be running on the wowbagger server now. Includes artifactory updates.
• php7 - various enhancements to support php7. Parallel development. Contains documentation and example docker images.
• dnljms2020 - a record of the state of the repo in 2020.