Automate jobs board with schema validation #360
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
|
|
@@ -24,6 +24,17 @@ repos: | |||||
| - id: ruff | ||||||
| args: ["--fix", "--show-fixes"] | ||||||
|
|
||||||
| # Jobs board validation (schema-based) | ||||||
| - repo: https://github.com/python-jsonschema/check-jsonschema | ||||||
| rev: 0.33.3 | ||||||
|
||||||
| rev: 0.33.3 | |
| rev: 0.36.0 |
Is there a reason for using 0.33.3 instead of the latest release available? https://github.com/python-jsonschema/check-jsonschema
There was a problem hiding this comment.
addressed, used the latest version
|
Member
There was a problem hiding this comment. It looks like the code in this file was generated with AI. While we are okay with the use of AI-written code, we consider it your responsibility to thoroughly review it and address any potential mistakes. Could you please remove the comments indicative of AI and remove the redundant CSS rules from here? Also, these styles will apply to the entire website, so we must ensure that they affect only the jobs page.
Contributor
Author
There was a problem hiding this comment. addressed and applied the requested clean up and scoping |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,10 +4,14 @@ title: "PyBaMM" # site title | |
| theme: scientific-python-hugo-theme | ||
| relativeURLs: true | ||
| DefaultContentLanguage: en | ||
| disableKinds: ["term", "taxonomy", "404"] | ||
| enableEmoji: true | ||
| enableInlineShortcodes: true | ||
|
|
||
| # Suppress legacy GetJSON errors originating from theme code | ||
| ignoreLogs: | ||
| - error-remote-getjson | ||
|
|
||
|
||
| markup: | ||
| highlight: | ||
| noClasses: true | ||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -4,34 +4,13 @@ shortcutDepth: 0 | |
| summary: "Current job openings related to PyBaMM and battery modeling" | ||
| --- | ||
|
|
||
| Welcome to the PyBaMM Jobs Board! This page is generated from simple YAML files under data/jobs/. | ||
|
||
|
|
||
| {{< admonition tip >}} | ||
| To post a job, open a PR adding a file under data/jobs/ using the template at data/jobs/_TEMPLATE.yaml. See instructions below. | ||
| {{< /admonition >}} | ||
|
|
||
| {{< jobs-list >}} | ||
|
|
||
| --- | ||
|
|
||
|
|
@@ -48,13 +27,14 @@ Do you have an open position in battery modeling or simulation? By posting in th | |
| - Increase visibility within the PyBaMM community and broader battery modeling ecosystem | ||
| - Support the open-source PyBaMM project and its community | ||
|
|
||
| Jobs can be posted by companies, research institutions, or individuals looking to hire for positions related to battery modeling and simulation. | ||
|
|
||
| ### How to Post a Job | ||
|
|
||
| 1. Open a pull request adding a YAML file at data/jobs/ following data/jobs/_TEMPLATE.yaml. | ||
| 2. Ensure dates are in YYYY-MM-DD and include a working https:// or http:// URL. | ||
| 3. Optionally, also [email us](mailto:pybamm@pybamm.org) for visibility. | ||
| 4. If applicable, make a payment or donation as per our policy. | ||
|
||
|
|
||
| {{< admonition important >}} | ||
| For details, please review our [Terms & Conditions](/jobs-t-and-c/). | ||
|
|
||
|
Member
There was a problem hiding this comment. Let's use the existing Ionworks example here and include it, instead of Example Company.
Contributor
Author
There was a problem hiding this comment. addressed, replaced the example with Ionworks example |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,20 @@ | ||
| entity: Example Company | ||
| title: Battery Modeling Engineer (PyBaMM) | ||
| url: https://example.com/careers/battery-modeling-engineer-pybamm | ||
| percentTime: 100 | ||
| percentOSS: 50 | ||
| deadline: 2026-01-31 | ||
| expires: 2026-02-28 | ||
| location: Remote | ||
| tags: [full-time, modeling, PyBaMM, Python] | ||
| description: | | ||
| We are hiring a Battery Modeling Engineer to build physics-based models using PyBaMM. | ||
|
|
||
| Responsibilities: | ||
| - Develop and validate battery models using PyBaMM | ||
| - Support model parameterisation, simulation, and analysis | ||
| - Contribute improvements back to PyBaMM where appropriate | ||
|
|
||
| Requirements: | ||
| - Strong Python experience | ||
| - Familiarity with battery modelling and numerical methods |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,70 @@ | ||
| { | ||
| "$schema": "https://json-schema.org/draft/2020-12/schema", | ||
| "title": "PyBaMM Jobs Board Posting", | ||
| "type": "object", | ||
| "additionalProperties": false, | ||
| "required": [ | ||
| "entity", | ||
| "title", | ||
| "url", | ||
| "percentTime", | ||
| "percentOSS", | ||
| "deadline", | ||
| "expires", | ||
| "location", | ||
| "description" | ||
| ], | ||
| "properties": { | ||
| "entity": { | ||
| "type": "string", | ||
| "minLength": 1 | ||
| }, | ||
| "title": { | ||
| "type": "string", | ||
| "minLength": 1 | ||
| }, | ||
| "url": { | ||
| "type": "string", | ||
| "minLength": 1, | ||
| "pattern": "^https?://" | ||
| }, | ||
| "percentTime": { | ||
| "type": "integer", | ||
| "minimum": 1, | ||
| "maximum": 100 | ||
| }, | ||
| "percentOSS": { | ||
| "type": "integer", | ||
| "minimum": 0, | ||
| "maximum": 100 | ||
| }, | ||
| "deadline": { | ||
| "type": "string", | ||
| "pattern": "^\\d{4}-\\d{2}-\\d{2}$" | ||
| }, | ||
| "expires": { | ||
| "type": "string", | ||
| "pattern": "^\\d{4}-\\d{2}-\\d{2}$" | ||
| }, | ||
| "author_date": { | ||
| "type": "string", | ||
| "pattern": "^\\d{4}-\\d{2}-\\d{2}$" | ||
| }, | ||
| "location": { | ||
| "type": "string", | ||
| "minLength": 1 | ||
| }, | ||
| "tags": { | ||
| "type": "array", | ||
| "items": { | ||
| "type": "string", | ||
| "minLength": 1 | ||
| }, | ||
| "uniqueItems": true | ||
| }, | ||
| "description": { | ||
| "type": "string", | ||
| "minLength": 1 | ||
| } | ||
| } | ||
| } |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,29 @@ | ||
| {{/* Renders a single job card. Expects dict with keys: job, now */}} | ||
| {{- $job := .job -}} | ||
| {{- $now := .now -}} | ||
| {{- $open := or (not $job.expires) (ge (time $job.expires) $now) -}} | ||
|
|
||
| <div class="job-card {{ if not $open }}job-card--archived{{ end }}"> | ||
| <div class="job-card__header"> | ||
| <h3 class="job-card__title">{{ $job.title }}</h3> | ||
| <div class="job-card__entity">{{ $job.entity }}</div> | ||
| </div> | ||
| <div class="job-card__meta"> | ||
| {{ with $job.location }}<span class="job-badge job-badge--location">{{ . }}</span>{{ end }} | ||
| {{ with $job.percentTime }}<span class="job-badge">{{ . }}% time</span>{{ end }} | ||
| {{ with $job.percentOSS }}<span class="job-badge">{{ . }}% OSS</span>{{ end }} | ||
| {{ with $job.tags }} | ||
| {{ range . }}<span class="job-badge job-badge--tag">{{ . }}</span>{{ end }} | ||
| {{ end }} | ||
| </div> | ||
| <div class="job-card__dates"> | ||
| {{ with $job.deadline }}<span>Deadline: {{ . }}</span>{{ end }} | ||
| {{ with $job.expires }}<span>Visible until: {{ . }}</span>{{ end }} | ||
| </div> | ||
| <div class="job-card__description"> | ||
| {{ with $job.description }}{{ . | markdownify }}{{ end }} | ||
| </div> | ||
| {{ with $job.url }} | ||
| <p class="job-card__apply"><a class="button" href="{{ . }}" rel="nofollow noopener" target="_blank">Apply / Learn more</a></p> | ||
| {{ end }} | ||
| </div> |
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,57 @@ | ||
| {{/* | ||
| Lists jobs from data/jobs. Splits into open and archived by expires date. | ||
| Sorts open by deadline asc; archived by expires desc. | ||
| */}} | ||
| {{- $now := now -}} | ||
| {{- $jobs := slice -}} | ||
|
|
||
| {{/* | ||
| Load only YAML postings from data/jobs/*.yaml. | ||
| Avoid reading data/jobs/schema.json (used only for validation). | ||
| */}} | ||
|
||
| {{- range (readDir "data/jobs") -}} | ||
| {{- if and (not .IsDir) (hasSuffix .Name ".yaml") (ne .Name "_TEMPLATE.yaml") -}} | ||
| {{- $path := printf "data/jobs/%s" .Name -}} | ||
| {{- $data := (readFile $path | transform.Unmarshal) -}} | ||
| {{- $key := replaceRE "\\.yaml$" "" .Name -}} | ||
| {{- $job := dict "key" $key | merge $data -}} | ||
| {{- $jobs = $jobs | append $job -}} | ||
| {{- end -}} | ||
| {{- end -}} | ||
|
|
||
| {{/* partition */}} | ||
| {{- $open := slice -}} | ||
| {{- $archived := slice -}} | ||
| {{- range $jobs -}} | ||
| {{- $exp := .expires -}} | ||
| {{- if or (not $exp) (ge (time $exp) $now) -}} | ||
| {{- $open = $open | append . -}} | ||
| {{- else -}} | ||
| {{- $archived = $archived | append . -}} | ||
| {{- end -}} | ||
| {{- end -}} | ||
|
Comment on lines
9
to
29
Member
There was a problem hiding this comment. I think this can be simplified – see https://stackoverflow.com/a/33233395 for an example?
Contributor
Author
There was a problem hiding this comment. addressed. refactored the layouts/partials/jobs/list.html to simplify data loading using hugo’s built-in data mechanism, per the review suggestion |
||
|
|
||
| {{- $sortedOpen := sort $open "deadline" "asc" -}} | ||
|
|
||
| <h2 id="open-roles">Open roles</h2> | ||
| {{- if gt (len $sortedOpen) 0 -}} | ||
| {{- range $sortedOpen -}} | ||
| {{ partial "jobs/card.html" (dict "job" . "now" $now) }} | ||
| {{- end -}} | ||
| {{- else -}} | ||
| <p>No open roles at the moment.</p> | ||
| {{- end -}} | ||
|
|
||
| <hr/> | ||
|
|
||
| <details> | ||
| <summary><h2 id="archived-roles" style="display:inline">Archived roles</h2></summary> | ||
| {{- $sortedArchived := sort $archived "expires" "desc" -}} | ||
| {{- if gt (len $sortedArchived) 0 -}} | ||
| {{- range $sortedArchived -}} | ||
| {{ partial "jobs/card.html" (dict "job" . "now" $now) }} | ||
| {{- end -}} | ||
| {{- else -}} | ||
| <p>No archived roles yet.</p> | ||
| {{- end -}} | ||
| </details> | ||
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,2 @@ | ||
| {{/* Shortcode to render the jobs list from data/jobs */}} | ||
| {{ partial "jobs/list.html" . }} |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The code is self-explanatory, so this doesn't need a comment