version: 2.1
commands:
  restore_cached_venv:
    description: "Restore a cached venv"
    parameters:
      reqs_checksum:
        type: string
        default: "1234"
      venv_name:
        type: string
        default: "default-name"
    steps:
      - restore_cache:
          keys:
            - << parameters.venv_name >>-venv-<< parameters.reqs_checksum >>
            # fallback to using the latest cache if no exact match is found
            - << parameters.venv_name >>-venv-
  save_cached_venv:
    description: "Save a venv into a cache"
    parameters:
      reqs_checksum:
        type: string
        default: "1234"
      venv_path:
        type: string
        default: "venv"
      venv_name:
        type: string
        default: "default-name"
    steps:
      - save_cache:
          key: << parameters.venv_name >>-venv-<< parameters.reqs_checksum >>
          paths: << parameters.venv_path >>
  restore_pyspec_cached_venv:
    description: "Restore the cache with pyspec keys"
    steps:
      - restore_cached_venv:
          venv_name: v9-pyspec
          reqs_checksum: cache-{{ checksum "tests/core/pyspec/requirements.txt" }}-{{ checksum "tests/core/pyspec/requirements-testing.txt" }}
  save_pyspec_cached_venv:
    description: Save a venv into a cache with pyspec keys"
    steps:
      - save_cached_venv:
          venv_name: v9-pyspec
          reqs_checksum: cache-{{ checksum "tests/core/pyspec/requirements.txt" }}-{{ checksum "tests/core/pyspec/requirements-testing.txt" }}
          venv_path: ./tests/core/pyspec/venv
  restore_deposit_contract_cached_venv:
    description: "Restore the cache with deposit_contract keys"
    steps:
      - restore_cached_venv:
          venv_name: v10-deposit-contract
          reqs_checksum: cache-{{ checksum "tests/core/pyspec/requirements.txt" }}-{{ checksum "deposit_contract/requirements-testing.txt" }}
  save_deposit_contract_cached_venv:
    description: Save a venv into a cache with deposit_contract keys"
    steps:
      - save_cached_venv:
          venv_name: v10-deposit-contract
          reqs_checksum: cache-{{ checksum "tests/core/pyspec/requirements.txt" }}-{{ checksum "deposit_contract/requirements-testing.txt" }}
          venv_path: ./deposit_contract/venv
jobs:
  checkout_specs:
    docker:
      - image: circleci/python:3.8
    working_directory: ~/specs-repo
    steps:
      # Restore git repo at point close to target branch/revision, to speed up checkout
      - restore_cache:
          keys:
            - v2-specs-repo-{{ .Branch }}-{{ .Revision }}
            - v2-specs-repo-{{ .Branch }}-
            - v2-specs-repo-
      - checkout
      - run:
          name: Clean up git repo to reduce cache size
          command: git gc
      # Save the git checkout as a cache, to make cloning next time faster.
      - save_cache:
          key: v2-specs-repo-{{ .Branch }}-{{ .Revision }}
          paths:
            - ~/specs-repo
  install_pyspec_test:
    docker:
      - image: circleci/python:3.8
    working_directory: ~/specs-repo
    steps:
      - restore_cache:
          key: v2-specs-repo-{{ .Branch }}-{{ .Revision }}
      - restore_pyspec_cached_venv
      - run:
          name: Install pyspec requirements
          command: make install_test
      - save_pyspec_cached_venv
  test:
    docker:
      - image: circleci/python:3.8
    working_directory: ~/specs-repo
    steps:
      - restore_cache:
          key: v2-specs-repo-{{ .Branch }}-{{ .Revision }}
      - restore_pyspec_cached_venv
      - run:
          name: Run py-tests
          command: make citest
      - store_test_results:
          path: tests/core/pyspec/test-reports
  table_of_contents:
    docker:
      - image: circleci/node:10.16.3
    working_directory: ~/specs-repo
    steps:
      - checkout
      - run:
          name: Check table of contents
          command: sudo npm install -g doctoc && make check_toc
  codespell:
    docker:
      - image: circleci/python:3.8
    working_directory: ~/specs-repo
    steps:
      - checkout
      - run:
          name: Check codespell
          command: pip install codespell --user &&  make codespell
  lint:
    docker:
      - image: circleci/python:3.8
    working_directory: ~/specs-repo
    steps:
      - restore_cache:
          key: v2-specs-repo-{{ .Branch }}-{{ .Revision }}
      - restore_pyspec_cached_venv
      - run:
          name: Run linter
          command: make lint
  install_deposit_contract_test:
    docker:
      - image: circleci/python:3.8
    working_directory: ~/specs-repo
    steps:
      - restore_cache:
          key: v2-specs-repo-{{ .Branch }}-{{ .Revision }}
      - restore_deposit_contract_cached_venv
      - run:
          name: Install deposit contract requirements
          command: make install_deposit_contract_test
      - save_deposit_contract_cached_venv
  deposit_contract:
    docker:
      - image: circleci/python:3.8
    working_directory: ~/specs-repo
    steps:
      - restore_cache:
          key: v2-specs-repo-{{ .Branch }}-{{ .Revision }}
      - restore_deposit_contract_cached_venv
      - run:
          name: Run deposit contract test
          command: make test_deposit_contract
workflows:
  version: 2.1
  test_spec:
    jobs:
      - checkout_specs
      - install_pyspec_test:
          requires:
            - checkout_specs
      - test:
          requires:
            - install_pyspec_test
      - table_of_contents
      - codespell
      - lint:
          requires:
            - test
      - install_deposit_contract_test:
          requires:
            - checkout_specs
      - deposit_contract:
          requires:
            - install_deposit_contract_test