0x04. Files Manager

A back-end project utilizing technologies such as JavaScript, ES6, NoSQL, MongoDB, Redis, NodeJS, ExpressJS and Kue.

Project Details

By: Guillaume, CTO at Holberton School
Weight: 1
Team Members: Samuel Amsalu and Tebogo Legoabe
Start Date: Feb 7, 2024 at 7:00 PM
End Date: Feb 14, 2024 at 7:00 PM
Checker Release: Feb 9, 2024 at 1:00 PM

Description

This project is a summary of this back-end trimester focusing on authentication, NodeJS, MongoDB, Redis, pagination and background processing. The objective is to build a simple platform to upload and view files with features including user authentication via token and file management capabilities.

Features

User authentication via a token
List all files
Upload a new file
Change permission of a file
View a file
Generate thumbnails for images

How to Run?

+----------------------+----------------------------------------------------------+
| Command              | Purpose                                                  |
+----------------------+----------------------------------------------------------+
| npm run lint         | Run ESLint to check for linting errors in JavaScript files |
| npm run check-lint   | Check ESLint errors using the lint script                |
| npm run start-server | Start the server using nodemon with Babel                |
| npm run start-worker | Start the worker using nodemon with Babel                |
| npm run dev          | Start the development server using nodemon with Babel    |
| npm test             | Run Mocha to execute tests located in the tests directory |
+----------------------+----------------------------------------------------------+

Resources

Read or watch:

Learning Objectives

At the end of this project you should be able to explain:

How to create an API with Express.
How to authenticate a user.
How to store data in MongoDB.
How to store temporary data in Redis.
How to setup and use a background worker.

Requirements

Allowed editors: vi,vim ,emacs ,Visual Studio Code.
All files will be interpreted/compiled on Ubuntu18.04 LTS using node(version12.x.x).
Your code should use the js extension.

Tasks

0. Redis utils

Inside the folder utils, create a file redis.js that contains the class RedisClient.

RedisClient should have:

the constructor that creates a client to Redis:
- any error of the redis client must be displayed in the console (you should use on('error') of the redis client)
a function isAlive that returns true when the connection to Redis is a success otherwise, false
an asynchronous function get that takes a string key as argument and returns the Redis value stored for this key
an asynchronous function set that takes a string key, a value and a duration in second as arguments to store it in Redis (with an expiration set by the duration argument)
an asynchronous function del that takes a string key as argument and remove the value in Redis for this key

After the class definition, create and export an instance of RedisClient called redisClient.

bob@dylan:~$ cat main.js
import redisClient from './utils/redis';

(async () => {
    console.log(redisClient.isAlive());
    console.log(await redisClient.get('myKey'));
    await redisClient.set('myKey', 12, 5);
    console.log(await redisClient.get('myKey'));

    setTimeout(async () => {
        console.log(await redisClient.get('myKey'));
    }, 1000*10)
})();

bob@dylan:~$ npm run dev main.js
true
null
12
null
bob@dylan:~$

Repo:

GitHub repository: alx-files_manager
File: utils/redis.js

1. MongoDB utils

Inside the folder utils, create a file db.js that contains the class DBClient.

DBClient should have:

the constructor that creates a client to MongoDB:
- host: from the environment variable DB_HOST or default: localhost
- port: from the environment variable DB_PORT or default: 27017
- database: from the environment variable DB_DATABASE or default: files_manager
a function isAlive that returns true when the connection to MongoDB is a success otherwise, false
an asynchronous function nbUsers that returns the number of documents in the collection users
an asynchronous function nbFiles that returns the number of documents in the collection files

After the class definition, create and export an instance of DBClient called dbClient.

bob@dylan:~$ cat main.js
import dbClient from './utils/db';

const waitConnection = () => {
    return new Promise((resolve, reject) => {
        let i = 0;
        const repeatFct = async () => {
            await setTimeout(() => {
                i += 1;
                if (i >= 10) {
                    reject()
                }
                else if(!dbClient.isAlive()) {
                    repeatFct()
                }
                else {
                    resolve()
                }
            }, 1000);
        };
        repeatFct();
    })
};

(async () => {
    console.log(dbClient.isAlive());
    await waitConnection();
    console.log(dbClient.isAlive());
    console.log(await dbClient.nbUsers());
    console.log(await dbClient.nbFiles());
})();

bob@dylan:~$ npm run dev main.js
false
true
4
30
bob@dylan:~$

Repo:

GitHub repository: alx-files_manager
File: utils/db.js

2. First API

Inside server.js, create the Express server:

it should listen on the port set by the environment variable PORT or by default 5000
it should load all routes from the file routes/index.js

Inside the folder routes, create a file index.js that contains all endpoints of our API:

GET /status => AppController.getStatus
GET /stats => AppController.getStats

Inside the folder controllers, create a file AppController.js that contains the definition of the 2 endpoints:

GET /status should return if Redis is alive and if the DB is alive too by using the 2 utils created previously: { "redis": true, "db": true } with a status code 200
GET /stats should return the number of users and files in DB: { "users": 12, "files": 1231 } with a status code 200

Repo:

GitHub repository: alx-files_manager
File: server.js, routes/index.js, controllers/AppController.js

3. Create a new user

Now that we have a simple API, it’s time to add users to our database.

In the file routes/index.js, add a new endpoint:

POST /users => UsersController.postNew

Inside controllers, add a file UsersController.js that contains the new endpoint:

POST /users should create a new user in DB:

To create a user, you must specify an email and a password
If the email is missing, return an error Missing email with a status code 400
If the password is missing, return an error Missing password with a status code 400
If the email already exists in DB, return an error Already exist with a status code 400
The password must be stored after being hashed in SHA1
The endpoint is returning the new user with only the email and the id (auto generated by MongoDB) with a status code 201
The new user must be saved in the collection users:
- email: same as the value received
- password: SHA1 value of the value received

bob@dylan:~$ curl 0.0.0.0:5000/users -XPOST -H "Content-Type: application/json" -d '{ "email": "bob@dylan.com", "password": "toto1234!" }' ; echo ""
{"id":"5f1e7d35c7ba06511e683b21","email":"bob@dylan.com"}
bob@dylan:~$
bob@dylan:~$ echo 'db.users.find()' | mongo files_manager
{ "_id" : ObjectId("5f1e7d35c7ba06511e683b21"), "email" : "bob@dylan.com", "password" : "89cad29e3ebc1035b29b1478a8e70854f25fa2b2" }
bob@dylan:~$
bob@dylan:~$
bob@dylan:~$ curl 0.0.0.0:5000/users -XPOST -H "Content-Type: application/json" -d '{ "email": "bob@dylan.com", "password": "toto1234!" }' ; echo ""
{"error":"Already exist"}
bob@dylan:~$
bob@dylan:~$ curl 0.0.0.0:5000/users -XPOST -H "Content-Type: application/json" -d '{ "email": "bob@dylan.com" }' ; echo ""
{"error":"Missing password"}
bob@dylan:~$

4. Authenticate a user

In the file routes/index.js, add 3 new endpoints:

GET /connect => AuthController.getConnect
GET /disconnect => AuthController.getDisconnect
GET /users/me => UserController.getMe

Inside controllers, add a file AuthController.js that contains new endpoints:

GET /connect should sign-in the user by generating a new authentication token:

By using the header Authorization and the technique of the Basic auth (Base64 of the <email>:<password>), find the user associate to this email and with this password (reminder: we are storing the SHA1 of the password)
If no user has been found, return an error Unauthorized with a status code 401
Otherwise:
- Generate a random string (using uuidv4) as token
- Create a key: auth_<token>
- Use this key for storing in Redis (by using the redisClient create previously) the user ID for 24 hours
- Return this token: { "token": "155342df-2399-41da-9e8c-458b6ac52a0c" } with a status code 200

Now, we have a way to identify a user, create a token (= avoid to store the password on any front-end) and use this token for 24h to access to the API!

Every authenticated endpoints of our API will look at this token inside the header X-Token.

GET /disconnect should sign-out the user based on the token:

Retrieve the user based on the token:
- If not found, return an error Unauthorized with a status code 401
- Otherwise, delete the token in Redis and return nothing with a status code 204

Inside the file controllers/UsersController.js add a new endpoint:

GET /users/me should retrieve the user base on the token used:

Retrieve the user based on the token:
- If not found, return an error Unauthorized with a status code 401
- Otherwise, return the user object (email and id only)

bob@dylan:~$ curl 0.0.0.0:5000/connect -H "Authorization: Basic Ym9iQGR5bGFuLmNvbTp0b3RvMTIzNCE=" ; echo ""
{"token":"031bffac-3edc-4e51-aaae-1c121317da8a"}
bob@dylan:~$
bob@dylan:~$ curl 0.0.0.0:5000/users/me -H "X-Token: 031bffac-3edc-4e51-aaae-1c121317da8a" ; echo ""
{"id":"5f1e7cda04a394508232559d","email":"bob@dylan.com"}
bob@dylan:~$
bob@dylan:~$ curl 0.0.0.0:5000/disconnect -H "X-Token: 031bffac-3edc-4e51-aaae-1c121317da8a" ; echo ""

bob@dylan:~$ curl 0.0.0.0:5000/users/me -H "X-Token: 031bffac-3edc-4e51-aaae-1c121317da8a" ; echo ""
{"error":"Unauthorized"}
bob@dylan:~$

Repo:

GitHub repository: alx-files_manager
File: utils/, routes/index.js, controllers/UsersController.js, controllers/AuthController.js

5. First file

In the file routes/index.js, add a new endpoint:

POST /files => FilesController.postUpload

Inside controllers, add a file FilesController.js that contains the new endpoint:

POST /files should create a new file in DB and in disk:

Retrieve the user based on the token:
- If not found, return an error Unauthorized with a status code 401
To create a file, you must specify:
- name: as filename
- type: either folder, file or image
- parentId: (optional) as ID of the parent (default: 0 -> the root)
- isPublic: (optional) as boolean to define if the file is public or not (default: false)
- data: (only for type=file|image) as Base64 of the file content
If the name is missing, return an error Missing name with a status code 400
If the type is missing or not part of the list of accepted type, return an error Missing type with a status code 400
If the data is missing and type != folder, return an error Missing data with a status code 400
If the parentId is set:
- If no file is present in DB for this parentId, return an error Parent not found with a status code 400
- If the file present in DB for this parentId is not of type folder, return an error Parent is not a folder with a status code 400
The user ID should be added to the document saved in DB - as owner of a file
If the type is folder, add the new file document in the DB and return the new file with a status code 201
Otherwise:
- All file will be stored locally in a folder (to create automatically if not present):
  - The relative path of this folder is given by the environment variable FOLDER_PATH
  - If this variable is not present or empty, use /tmp/files_manager as storing folder path
- Create a local path in the storing folder with filename a UUID
- Store the file in clear (reminder: data contains the Base64 of the file) in this local path
- Add the new file document in the collection files with these attributes:
  - userId: ID of the owner document (owner from the authentication)
  - name: same as the value received
  - type: same as the value received
  - isPublic: same as the value received
  - parentId: same as the value received - if not present: 0
  - localPath: for a type=file|image, the absolute path to the file save in local
- Return the new file with a status code 201

bob@dylan:~$ curl 0.0.0.0:5000/connect -H "Authorization: Basic Ym9iQGR5bGFuLmNvbTp0b3RvMTIzNCE=" ; echo ""
{"token":"f21fb953-16f9-46ed-8d9c-84c6450ec80f"}
bob@dylan:~$
bob@dylan:~$ curl -XPOST 0.0.0.0:5000/files -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" -H "Content-Type: application/json" -d '{ "name": "myText.txt", "type": "file", "data": "SGVsbG8gV2Vic3RhY2shCg==" }' ; echo ""
{"id":"5f1e879ec7ba06511e683b22","userId":"5f1e7cda04a394508232559d","name":"myText.txt","type":"file","isPublic":false,"parentId":0}
bob@dylan:~$
bob@dylan:~$ ls /tmp/files_manager/
2a1f4fc3-687b-491a-a3d2-5808a02942c9
bob@dylan:~$
bob@dylan:~$ cat /tmp/files_manager/2a1f4fc3-687b-491a-a3d2-5808a02942c9
Hello Webstack!
bob@dylan:~$
bob@dylan:~$ curl -XPOST 0.0.0.0:5000/files -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" -H "Content-Type: application/json" -d '{ "name": "images", "type": "folder" }' ; echo ""
{"id":"5f1e881cc7ba06511e683b23","userId":"5f1e7cda04a394508232559d","name":"images","type":"folder","isPublic":false,"parentId":0}
bob@dylan:~$
bob@dylan:~$ cat image_upload.py
import base64
import requests
import sys

file_path = sys.argv[1]
file_name = file_path.split('/')[-1]

file_encoded = None
with open(file_path, "rb") as image_file:
    file_encoded = base64.b64encode(image_file.read()).decode('utf-8')

r_json = { 'name': file_name, 'type': 'image', 'isPublic': True, 'data': file_encoded, 'parentId': sys.argv[3] }
r_headers = { 'X-Token': sys.argv[2] }

r = requests.post("http://0.0.0.0:5000/files", json=r_json, headers=r_headers)
print(r.json())

bob@dylan:~$
bob@dylan:~$ python image_upload.py image.png f21fb953-16f9-46ed-8d9c-84c6450ec80f 5f1e881cc7ba06511e683b23
{'id': '5f1e8896c7ba06511e683b25', 'userId': '5f1e7cda04a394508232559d', 'name': 'image.png', 'type': 'image', 'isPublic': True, 'parentId': '5f1e881cc7ba06511e683b23'}
bob@dylan:~$
bob@dylan:~$ echo 'db.files.find()' | mongo files_manager
{ "_id" : ObjectId("5f1e881cc7ba06511e683b23"), "userId" : ObjectId("5f1e7cda04a394508232559d"), "name" : "images", "type" : "folder", "parentId" : "0" }
{ "_id" : ObjectId("5f1e879ec7ba06511e683b22"), "userId" : ObjectId("5f1e7cda04a394508232559d"), "name" : "myText.txt", "type" : "file", "parentId" : "0", "isPublic" : false, "localPath" : "/tmp/files_manager/2a1f4fc3-687b-491a-a3d2-5808a02942c9" }
{ "_id" : ObjectId("5f1e8896c7ba06511e683b25"), "userId" : ObjectId("5f1e7cda04a394508232559d"), "name" : "image.png", "type" : "image", "parentId" : ObjectId("5f1e881cc7ba06511e683b23"), "isPublic" : true, "localPath" : "/tmp/files_manager/51997b88-5c42-42c2-901e-e7f4e71bdc47" }
bob@dylan:~$
bob@dylan:~$ ls /tmp/files_manager/
2a1f4fc3-687b-491a-a3d2-5808a02942c9   51997b88-5c42-42c2-901e-e7f4e71bdc47
bob@dylan:~$

6. Get and list file

In the file routes/index.js, add 2 new endpoints:

GET /files/:id => FilesController.getShow
GET /files => FilesController.getIndex

In the file controllers/FilesController.js, add the 2 new endpoints:

GET /files/:id should retrieve the file document based on the ID:

Retrieve the user based on the token:
- If not found, return an error Unauthorized with a status code 401
If no file document is linked to the user and the ID passed as parameter, return an error Not found with a status code 404
Otherwise, return the file document

GET /files should retrieve all users file documents for a specific parentId and with pagination:

Retrieve the user based on the token:
- If not found, return an error Unauthorized with a status code 401
Based on the query parameters parentId and page, return the list of file document
- parentId:
  - No validation of parentId needed - if the parentId is not linked to any user folder, returns an empty list
  - By default, parentId is equal to 0 = the root
- Pagination:
  - Each page should be 20 items max
  - page query parameter starts at 0 for the first page. If equals to 1, it means it’s the second page (form the 20th to the 40th), etc…
  - Pagination can be done directly by the aggregate of MongoDB

bob@dylan:~$ curl 0.0.0.0:5000/connect -H "Authorization: Basic Ym9iQGR5bGFuLmNvbTp0b3RvMTIzNCE=" ; echo ""
{"token":"f21fb953-16f9-46ed-8d9c-84c6450ec80f"}
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
[{"id":"5f1e879ec7ba06511e683b22","userId":"5f1e7cda04a394508232559d","name":"myText.txt","type":"file","isPublic":false,"parentId":0},{"id":"5f1e881cc7ba06511e683b23","userId":"5f1e7cda04a394508232559d","name":"images","type":"folder","isPublic":false,"parentId":0},{"id":"5f1e8896c7ba06511e683b25","userId":"5f1e7cda04a394508232559d","name":"image.png","type":"image","isPublic":true,"parentId":"5f1e881cc7ba06511e683b23"}]
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files?parentId=5f1e881cc7ba06511e683b23 -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
[{"id":"5f1e8896c7ba06511e683b25","userId":"5f1e7cda04a394508232559d","name":"image.png","type":"image","isPublic":true,"parentId":"5f1e881cc7ba06511e683b23"}]
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files/5f1e8896c7ba06511e683b25 -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
{"id":"5f1e8896c7ba06511e683b25","userId":"5f1e7cda04a394508232559d","name":"image.png","type":"image","isPublic":true,"parentId":"5f1e881cc7ba06511e683b23"}
bob@dylan:~$

7. File publish/unpublish

In the file routes/index.js, add 2 new endpoints:

PUT /files/:id/publish => FilesController.putPublish
PUT /files/:id/publish => FilesController.putUnpublish

In the file controllers/FilesController.js, add the 2 new endpoints:

PUT /files/:id/publish should set isPublic to true on the file document based on the ID:

Retrieve the user based on the token:
- If not found, return an error Unauthorized with a status code 401
If no file document is linked to the user and the ID passed as parameter, return an error Not found with a status code 404
Otherwise:
- Update the value of isPublic to true
- And return the file document with a status code 200

PUT /files/:id/unpublish should set isPublic to false on the file document based on the ID:

Retrieve the user based on the token:
- If not found, return an error Unauthorized with a status code 401
If no file document is linked to the user and the ID passed as parameter, return an error Not found with a status code 404
Otherwise:
- Update the value of isPublic to false
- And return the file document with a status code 200

bob@dylan:~$ curl 0.0.0.0:5000/connect -H "Authorization: Basic Ym9iQGR5bGFuLmNvbTp0b3RvMTIzNCE=" ; echo ""
{"token":"f21fb953-16f9-46ed-8d9c-84c6450ec80f"}
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files/5f1e8896c7ba06511e683b25 -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
{"id":"5f1e8896c7ba06511e683b25","userId":"5f1e7cda04a394508232559d","name":"image.png","type":"image","isPublic":false,"parentId":"5f1e881cc7ba06511e683b23"}
bob@dylan:~$
bob@dylan:~$ curl -XPUT 0.0.0.0:5000/files/5f1e8896c7ba06511e683b25/publish -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
{"id":"5f1e8896c7ba06511e683b25","userId":"5f1e7cda04a394508232559d","name":"image.png","type":"image","isPublic":true,"parentId":"5f1e881cc7ba06511e683b23"}
bob@dylan:~$
bob@dylan:~$ curl -XPUT 0.0.0.0:5000/files/5f1e8896c7ba06511e683b25/unpublish -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
{"id":"5f1e8896c7ba06511e683b25","userId":"5f1e7cda04a394508232559d","name":"image.png","type":"image","isPublic":false,"parentId":"5f1e881cc7ba06511e683b23"}
bob@dylan:~$

8. File data

In the file routes/index.js, add one new endpoint:

GET /files/:id/data => FilesController.getFile

In the file controllers/FilesController.js, add the new endpoint:

GET /files/:id/data should return the content of the file document based on the ID:

If no file document is linked to the ID passed as parameter, return an error Not found with a status code 404
If the file document (folder or file) is not public (isPublic: false) and no user authenticate or not the owner of the file, return an error Not found with a status code 404
If the type of the file document is folder, return an error A folder doesn't have content with a status code 400
If the file is not locally present, return an error Not found with a status code 404
Otherwise:
- By using the module mime-types, get the MIME-type based on the name of the file
- Return the content of the file with the correct MIME-type

bob@dylan:~$ curl 0.0.0.0:5000/connect -H "Authorization: Basic Ym9iQGR5bGFuLmNvbTp0b3RvMTIzNCE=" ; echo ""
{"token":"f21fb953-16f9-46ed-8d9c-84c6450ec80f"}
bob@dylan:~$
bob@dylan:~$ curl -XPUT 0.0.0.0:5000/files/5f1e879ec7ba06511e683b22/unpublish -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
{"id":"5f1e879ec7ba06511e683b22","userId":"5f1e7cda04a394508232559d","name":"myText.txt","type":"file","isPublic":false,"parentId":0}
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files/5f1e879ec7ba06511e683b22/data -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
Hello Webstack!

bob@dylan:~$ curl -XGET 0.0.0.0:5000/files/5f1e879ec7ba06511e683b22/data ; echo ""
{"error":"Not found"}
bob@dylan:~$
bob@dylan:~$ curl -XPUT 0.0.0.0:5000/files/5f1e879ec7ba06511e683b22/publish -H "X-Token: f21fb953-16f9-46ed-8d9c-84c6450ec80f" ; echo ""
{"id":"5f1e879ec7ba06511e683b22","userId":"5f1e7cda04a394508232559d","name":"myText.txt","type":"file","isPublic":true,"parentId":0}
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files/5f1e879ec7ba06511e683b22/data ; echo ""
Hello Webstack!

bob@dylan:~$

9. Image Thumbnails

Update the endpoint POST /files endpoint to start a background processing for generating thumbnails for a file of type image:

Create a Bull queue fileQueue
When a new image is stored (in local and in DB), add a job to this queue with the userId and fileId

Create a file worker.js:

By using the module Bull, create a queue fileQueue
Process this queue:
- If fileId is not present in the job, raise an error Missing fileId
- If userId is not present in the job, raise an error Missing userId
- If no document is found in DB based on the fileId and userId, raise an error File not found
- By using the module image-thumbnail, generate 3 thumbnails with width = 500, 250 and 100 - store each result on the same location of the original file by appending _<width size>

Update the endpoint GET /files/:id/data to accept a query parameter size:

size can be 500, 250 or 100
Based on size, return the correct local file
If the local file doesn’t exist, return an error Not found with a status code 404

Terminal 3: (start the worker)

bob@dylan:~$ npm run start-worker
...

Terminal 2:

bob@dylan:~$ curl 0.0.0.0:5000/connect -H "Authorization: Basic Ym9iQGR5bGFuLmNvbTp0b3RvMTIzNCE=" ; echo ""
{"token":"f21fb953-16f9-46ed-8d9c-84c6450ec80f"}
bob@dylan:~$
bob@dylan:~$ python image_upload.py image.png f21fb953-16f9-46ed-8d9c-84c6450ec80f 5f1e881cc7ba06511e683b23
{'id': '5f1e8896c7ba06511e683b25', 'userId': '5f1e7cda04a394508232559d', 'name': 'image.png', 'type': 'image', 'isPublic': True, 'parentId': '5f1e881cc7ba06511e683b23'}
bob@dylan:~$ ls /tmp/files_manager/
2a1f4fc3-687b-491a-a3d2-5808a02942c9   51997b88-5c42-42c2-901e-e7f4e71bdc47   6dc53397-8491-4b7c-8273-f748b1a031cb   6dc53397-8491-4b7c-8273-f748b1a031cb_100   6dc53397-8491-4b7c-8273-f748b1a031cb_250    6dc53397-8491-4b7c-8273-f748b1a031cb_500
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files/5f1e8896c7ba06511e683b25/data -so new_image.png ; file new_image.png
new_image.png: PNG image data, 471 x 512, 8-bit/color RGBA, non-interlaced
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files/5f1e8896c7ba06511e683b25/data?size=100 -so new_image.png ; file new_image.png
new_image.png: PNG image data, 100 x 109, 8-bit/color RGBA, non-interlaced
bob@dylan:~$
bob@dylan:~$ curl -XGET 0.0.0.0:5000/files/5f1e8896c7ba06511e683b25/data?size=250 -so new_image.png ; file new_image.png
new_image.png: PNG image data, 250 x 272, 8-bit/color RGBA, non-interlaced
bob@dylan:~$

10. Tests!

Of course, a strong and stable project can not be good without tests.

Create tests for redisClient and dbClient.

Create tests for each endpoints:

GET /status
GET /stats
POST /users
GET /connect
GET /disconnect
GET /users/me
POST /files
GET /files/:id
GET /files (don’t forget the pagination)
PUT /files/:id/publish
PUT /files/:id/unpublish
GET /files/:id/data

11. New user - welcome email

Update the endpoint POST /users endpoint to start a background processing for sending a “Welcome email” to the user:

Create a Bull queue userQueue
When a new user is stored (in DB), add a job to this queue with the userId

Update the file worker.js:

By using the module Bull, create a queue userQueue
Process this queue:
- If userId is not present in the job, raise an error Missing userId
- If no document is found in DB based on the userId, raise an error User not found
- Print in the console Welcome <email>!

BY LINET

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
controllers		controllers
routes		routes
tests		tests
utils		utils
.README.md.swp		.README.md.swp
README.md		README.md
babel.config.js		babel.config.js
dump.rdb		dump.rdb
image_upload.py		image_upload.py
main_db.js		main_db.js
main_redis.js		main_redis.js
package-lock.json		package-lock.json
package.json		package.json
server.js		server.js
worker.js		worker.js

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

0x04. Files Manager

Project Details

Description

Features

How to Run?

Resources

Learning Objectives

Requirements

Tasks

0. Redis utils

1. MongoDB utils

2. First API

3. Create a new user

4. Authenticate a user

5. First file

6. Get and list file

7. File publish/unpublish

8. File data

9. Image Thumbnails

10. Tests!

11. New user - welcome email

About

Uh oh!

Releases

Packages

Uh oh!

Languages

linetgitonga/alx-files_manager

Folders and files

Latest commit

History

Repository files navigation

0x04. Files Manager

Project Details

Description

Features

How to Run?

Resources

Learning Objectives

Requirements

Tasks

0. Redis utils

1. MongoDB utils

2. First API

3. Create a new user

4. Authenticate a user

5. First file

6. Get and list file

7. File publish/unpublish

8. File data

9. Image Thumbnails

10. Tests!

11. New user - welcome email

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Packages