Schedule meetings via a GitHub Action. Creates issues based on a schedule and template.
This repository is managed by the Package Maintenance Working Group, see Governance.
name: Schedule team meetings
on:
schedule:
- cron: '0 0 * * * *'
jobs:
build:
runs-on: ubuntu-latest
steps:
- uses: pkgjs/meet@v0
with:
token: ${{ secrets.GITHUB_TOKEN }}
schedules: 2020-04-02T17:00:00.0Z/P1D
The meeting schedule, issue, etc can be configured with inouts to this action.
token
: (required) The token from the action for calling to the GitHub API.schedules
: (required) The ISO-8601 interval for the schedule. Default: ${now/P7D}
seven days from nowcreateWithin
: (required) The ISO-8601 duration for how soon before the meeting to create the issue. Default P7D
meetingLabels
: The labels to apply to issues generated by this GitHub Action for meetings. Default: meeting
agendaLabel
: Label to pull the agenda from. Default: meeting-agenda
issueTitle
: Template string for issue title. Default: Meeting <%= date.toFormat('yyyy-MM-dd') %>
issueTemplate
: The name of the issue template found in .github/ISSUE_TEMPLATE
. Default: meeting.md
The default issue template can be seen in the ISSUE_TEMPLATES directory, as meeting.md. Additionally, you can find example issues of the latest version via the closed issues that are the result of CI tests.
Our default template is based off of the Node.js project's practices around meetings, but changes and enhancements are welcome.
If you don't want to use the default issue template, you can use a custom issue template by passing in the file name of it (presuming it lives in ISSUE_TEMPLATES).
You can use both our shorthand and JavaScript in your meeting templates.
We provide some shorthand that you can use in your meeting templates. We'll automatically replace the shorthand with the relevant dynamic information.
<!-- title -->
<!-- agenda label -->
<!-- invitees -->
<!-- observers -->
If you'd like to see more shorthand available, we absolutely welcome PRs.
You can include custom JavaScript in your custom meeting templates. We use ejs, so anything within an ejs tag will be parsed as JavaScript.
The main logic of the module is also published to npm.
$ npm i @pkgjs/meet
const maker = require('@pkgjs/meet')
;(async () => {
const issue = await maker.meetings.createNextMeeting(client, {
owner: 'pkgjs',
repo: 'meet',
schedules: []
})
console.log(issue) // the response from the GitHub api creating the issue
})()
This package welcomes contributions. While the basic unit tests are runnable
(npm t
) Unfortunatly because it is requires access to the GitHub api it means
you need to have a token with access to create the issues as part of the
integration tests. To specify the key you need to create a personal access token
and put it in a .env
file as GITHUB_TOKEN=<TOKEN>
. Then you can run
npm run test:integration
to run the main integration tests. To be honest this
should probably be configurable, contributions welcome.