Skip to content

ilyashatalov/cache-machine

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cache-machine

FC coding challenge

Getting started

Docker environment, production mode

Requirements:

  1. Clone repo
    git clone https://github.com/ilyashatalov/cache-machine.git && cd cache-machine 
    
  2. To start an application you need only to run docker-compose:
    docker-compose up -d mongo app

There are 3 containers (app, mongodb, mongo-express). The application will work on 3000 port that are binded to host 80 port. If you need to make some configuration of the app (TTL time, max cache items) you can change it in docker-compose.yml. Default variables are:

RANDOM_STRING_LENGTH=14
CACHE_MAX_COUNT=5
KEY_TTL=3600
LOG_LEVEL=info
  1. Try to curl our application (there will be one test item):
    curl localhost/keys
    Expected output:
    [{"_id":"63b59dd0cf59a59e34a4b0f1","__v":0,"key":"Test1","updatedAt":"2023-01-04T15:40:00.825Z","value":"Value1"}]
  2. Add one entry nd get HTTP status code:
    curl -w "\n%{http_code}\n" -X POST localhost/keys -d '{"key": "Key 100", "value": "Value 100"}' -H 'Content-Type: application/json'
    Expected output:
    {"key":"Key 100","value":"Value 100","_id":"63bf616fb19f977385f6febb","updatedAt":"2023-01-12T01:25:03.228Z","__v":0}%
    201
  3. Get unexisting Entry and get HTTP status code:
    curl -w "\n%{http_code}\n" localhost/keys/TestUnexist
    
    Expected output:
    {"key":"TestUnexist","value":"oHFKMWxf75f1ZK","_id":"63bf6249b19f977385f6fed1","updatedAt":"2023-01-12T01:28:41.404Z","__v":0}
    201
  4. Run the same command to get the existing Entry and check HTTP status code:
    curl -w "\n%{http_code}\n" localhost/keys/TestUnexist
    
    Expected output
    {"_id":"63bf6249b19f977385f6fed1","key":"TestUnexist","value":"oHFKMWxf75f1ZK","updatedAt":"2023-01-12T01:28:41.404Z","__v":0}
    200
  5. Delete one Entry
    curl -X DELETE -w "\n%{http_code}\n" localhost/keys/TestUnexist
    Expected output
    {"_id":"63bf6249b19f977385f6fed1","key":"TestUnexist","value":"oHFKMWxf75f1ZK","updatedAt":"2023-01-12T01:28:41.404Z","__v":0}
    200
  6. Delete all keys:
    curl -X DELETE -w "\n%{http_code}\n" localhost/keys
    Expected output
    {"acknowledged":true,"deletedCount":1}
    200

Development mode

Requirements

  1. nodeJS 19.3.0
  2. MongoDB 6.0 or Docker and docker-compose from the previous section

You need to configure the application to use your Mongo DB installation or you can use docker-compose included in this project.

  1. Install docker and docker-compose:

  2. Clone repo

    git clone https://github.com/ilyashatalov/cache-machine.git && cd cache-machine 
    
  3. And start mongo and mongo express:

    docker-compose up -d mongo mongo-express

It will start MongoDB 6.0 on your machine and map 27017 port (default for MongoDB) from the container to your host and mongo express on port 8081

  1. Clone repo (if you skip it above)
    git clone https://github.com/ilyashatalov/cache-machine.git && cd cache-machine 
    
  2. Locate to NodeJS APP
    cd cache-machine-server
  3. Edit DATABASE_URL parameter of env file in root of the project (and other if you need) If you use docker-compose from this project you can use a string like:
    DATABASE_URL = mongodb://fashiontest:Omio0raiOmio0rai@127.0.0.1/fcdb?authSource=admin
    
  4. Rename it to .env
    mv env .env
  5. Install all dependencies
    npm install
    
  6. Run application
    npm run dev 
  7. Test application with curls from the previous section with port APP_PORT
  8. Or run tests
    1. Edit file package.json test line with your DB credentials (notice that it's better to use another mongo database here like in the example)
    vim package.json
    1. Run tests
    npm run test
    Sample output:
    
    > cache-machine@0.2 test
    > tsc && cross-env CACHE_MAX_COUNT=10 KEY_TTL=60 DATABASE_URL=mongodb://fashiontest:Omio0raiOmio0rai@localhost/fcdb-test?authSource=admin LOG_LEVEL=debug NODE_ENV=test jest --runInBand --detectOpenHandles --forceExit --testTimeout=5000
    
    {"level":"info","message":"Cache hit","timestamp":"2023-01-22T23:51:07.823Z"}
    {"level":"info","message":"Cache hit","timestamp":"2023-01-22T23:51:07.864Z"}
    {"level":"debug","message":"There're more then 10 items","timestamp":"2023-01-22T23:51:08.067Z"}
    {"level":"info","message":"Deleted: {\n  _id: new ObjectId(\"63cdcbeca6beb701291fad66\"),\n  key: 'TestMax1',\n  value: 'n1R3Pl0G5r4QzT4K2OqsQgiEnLoIu3rR',\n  updatedAt: 2023-01-22T23:51:08.029Z,\n  __v: 0\n}","timestamp":"2023-01-22T23:51:08.070Z"}
    PASS  src/tests/api.test.ts
    POST /keys
        ✓ should add testEntry to app (134 ms)
    GET /keys/<Entry.key>
        ✓ will create new key with 201 status code (52 ms)
        ✓ after creation should be 200 status code (52 ms)
        ✓ should update updatedAt field (40 ms)
    GET /keys
        ✓ should return all entries (41 ms)
    DELETE /keys/<Entry.key>
        ✓ should delete one entry (44 ms)
    DELETE /keys
        ✓ should delete all entries (34 ms)
    Check TTL
        ✓ check that the expireAfterSeconds field is set correctly (23 ms)
    Max entries count
        ✓ check max entries count and a deletion logic (66 ms)
    
    Test Suites: 1 passed, 1 total
    Tests:       9 passed, 9 total
    Snapshots:   0 total
    Time:        1.716 s, estimated 2 s
    Ran all test suites.