Resume as code: JSON Resume, Typst and CI

resume/validate.mjs

// Checks each file named on the command line against the JSON Resume schema, with the validate() function that the
// @jsonresume/schema package exports (it uses the jsonschema library). Prints every problem with the path of the value
// that broke a rule, and exits with status 1 if any file fails, so a CI step stops there.
//   node validate.mjs resume.json [more.json …]
import { readFileSync } from 'node:fs';
import { createRequire } from 'node:module';

const require = createRequire(import.meta.url);
const resumeSchema = require('@jsonresume/schema');
const { version } = require('@jsonresume/schema/package.json');

// The schema's date pattern is long; its errors name it by where the schema defines it.
const DATE_PATTERN = resumeSchema.schema.definitions.iso8601.pattern;

let failed = 0;
for (const file of process.argv.slice(2)) {
  const resume = JSON.parse(readFileSync(file, 'utf8'));
  resumeSchema.validate(resume, (errors, valid) => {
    if (valid) {
      console.log(`${file} is valid (JSON Resume ${version})`);
      return;
    }
    failed++;
    console.log(`${file}: ${errors.length} problem${errors.length === 1 ? '' : 's'}`);
    for (const e of errors) {
      const path = e.property.replace(/^instance\.?/, '') || '(the whole file)';
      const message = e.message.replace(JSON.stringify(DATE_PATTERN), '#/definitions/iso8601');
      console.log(`  ${path}: ${message}`);
    }
  });
}
process.exitCode = failed ? 1 : 0;

resume/broken.json

{
  "basics": {
    "name": "Asha Verma",
    "label": "Backend engineer",
    "email": "asha.verma(at)example.com",
    "summary": "Backend engineer with three years of Python and PostgreSQL services for a logistics platform, who cuts latency and pages with measured fixes.",
    "location": { "city": "Pune", "countryCode": "IN" },
    "profiles": [
      { "network": "GitHub", "username": "asha-verma-example", "url": "github.com/asha-verma-example" }
    ]
  },
  "work": [
    {
      "name": "Example Logistics",
      "location": "Pune",
      "position": "Software Engineer",
      "startDate": "July 2023",
      "highlights": [
        "Cut p95 API latency from 420 ms to 180 ms with PostgreSQL indexes and a Redis cache.",
        "Built REST APIs in Python for route lookups, serving 3,000 requests a minute at peak.",
        "Built a Kafka consumer for 2 million shipment events a day, with idempotent writes and Grafana alerts.",
        "Moved 14 services to Docker and Kubernetes with Terraform, so a deploy takes 9 minutes instead of 40.",
        "Resolved 23 production incidents as one of six on-call engineers, and wrote 11 runbooks.",
        "Built a nightly SQL job that reconciles 400,000 shipment rows against the billing database."
      ]
    },
    {
      "name": "Example Analytics",
      "location": "Bengaluru",
      "position": "Software Engineering Intern",
      "startDate": "2022-01",
      "endDate": "2022-06",
      "highlights": "Wrote Python data-quality checks that stopped 37 bad rows a week before they reached dashboards."
    }
  ],
  "projects": [
    {
      "name": "Bus pass renewal bot",
      "keywords": ["Python", "FastAPI", "PostgreSQL"],
      "url": "https://github.com/asha-verma-example/bus-pass-bot",
      "highlights": [
        "Renews a monthly bus pass in 3 messages instead of a 20-minute queue.",
        "Packaged with Docker, so it runs on one small server."
      ]
    }
  ],
  "skills": [
    { "name": "Backend", "keywords": ["Python", "Go", "PostgreSQL", "Redis", "Kafka"] },
    { "name": "Infrastructure", "keywords": "Docker, Kubernetes, Terraform, Grafana, Git" }
  ],
  "education": [
    {
      "institution": "Example Institute of Technology",
      "studyType": "B.Tech.",
      "area": "Computer Science",
      "endDate": "2022",
      "score": "CGPA 8.2/10"
    }
  ]
}

resume/typo.json

{
  "basics": {
    "name": "Asha Verma",
    "label": "Backend engineer",
    "email": "asha.verma@example.com",
    "summary": "Backend engineer with three years of Python and PostgreSQL services for a logistics platform, who cuts latency and pages with measured fixes.",
    "location": { "city": "Pune", "countryCode": "IN" },
    "profiles": [
      { "network": "GitHub", "username": "asha-verma-example", "url": "https://github.com/asha-verma-example" }
    ]
  },
  "work": [
    {
      "name": "Example Logistics",
      "location": "Pune",
      "position": "Software Engineer",
      "startDate": "2023-07",
      "highlights": [
        "Cut p95 API latency from 420 ms to 180 ms with PostgreSQL indexes and a Redis cache.",
        "Built REST APIs in Python for route lookups, serving 3,000 requests a minute at peak.",
        "Built a Kafka consumer for 2 million shipment events a day, with idempotent writes and Grafana alerts.",
        "Moved 14 services to Docker and Kubernetes with Terraform, so a deploy takes 9 minutes instead of 40.",
        "Resolved 23 production incidents as one of six on-call engineers, and wrote 11 runbooks.",
        "Built a nightly SQL job that reconciles 400,000 shipment rows against the billing database."
      ]
    },
    {
      "name": "Example Analytics",
      "location": "Bengaluru",
      "position": "Software Engineering Intern",
      "startDate": "2022-01",
      "endDate": "2022-16",
      "highlights": [
        "Wrote Python data-quality checks that stopped 37 bad rows a week before they reached dashboards.",
        "Built an Airflow pipeline that loads 12 CSV feeds into PostgreSQL every night.",
        "Rewrote a pandas report in SQL, cutting its run time from 40 minutes to 4."
      ]
    }
  ],
  "projects": [
    {
      "name": "Bus pass renewal bot",
      "keywords": ["Python", "FastAPI", "PostgreSQL"],
      "url": "https://github.com/asha-verma-example/bus-pass-bot",
      "hightlights": [
        "Renews a monthly bus pass in 3 messages instead of a 20-minute queue.",
        "Packaged with Docker, so it runs on one small server."
      ]
    }
  ],
  "skills": [
    { "name": "Backend", "keywords": ["Python", "Go", "PostgreSQL", "Redis", "Kafka"] },
    { "name": "Infrastructure", "keywords": ["Docker", "Kubernetes", "Terraform", "Grafana", "Git"] }
  ],
  "education": [
    {
      "institution": "Example Institute of Technology",
      "studyType": "B.Tech.",
      "area": "Computer Science",
      "endDate": "2022",
      "score": "CGPA 8.2/10"
    }
  ]
}