Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: add tests for check markdown script #3378

Merged
merged 60 commits into from
Dec 14, 2024

Conversation

vishvamsinh28
Copy link
Contributor

@vishvamsinh28 vishvamsinh28 commented Nov 9, 2024

This PR adds tests for check-markdown.js script

Summary by CodeRabbit

  • New Features

    • Enhanced markdown file validation with improved error handling.
    • Added asynchronous processing for markdown checks.
    • Introduced a new main function to orchestrate markdown validation.
  • Bug Fixes

    • Improved error logging for invalid markdown files and filesystem errors.
  • Tests

    • Introduced a comprehensive suite of unit tests for validating markdown frontmatter, covering various scenarios and error handling, including tests for the new main function.

Copy link

coderabbitai bot commented Nov 9, 2024

Walkthrough

The changes in this pull request involve updates to the check-markdown.js script to implement asynchronous file system operations using fs.promises. The checkMarkdownFiles function is modified to handle errors more effectively and to improve control flow with async/await. Additionally, a new suite of unit tests is introduced in check-markdown.test.js to validate the functionality and error handling of the markdown processing, ensuring comprehensive coverage of various scenarios.

Changes

File Path Change Summary
scripts/markdown/check-markdown.js - Updated to use fs.promises for asynchronous file operations.
- Converted checkMarkdownFiles to an async function with improved error handling.
- Maintained logic for skipping the 'docs/reference/specification' folder.
- Introduced a new main function for orchestrating validation.
- Exported validateBlogs, validateDocs, checkMarkdownFiles, and main.
tests/markdown/check-markdown.test.js - Introduced unit tests for validating frontmatter in markdown files using Jest.
- Implemented asynchronous setup and teardown for tests.
- Covered various validation scenarios for validateBlogs and validateDocs.
- Tested error handling in checkMarkdownFiles.

Possibly related PRs

Suggested labels

ready-to-merge, gsoc

Suggested reviewers

  • derberg
  • magicmatatjahu
  • devilkiller-ag
  • sambhavgupta0705
  • anshgoyalevil
  • akshatnema
  • Mayaleeeee
  • asyncapi-bot-eve

🐰 In the meadow, where the markdown grows,
A rabbit hops, where the error flows.
With promises now, the files do sing,
Async magic, oh what joy it brings!
Validations strong, in tests they play,
Hopping through code, in a cheerful way! 🌼


Thank you for using CodeRabbit. We offer it for free to the OSS community and would appreciate your support in helping us grow. If you find it useful, would you consider giving us a shout-out on your favorite social media?

❤️ Share
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Generate unit testing code for this file.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai generate unit testing code for this file.
    • @coderabbitai modularize this function.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and generate unit testing code.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.
    • @coderabbitai help me debug CodeRabbit configuration file.

Note: Be mindful of the bot's finite context window. It's strongly recommended to break down tasks such as reading entire modules into smaller chunks. For a focused discussion, use review comments to chat about specific files and their changes, instead of using the PR comments.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR. (Experiment)
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

Copy link

netlify bot commented Nov 9, 2024

Deploy Preview for asyncapi-website ready!

Built without sensitive environment variables

Name Link
🔨 Latest commit 17dab5c
🔍 Latest deploy log https://app.netlify.com/sites/asyncapi-website/deploys/675d06e52054180008c9c5ce
😎 Deploy Preview https://deploy-preview-3378--asyncapi-website.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link

codecov bot commented Nov 9, 2024

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 86.59%. Comparing base (0349217) to head (17dab5c).
Report is 2 commits behind head on master.

Additional details and impacted files
@@            Coverage Diff             @@
##           master    #3378      +/-   ##
==========================================
+ Coverage   77.22%   86.59%   +9.37%     
==========================================
  Files          21       21              
  Lines         663      664       +1     
==========================================
+ Hits          512      575      +63     
+ Misses        151       89      -62     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

@asyncapi-bot
Copy link
Contributor

asyncapi-bot commented Nov 9, 2024

⚡️ Lighthouse report for the changes in this PR:

Category Score
🔴 Performance 32
🟢 Accessibility 98
🟢 Best practices 92
🟢 SEO 100
🔴 PWA 33

Lighthouse ran on https://deploy-preview-3378--asyncapi-website.netlify.app/

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Outside diff range and nitpick comments (6)
tests/markdown/check-markdown.test.js (3)

14-21: Consider improving error handling in beforeEach.

While the setup works, the error handling could be more robust by using async/await pattern instead of the callback approach.

Consider refactoring to:

-    beforeEach(done => {
-        mockConsoleError = jest.spyOn(console, 'error').mockImplementation();
-        fs.mkdtemp(path.join(os.tmpdir(), 'test-config'), (err, directory) => {
-            if (err) throw err;
-            tempDir = directory;
-            done();
-        });
-    });
+    beforeEach(async () => {
+        mockConsoleError = jest.spyOn(console, 'error').mockImplementation();
+        tempDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'test-config'));
+    });

28-44: Add edge cases to author validation tests.

The current test case doesn't cover all possible scenarios for author validation.

Consider adding tests for:

  • Empty authors array
  • Authors with empty strings
  • Authors with malformed URLs (e.g., missing protocol)
  • Maximum length validation for author fields

46-53: Enhance docs frontmatter validation test coverage.

The current test only checks for invalid types but misses other important scenarios.

Consider adding test cases for:

  • Empty frontmatter object
  • Missing optional fields
  • Edge cases for weight values (negative, zero, decimal)
  • Special characters in title
scripts/markdown/check-markdown.js (3)

148-148: Fix the trailing comma in module.exports.

The trailing comma in the exports statement is unnecessary and inconsistent with the rest of the codebase.

-module.exports = { validateBlogs, validateDocs, checkMarkdownFiles,}
+module.exports = { validateBlogs, validateDocs, checkMarkdownFiles }

Line range hint 9-17: Consider using a more robust URL validation.

The current URL validation might accept invalid URLs in some edge cases. Consider using a more comprehensive validation approach.

 function isValidURL(str) {
     try {
-        new URL(str);
-        return true;
+        const url = new URL(str);
+        // Additional validation for http/https protocols
+        return ['http:', 'https:'].includes(url.protocol);
     } catch (err) {
         return false;
     }
 }

Line range hint 82-144: Consider refactoring to use promises for better testability.

The checkMarkdownFiles function uses nested callbacks, making it harder to test. Consider refactoring to use promises or async/await for better error handling and testability.

Here's a suggested refactor:

async function checkMarkdownFiles(folderPath, validateFunction, relativePath = '') {
    try {
        const files = await fs.promises.readdir(folderPath);
        
        for (const file of files) {
            const filePath = path.join(folderPath, file);
            const relativeFilePath = path.join(relativePath, file);

            if (relativeFilePath.includes('reference/specification')) {
                continue;
            }

            const stats = await fs.promises.stat(filePath);
            
            if (stats.isDirectory()) {
                await checkMarkdownFiles(filePath, validateFunction, relativeFilePath);
            } else if (path.extname(file) === '.md') {
                const fileContent = await fs.promises.readFile(filePath, 'utf-8');
                const { data: frontmatter } = matter(fileContent);

                const errors = validateFunction(frontmatter);
                if (errors) {
                    console.log(`Errors in file ${relativeFilePath}:`);
                    errors.forEach(error => console.log(` - ${error}`));
                    process.exitCode = 1;
                }
            }
        }
    } catch (err) {
        console.error('Error processing files:', err);
        process.exitCode = 1;
    }
}
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 311886b and a9da240.

📒 Files selected for processing (2)
  • scripts/markdown/check-markdown.js (1 hunks)
  • tests/markdown/check-markdown.test.js (1 hunks)
🔇 Additional comments (2)
tests/markdown/check-markdown.test.js (1)

1-8: LGTM! Imports are well-organized.

The necessary Node.js built-in modules and validation functions are properly imported.

scripts/markdown/check-markdown.js (1)

147-148: Verify test coverage for exported functions.

The functions are now being exported for testing purposes. Let's verify that appropriate tests have been implemented.

✅ Verification successful

Let me gather more information about the test coverage by examining the actual test implementations.


Let me check the complete test file content to get a full picture of the test coverage.


Test coverage is comprehensive for all exported functions

The test suite includes thorough coverage for all exported functions:

  • validateBlogs: Tests for author validation, multiple validation errors, and invalid frontmatter
  • validateDocs: Tests for required fields validation
  • checkMarkdownFiles: Tests for file processing, error handling for invalid files, and filesystem errors

The tests include proper assertions, error cases, and mock implementations for filesystem operations.

🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Description: Verify test coverage for the exported functions

# Test 1: Check if test file exists and contains tests for all exported functions
echo "Checking test coverage for exported functions..."
rg -A 5 "describe\(.*(?:validateBlogs|validateDocs|checkMarkdownFiles)" "tests/markdown/check-markdown.test.js"

# Test 2: Verify that the functions are only used in the main script and tests
echo "Verifying function usage across codebase..."
rg "(?:validateBlogs|validateDocs|checkMarkdownFiles)" --type js

Length of output: 1748


Script:

#!/bin/bash
# Check the actual test implementations
echo "Examining test implementations..."
rg -B 2 -A 10 "describe\('.*'" "tests/markdown/check-markdown.test.js"

# Check if there are any test assertions
echo "Checking test assertions..."
rg "expect|assert|should" "tests/markdown/check-markdown.test.js"

Length of output: 1192


Script:

#!/bin/bash
# Get the complete test file content
echo "Examining complete test file..."
cat "tests/markdown/check-markdown.test.js"

Length of output: 3860

Comment on lines 55 to 66
it('checks for errors in markdown files in a directory', done => {
fs.writeFileSync(path.join(tempDir, 'invalid.md'), `---\ntitle: Invalid Blog\n---`);
const mockConsoleLog = jest.spyOn(console, 'log').mockImplementation();

checkMarkdownFiles(tempDir, validateBlogs);

setTimeout(() => {
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('Errors in file invalid.md:'));
mockConsoleLog.mockRestore();
done();
}, 100);
});
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

Refactor async tests to use more reliable patterns.

The current implementation has several issues:

  1. Hardcoded timeout values (100ms) might cause flaky tests
  2. setTimeout with done callback is an anti-pattern in Jest
  3. Inconsistent async testing patterns across different test cases

Consider refactoring to use async/await pattern consistently:

-    it('checks for errors in markdown files in a directory', done => {
-        fs.writeFileSync(path.join(tempDir, 'invalid.md'), `---\ntitle: Invalid Blog\n---`);
-        const mockConsoleLog = jest.spyOn(console, 'log').mockImplementation();
-
-        checkMarkdownFiles(tempDir, validateBlogs);
-
-        setTimeout(() => {
-            expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('Errors in file invalid.md:'));
-            mockConsoleLog.mockRestore();
-            done();
-        }, 100);
+    it('checks for errors in markdown files in a directory', async () => {
+        fs.writeFileSync(path.join(tempDir, 'invalid.md'), `---\ntitle: Invalid Blog\n---`);
+        const mockConsoleLog = jest.spyOn(console, 'log').mockImplementation();
+
+        await checkMarkdownFiles(tempDir, validateBlogs);
+        
+        expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('Errors in file invalid.md:'));
+        mockConsoleLog.mockRestore();

Also applies to: 83-94, 96-108

authors: { name: 'John Doe' }
};
const errors = validateBlogs(frontmatter);
console.log(errors)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Remove debug console.log statement.

Debug logging should not be committed to the test suite.

-        console.log(errors)
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
console.log(errors)

Comment on lines 61 to 66
setTimeout(() => {
expect(mockConsoleLog).toHaveBeenCalledWith(expect.stringContaining('Errors in file invalid.md:'));
mockConsoleLog.mockRestore();
done();
}, 100);
});
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why are we adding timeout here?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

replaced it with async/await

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🧹 Outside diff range and nitpick comments (4)
tests/markdown/check-markdown.test.js (3)

61-73: Enhance test assertions for multiple validation errors.

The current test only checks the number of errors but not their specific content. Consider adding more specific assertions to ensure the exact validation messages are present.

Consider updating the test like this:

 const errors = validateBlogs(frontmatter);

-expect(errors.length).toBeGreaterThan(3);
+expect(errors).toEqual(expect.arrayContaining([
+  'Title must be a string',
+  'Date must be a valid date string',
+  'Tags must be an array',
+  'Cover must be a string',
+  'Authors must be an array'
+]));
🧰 Tools
🪛 eslint

[error] 61-61: Delete ··

(prettier/prettier)


[error] 62-62: Replace ········ with ····

(prettier/prettier)


[error] 63-63: Delete ······

(prettier/prettier)


[error] 64-64: Replace ············ with ······

(prettier/prettier)


[error] 65-65: Replace ············ with ······

(prettier/prettier)


[error] 66-66: Delete ······

(prettier/prettier)


[error] 67-67: Replace ············ with ······

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ····

(prettier/prettier)


[error] 70-70: Delete ····

(prettier/prettier)


[error] 72-72: Replace ········ with ····

(prettier/prettier)


[error] 73-73: Delete ··

(prettier/prettier)


24-83: Add test cases for edge cases.

The test suite would benefit from additional test cases covering:

  • Empty frontmatter
  • Malformed YAML
  • Empty authors array
  • Empty tags array

Would you like me to help generate these additional test cases?

🧰 Tools
🪛 eslint

[error] 24-24: Delete ··

(prettier/prettier)


[error] 25-25: Delete ····

(prettier/prettier)


[error] 26-26: Delete ······

(prettier/prettier)


[error] 27-27: Replace ············ with ······

(prettier/prettier)


[error] 28-28: Delete ······

(prettier/prettier)


[error] 29-29: Replace ············ with ······

(prettier/prettier)


[error] 30-30: Replace ············ with ······

(prettier/prettier)


[error] 31-31: Delete ······

(prettier/prettier)


[error] 32-32: Delete ····

(prettier/prettier)


[error] 34-34: Delete ····

(prettier/prettier)


[error] 35-35: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 36-36: Replace ············ with ········

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 38-38: Replace ············ with ········

(prettier/prettier)


[error] 39-39: Replace ··]) with ])⏎····

(prettier/prettier)


[error] 40-40: Delete ··

(prettier/prettier)


[error] 42-42: Delete ··

(prettier/prettier)


[error] 43-43: Delete ····

(prettier/prettier)


[error] 44-44: Replace ········ with ····

(prettier/prettier)


[error] 45-47: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 48-48: Replace ········]) with ····

(prettier/prettier)


[error] 49-49: Delete ··

(prettier/prettier)


[error] 51-51: Delete ··

(prettier/prettier)


[error] 52-52: Delete ····

(prettier/prettier)


[error] 53-53: Replace ········ with ····

(prettier/prettier)


[error] 55-55: Delete ····

(prettier/prettier)


[error] 57-57: Delete ····

(prettier/prettier)


[error] 58-58: Replace ········ with ····

(prettier/prettier)


[error] 59-59: Delete ··

(prettier/prettier)


[error] 61-61: Delete ··

(prettier/prettier)


[error] 62-62: Replace ········ with ····

(prettier/prettier)


[error] 63-63: Delete ······

(prettier/prettier)


[error] 64-64: Replace ············ with ······

(prettier/prettier)


[error] 65-65: Replace ············ with ······

(prettier/prettier)


[error] 66-66: Delete ······

(prettier/prettier)


[error] 67-67: Replace ············ with ······

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ····

(prettier/prettier)


[error] 70-70: Delete ····

(prettier/prettier)


[error] 72-72: Replace ········ with ····

(prettier/prettier)


[error] 73-73: Delete ··

(prettier/prettier)


[error] 75-75: Delete ··

(prettier/prettier)


[error] 76-76: Replace ········ with ····

(prettier/prettier)


[error] 77-77: Delete ····

(prettier/prettier)


[error] 77-77: 'mockConsoleError' is already declared in the upper scope on line 12 column 9.

(no-shadow)


[error] 78-78: Delete ····

(prettier/prettier)


[error] 79-79: Delete ····

(prettier/prettier)


[error] 80-80: Delete ····

(prettier/prettier)


[error] 81-81: Replace ········ with ····

(prettier/prettier)


[error] 82-82: Delete ····

(prettier/prettier)


1-85: Fix formatting issues throughout the file.

The file has numerous formatting inconsistencies. Consider running Prettier to automatically fix these issues.

Run the following command to fix formatting:

npx prettier --write tests/markdown/check-markdown.test.js
🧰 Tools
🪛 eslint

[error] 4-8: Replace ⏎····validateBlogs,⏎····validateDocs,⏎····checkMarkdownFiles⏎ with ·validateBlogs,·validateDocs,·checkMarkdownFiles·

(prettier/prettier)


[error] 11-11: Delete ··

(prettier/prettier)


[error] 12-12: Delete ··

(prettier/prettier)


[error] 14-14: Replace ···· with ··

(prettier/prettier)


[error] 15-15: Delete ····

(prettier/prettier)


[error] 16-16: Delete ····

(prettier/prettier)


[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 19-19: Delete ··

(prettier/prettier)


[error] 20-20: Replace ········ with ····

(prettier/prettier)


[error] 21-21: Replace ········ with ····

(prettier/prettier)


[error] 22-22: Delete ··

(prettier/prettier)


[error] 24-24: Delete ··

(prettier/prettier)


[error] 25-25: Delete ····

(prettier/prettier)


[error] 26-26: Delete ······

(prettier/prettier)


[error] 27-27: Replace ············ with ······

(prettier/prettier)


[error] 28-28: Delete ······

(prettier/prettier)


[error] 29-29: Replace ············ with ······

(prettier/prettier)


[error] 30-30: Replace ············ with ······

(prettier/prettier)


[error] 31-31: Delete ······

(prettier/prettier)


[error] 32-32: Delete ····

(prettier/prettier)


[error] 34-34: Delete ····

(prettier/prettier)


[error] 35-35: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 36-36: Replace ············ with ········

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 38-38: Replace ············ with ········

(prettier/prettier)


[error] 39-39: Replace ··]) with ])⏎····

(prettier/prettier)


[error] 40-40: Delete ··

(prettier/prettier)


[error] 42-42: Delete ··

(prettier/prettier)


[error] 43-43: Delete ····

(prettier/prettier)


[error] 44-44: Replace ········ with ····

(prettier/prettier)


[error] 45-47: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 48-48: Replace ········]) with ····

(prettier/prettier)


[error] 49-49: Delete ··

(prettier/prettier)


[error] 51-51: Delete ··

(prettier/prettier)


[error] 52-52: Delete ····

(prettier/prettier)


[error] 53-53: Replace ········ with ····

(prettier/prettier)


[error] 55-55: Delete ····

(prettier/prettier)


[error] 57-57: Delete ····

(prettier/prettier)


[error] 58-58: Replace ········ with ····

(prettier/prettier)


[error] 59-59: Delete ··

(prettier/prettier)


[error] 61-61: Delete ··

(prettier/prettier)


[error] 62-62: Replace ········ with ····

(prettier/prettier)


[error] 63-63: Delete ······

(prettier/prettier)


[error] 64-64: Replace ············ with ······

(prettier/prettier)


[error] 65-65: Replace ············ with ······

(prettier/prettier)


[error] 66-66: Delete ······

(prettier/prettier)


[error] 67-67: Replace ············ with ······

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ····

(prettier/prettier)


[error] 70-70: Delete ····

(prettier/prettier)


[error] 72-72: Replace ········ with ····

(prettier/prettier)


[error] 73-73: Delete ··

(prettier/prettier)


[error] 75-75: Delete ··

(prettier/prettier)


[error] 76-76: Replace ········ with ····

(prettier/prettier)


[error] 77-77: Delete ····

(prettier/prettier)


[error] 77-77: 'mockConsoleError' is already declared in the upper scope on line 12 column 9.

(no-shadow)


[error] 78-78: Delete ····

(prettier/prettier)


[error] 79-79: Delete ····

(prettier/prettier)


[error] 80-80: Delete ····

(prettier/prettier)


[error] 81-81: Replace ········ with ····

(prettier/prettier)


[error] 82-82: Delete ····

(prettier/prettier)


[error] 83-84: Replace ··});·⏎······· with });

(prettier/prettier)

scripts/markdown/check-markdown.js (1)

134-141: Improve script execution and error handling.

The script execution could be enhanced to properly handle errors and provide better feedback.

Consider wrapping the execution in an async function:

 const docsFolderPath = path.resolve(__dirname, '../../markdown/docs');
 const blogsFolderPath = path.resolve(__dirname, '../../markdown/blog');
 
-checkMarkdownFiles(docsFolderPath, validateDocs);
-checkMarkdownFiles(blogsFolderPath, validateBlogs);
+async function main() {
+    try {
+        await Promise.all([
+            checkMarkdownFiles(docsFolderPath, validateDocs),
+            checkMarkdownFiles(blogsFolderPath, validateBlogs)
+        ]);
+    } catch (err) {
+        console.error('Failed to check markdown files:', err);
+        process.exit(1);
+    }
+}
+
+if (require.main === module) {
+    main();
+}
 
 module.exports = { validateBlogs, validateDocs, checkMarkdownFiles };
🧰 Tools
🪛 eslint

[error] 141-141: Insert ;

(prettier/prettier)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between a9da240 and 4445ce5.

📒 Files selected for processing (2)
  • scripts/markdown/check-markdown.js (2 hunks)
  • tests/markdown/check-markdown.test.js (1 hunks)
🧰 Additional context used
📓 Learnings (1)
scripts/markdown/check-markdown.js (1)
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-10-18T17:28:41.718Z
Learning: In `scripts/markdown/check-markdown.js`, when processing large markdown files with recursion and loops, synchronous file reads (`fs.readFileSync`) are preferred over asynchronous reads.
🪛 GitHub Check: codecov/patch
scripts/markdown/check-markdown.js

[warning] 110-110: scripts/markdown/check-markdown.js#L110
Added line #L110 was not covered by tests

🪛 eslint
scripts/markdown/check-markdown.js

[error] 102-102: Delete ··

(prettier/prettier)


[error] 103-103: Replace ········ with ····

(prettier/prettier)


[error] 104-104: Delete ····

(prettier/prettier)


[error] 104-129: iterators/generators require regenerator-runtime, which is too heavyweight for this guide to allow them. Separately, loops should be avoided in favor of array iterations.

(no-restricted-syntax)


[error] 105-105: Replace ············ with ······

(prettier/prettier)


[error] 106-106: Delete ······

(prettier/prettier)


[error] 108-108: Replace ············ with ······

(prettier/prettier)


[error] 109-109: Delete ······

(prettier/prettier)


[error] 110-110: Replace ················ with ········

(prettier/prettier)


[error] 110-110: Unexpected use of continue statement.

(no-continue)


[error] 111-111: Delete ······

(prettier/prettier)


[error] 113-113: Replace ············ with ······

(prettier/prettier)


[error] 113-113: Unexpected await inside a loop.

(no-await-in-loop)


[error] 115-115: Delete ······

(prettier/prettier)


[error] 116-116: Replace ············ with ······

(prettier/prettier)


[error] 117-117: Delete ········

(prettier/prettier)


[error] 117-117: Unexpected await inside a loop.

(no-await-in-loop)


[error] 118-118: Replace ············ with ······

(prettier/prettier)


[error] 119-119: Replace ················ with ········

(prettier/prettier)


[error] 119-119: Unexpected await inside a loop.

(no-await-in-loop)


[error] 120-120: Delete ········

(prettier/prettier)


[error] 122-122: Replace ················ with ········

(prettier/prettier)


[error] 123-123: Replace ················ with ········

(prettier/prettier)


[error] 124-124: Delete ··········

(prettier/prettier)


[error] 125-125: Replace ····················errors.forEach(error with ··········errors.forEach((error)

(prettier/prettier)


[error] 126-126: Replace ···················· with ··········

(prettier/prettier)


[error] 127-127: Replace ················ with ········

(prettier/prettier)


[error] 128-128: Replace ············ with ······

(prettier/prettier)


[error] 129-129: Replace ········ with ····

(prettier/prettier)


[error] 130-130: Delete ··

(prettier/prettier)


[error] 131-131: Delete ····

(prettier/prettier)


[error] 132-132: Delete ··

(prettier/prettier)


[error] 141-141: Insert ;

(prettier/prettier)

tests/markdown/check-markdown.test.js

[error] 4-8: Replace ⏎····validateBlogs,⏎····validateDocs,⏎····checkMarkdownFiles⏎ with ·validateBlogs,·validateDocs,·checkMarkdownFiles·

(prettier/prettier)


[error] 11-11: Delete ··

(prettier/prettier)


[error] 12-12: Delete ··

(prettier/prettier)


[error] 14-14: Replace ···· with ··

(prettier/prettier)


[error] 15-15: Delete ····

(prettier/prettier)


[error] 16-16: Delete ····

(prettier/prettier)


[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 19-19: Delete ··

(prettier/prettier)


[error] 20-20: Replace ········ with ····

(prettier/prettier)


[error] 21-21: Replace ········ with ····

(prettier/prettier)


[error] 22-22: Delete ··

(prettier/prettier)


[error] 24-24: Delete ··

(prettier/prettier)


[error] 25-25: Delete ····

(prettier/prettier)


[error] 26-26: Delete ······

(prettier/prettier)


[error] 27-27: Replace ············ with ······

(prettier/prettier)


[error] 28-28: Delete ······

(prettier/prettier)


[error] 29-29: Replace ············ with ······

(prettier/prettier)


[error] 30-30: Replace ············ with ······

(prettier/prettier)


[error] 31-31: Delete ······

(prettier/prettier)


[error] 32-32: Delete ····

(prettier/prettier)


[error] 34-34: Delete ····

(prettier/prettier)


[error] 35-35: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 36-36: Replace ············ with ········

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 38-38: Replace ············ with ········

(prettier/prettier)


[error] 39-39: Replace ··]) with ])⏎····

(prettier/prettier)


[error] 40-40: Delete ··

(prettier/prettier)


[error] 42-42: Delete ··

(prettier/prettier)


[error] 43-43: Delete ····

(prettier/prettier)


[error] 44-44: Replace ········ with ····

(prettier/prettier)


[error] 45-47: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 48-48: Replace ········]) with ····

(prettier/prettier)


[error] 49-49: Delete ··

(prettier/prettier)


[error] 51-51: Delete ··

(prettier/prettier)


[error] 52-52: Delete ····

(prettier/prettier)


[error] 53-53: Replace ········ with ····

(prettier/prettier)


[error] 55-55: Delete ····

(prettier/prettier)


[error] 57-57: Delete ····

(prettier/prettier)


[error] 58-58: Replace ········ with ····

(prettier/prettier)


[error] 59-59: Delete ··

(prettier/prettier)


[error] 61-61: Delete ··

(prettier/prettier)


[error] 62-62: Replace ········ with ····

(prettier/prettier)


[error] 63-63: Delete ······

(prettier/prettier)


[error] 64-64: Replace ············ with ······

(prettier/prettier)


[error] 65-65: Replace ············ with ······

(prettier/prettier)


[error] 66-66: Delete ······

(prettier/prettier)


[error] 67-67: Replace ············ with ······

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ····

(prettier/prettier)


[error] 70-70: Delete ····

(prettier/prettier)


[error] 72-72: Replace ········ with ····

(prettier/prettier)


[error] 73-73: Delete ··

(prettier/prettier)


[error] 75-75: Delete ··

(prettier/prettier)


[error] 76-76: Replace ········ with ····

(prettier/prettier)


[error] 77-77: Delete ····

(prettier/prettier)


[error] 77-77: 'mockConsoleError' is already declared in the upper scope on line 12 column 9.

(no-shadow)


[error] 78-78: Delete ····

(prettier/prettier)


[error] 79-79: Delete ····

(prettier/prettier)


[error] 80-80: Delete ····

(prettier/prettier)


[error] 81-81: Replace ········ with ····

(prettier/prettier)


[error] 82-82: Delete ····

(prettier/prettier)


[error] 83-84: Replace ··});·⏎······· with });

(prettier/prettier)

🔇 Additional comments (1)
scripts/markdown/check-markdown.js (1)

1-1: 🛠️ Refactor suggestion

Consider using synchronous file operations.

A previous implementation (PR #3301) found that synchronous operations (fs.readFileSync) are preferred when processing large markdown files with recursion and loops. The current change to fs.promises might impact performance.

Let's verify the performance impact:

Consider reverting to synchronous operations:

-const fs = require('fs').promises;
+const fs = require('fs');

Comment on lines 11 to 13
let tempDir;
let mockConsoleError;

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Fix variable shadowing of mockConsoleError.

The mockConsoleError variable is already declared in the outer scope (line 12) but is redeclared in the test case (line 77). This could lead to confusion and potential issues.

Apply this fix:

 it('logs error to console when an error occurs in checkMarkdownFiles', async () => {
     const invalidFolderPath = path.join(tempDir, 'non-existent-folder');
-    const mockConsoleError = jest.spyOn(console, 'error').mockImplementation();

     await checkMarkdownFiles(invalidFolderPath, validateBlogs);

     expect(mockConsoleError.mock.calls[0][0]).toContain('Error processing files:');
-    mockConsoleError.mockRestore();
 });

Also applies to: 75-82

🧰 Tools
🪛 eslint

[error] 11-11: Delete ··

(prettier/prettier)


[error] 12-12: Delete ··

(prettier/prettier)

Comment on lines 101 to 132
async function checkMarkdownFiles(folderPath, validateFunction, relativePath = '') {
try {
const files = await fs.readdir(folderPath);
for (const file of files) {
const filePath = path.join(folderPath, file);
const relativeFilePath = path.join(relativePath, file);

// Skip the folder 'docs/reference/specification'
if (relativeFilePath.includes('reference/specification')) {
return;
continue;
}

fs.stat(filePath, (err, stats) => {
if (err) {
console.error('Error reading file stats:', err);
return;
}
const stats = await fs.stat(filePath);

// Recurse if directory, otherwise validate markdown file
if (stats.isDirectory()) {
await checkMarkdownFiles(filePath, validateFunction, relativeFilePath);
} else if (path.extname(file) === '.md') {
const fileContent = await fs.readFile(filePath, 'utf-8');
const { data: frontmatter } = matter(fileContent);

// Recurse if directory, otherwise validate markdown file
if (stats.isDirectory()) {
checkMarkdownFiles(filePath, validateFunction, relativeFilePath);
} else if (path.extname(file) === '.md') {
const fileContent = fs.readFileSync(filePath, 'utf-8');
const { data: frontmatter } = matter(fileContent);

const errors = validateFunction(frontmatter);
if (errors) {
console.log(`Errors in file ${relativeFilePath}:`);
errors.forEach(error => console.log(` - ${error}`));
process.exitCode = 1;
}
const errors = validateFunction(frontmatter);
if (errors) {
console.log(`Errors in file ${relativeFilePath}:`);
errors.forEach(error => console.log(` - ${error}`));
process.exitCode = 1;
}
});
});
});
}
}
} catch (err) {
console.error('Error processing files:', err);
}
Copy link

@coderabbitai coderabbitai bot Nov 11, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

Enhance error handling and optimize async operations.

Several improvements could be made to this function:

  1. The error handling is too generic
  2. Multiple await operations inside the loop could impact performance
  3. The 'reference/specification' skip condition needs test coverage

Consider these improvements:

 async function checkMarkdownFiles(folderPath, validateFunction, relativePath = '') {
     try {
         const files = await fs.readdir(folderPath);
+        const filePromises = files.map(async file => {
             const filePath = path.join(folderPath, file);
             const relativeFilePath = path.join(relativePath, file);
 
             if (relativeFilePath.includes('reference/specification')) {
                 return;
             }
 
-            const stats = await fs.stat(filePath);
+            try {
+                const stats = await fs.stat(filePath);
 
-            if (stats.isDirectory()) {
-                await checkMarkdownFiles(filePath, validateFunction, relativeFilePath);
-            } else if (path.extname(file) === '.md') {
-                const fileContent = await fs.readFile(filePath, 'utf-8');
-                const { data: frontmatter } = matter(fileContent);
+                if (stats.isDirectory()) {
+                    await checkMarkdownFiles(filePath, validateFunction, relativeFilePath);
+                } else if (path.extname(file) === '.md') {
+                    const fileContent = await fs.readFile(filePath, 'utf-8');
+                    const { data: frontmatter } = matter(fileContent);
 
-                const errors = validateFunction(frontmatter);
-                if (errors) {
-                    console.log(`Errors in file ${relativeFilePath}:`);
-                    errors.forEach(error => console.log(` - ${error}`));
-                    process.exitCode = 1;
+                    const errors = validateFunction(frontmatter);
+                    if (errors) {
+                        console.log(`Errors in file ${relativeFilePath}:`);
+                        errors.forEach(error => console.log(` - ${error}`));
+                        process.exitCode = 1;
+                    }
                 }
+            } catch (err) {
+                console.error(`Error processing file ${relativeFilePath}:`, err);
+                throw err;
             }
-        }
+        });
+        await Promise.all(filePromises);
     } catch (err) {
-        console.error('Error processing files:', err);
+        console.error(`Error in directory ${folderPath}:`, err);
+        throw err;
     }
 }
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
async function checkMarkdownFiles(folderPath, validateFunction, relativePath = '') {
try {
const files = await fs.readdir(folderPath);
for (const file of files) {
const filePath = path.join(folderPath, file);
const relativeFilePath = path.join(relativePath, file);
// Skip the folder 'docs/reference/specification'
if (relativeFilePath.includes('reference/specification')) {
return;
continue;
}
fs.stat(filePath, (err, stats) => {
if (err) {
console.error('Error reading file stats:', err);
return;
}
const stats = await fs.stat(filePath);
// Recurse if directory, otherwise validate markdown file
if (stats.isDirectory()) {
await checkMarkdownFiles(filePath, validateFunction, relativeFilePath);
} else if (path.extname(file) === '.md') {
const fileContent = await fs.readFile(filePath, 'utf-8');
const { data: frontmatter } = matter(fileContent);
// Recurse if directory, otherwise validate markdown file
if (stats.isDirectory()) {
checkMarkdownFiles(filePath, validateFunction, relativeFilePath);
} else if (path.extname(file) === '.md') {
const fileContent = fs.readFileSync(filePath, 'utf-8');
const { data: frontmatter } = matter(fileContent);
const errors = validateFunction(frontmatter);
if (errors) {
console.log(`Errors in file ${relativeFilePath}:`);
errors.forEach(error => console.log(` - ${error}`));
process.exitCode = 1;
}
const errors = validateFunction(frontmatter);
if (errors) {
console.log(`Errors in file ${relativeFilePath}:`);
errors.forEach(error => console.log(` - ${error}`));
process.exitCode = 1;
}
});
});
});
}
}
} catch (err) {
console.error('Error processing files:', err);
}
async function checkMarkdownFiles(folderPath, validateFunction, relativePath = '') {
try {
const files = await fs.readdir(folderPath);
const filePromises = files.map(async file => {
const filePath = path.join(folderPath, file);
const relativeFilePath = path.join(relativePath, file);
if (relativeFilePath.includes('reference/specification')) {
return;
}
try {
const stats = await fs.stat(filePath);
if (stats.isDirectory()) {
await checkMarkdownFiles(filePath, validateFunction, relativeFilePath);
} else if (path.extname(file) === '.md') {
const fileContent = await fs.readFile(filePath, 'utf-8');
const { data: frontmatter } = matter(fileContent);
const errors = validateFunction(frontmatter);
if (errors) {
console.log(`Errors in file ${relativeFilePath}:`);
errors.forEach(error => console.log(` - ${error}`));
process.exitCode = 1;
}
}
} catch (err) {
console.error(`Error processing file ${relativeFilePath}:`, err);
throw err;
}
});
await Promise.all(filePromises);
} catch (err) {
console.error(`Error in directory ${folderPath}:`, err);
throw err;
}
}
🧰 Tools
🪛 GitHub Check: codecov/patch

[warning] 110-110: scripts/markdown/check-markdown.js#L110
Added line #L110 was not covered by tests

🪛 eslint

[error] 102-102: Delete ··

(prettier/prettier)


[error] 103-103: Replace ········ with ····

(prettier/prettier)


[error] 104-104: Delete ····

(prettier/prettier)


[error] 104-129: iterators/generators require regenerator-runtime, which is too heavyweight for this guide to allow them. Separately, loops should be avoided in favor of array iterations.

(no-restricted-syntax)


[error] 105-105: Replace ············ with ······

(prettier/prettier)


[error] 106-106: Delete ······

(prettier/prettier)


[error] 108-108: Replace ············ with ······

(prettier/prettier)


[error] 109-109: Delete ······

(prettier/prettier)


[error] 110-110: Replace ················ with ········

(prettier/prettier)


[error] 110-110: Unexpected use of continue statement.

(no-continue)


[error] 111-111: Delete ······

(prettier/prettier)


[error] 113-113: Replace ············ with ······

(prettier/prettier)


[error] 113-113: Unexpected await inside a loop.

(no-await-in-loop)


[error] 115-115: Delete ······

(prettier/prettier)


[error] 116-116: Replace ············ with ······

(prettier/prettier)


[error] 117-117: Delete ········

(prettier/prettier)


[error] 117-117: Unexpected await inside a loop.

(no-await-in-loop)


[error] 118-118: Replace ············ with ······

(prettier/prettier)


[error] 119-119: Replace ················ with ········

(prettier/prettier)


[error] 119-119: Unexpected await inside a loop.

(no-await-in-loop)


[error] 120-120: Delete ········

(prettier/prettier)


[error] 122-122: Replace ················ with ········

(prettier/prettier)


[error] 123-123: Replace ················ with ········

(prettier/prettier)


[error] 124-124: Delete ··········

(prettier/prettier)


[error] 125-125: Replace ····················errors.forEach(error with ··········errors.forEach((error)

(prettier/prettier)


[error] 126-126: Replace ···················· with ··········

(prettier/prettier)


[error] 127-127: Replace ················ with ········

(prettier/prettier)


[error] 128-128: Replace ············ with ······

(prettier/prettier)


[error] 129-129: Replace ········ with ····

(prettier/prettier)


[error] 130-130: Delete ··

(prettier/prettier)


[error] 131-131: Delete ····

(prettier/prettier)


[error] 132-132: Delete ··

(prettier/prettier)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vishvamsinh28 Can you apply this suggestion?

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Seems like the humans are having a chat. I'll hop back into my burrow for now. If you need me again, just tag @coderabbitai in a new comment, and I'll come hopping out!

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@vishvamsinh28
Copy link
Contributor Author

@akshatnema Please review this PR.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (2)
tests/markdown/check-markdown.test.js (2)

42-49: Enhance docs frontmatter validation test coverage.

Consider adding more edge cases to thoroughly test the validation:

  • Empty string for title
  • Negative or decimal values for weight
  • Missing fields
 it('validates docs frontmatter for required fields', async () => {
-    const frontmatter = { title: 123, weight: 'not-a-number' };
+    const testCases = [
+      { frontmatter: { title: 123, weight: 'not-a-number' }, expectedError: 'Title is missing or not a string' },
+      { frontmatter: { title: '', weight: 1 }, expectedError: 'Title cannot be empty' },
+      { frontmatter: { title: 'Valid', weight: -1 }, expectedError: 'Weight must be a positive number' },
+      { frontmatter: {}, expectedError: 'Title is required' }
+    ];
+
+    for (const { frontmatter, expectedError } of testCases) {
+      const errors = validateDocs(frontmatter);
+      expect(errors).toContain(expectedError);
+    }
 });
🧰 Tools
🪛 eslint

[error] 42-42: Delete ··

(prettier/prettier)


[error] 43-43: Replace ········ with ····

(prettier/prettier)


[error] 44-44: Replace ········ with ····

(prettier/prettier)


[error] 45-47: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 48-48: Delete ····])

(prettier/prettier)


[error] 49-49: Replace ···· with ··

(prettier/prettier)


61-73: Make validation error expectations more specific.

The current test only checks the number of errors. Consider asserting specific error messages to ensure the validation logic is working as expected.

 it('returns multiple validation errors for invalid blog frontmatter', async () => {
     const frontmatter = {
         title: 123,
         date: 'invalid-date',
         type: 'blog',
         tags: 'not-an-array',
         cover: ['not-a-string'],
         authors: { name: 'John Doe' }
     };
     const errors = validateBlogs(frontmatter);

-    expect(errors.length).toBeGreaterThan(3);
+    expect(errors).toEqual(expect.arrayContaining([
+        'Title must be a string',
+        'Date must be a valid date string',
+        'Tags must be an array',
+        'Cover must be a string',
+        'Authors must be an array'
+    ]));
 });
🧰 Tools
🪛 eslint

[error] 61-61: Replace ···· with ··

(prettier/prettier)


[error] 62-62: Delete ····

(prettier/prettier)


[error] 63-63: Replace ············ with ······

(prettier/prettier)


[error] 64-64: Delete ······

(prettier/prettier)


[error] 65-65: Replace ············ with ······

(prettier/prettier)


[error] 66-66: Replace ············ with ······

(prettier/prettier)


[error] 67-67: Delete ······

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ····

(prettier/prettier)


[error] 70-70: Replace ········ with ····

(prettier/prettier)


[error] 72-72: Replace ········ with ····

(prettier/prettier)


[error] 73-73: Delete ··

(prettier/prettier)

📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 4445ce5 and 333e0b2.

📒 Files selected for processing (1)
  • tests/markdown/check-markdown.test.js (1 hunks)
🧰 Additional context used
🪛 eslint
tests/markdown/check-markdown.test.js

[error] 4-8: Replace ⏎····validateBlogs,⏎····validateDocs,⏎····checkMarkdownFiles⏎ with ·validateBlogs,·validateDocs,·checkMarkdownFiles·

(prettier/prettier)


[error] 11-11: Delete ··

(prettier/prettier)


[error] 12-12: Delete ··

(prettier/prettier)


[error] 14-14: Replace ···· with ··

(prettier/prettier)


[error] 15-15: Delete ····

(prettier/prettier)


[error] 16-16: Delete ····

(prettier/prettier)


[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 19-19: Delete ··

(prettier/prettier)


[error] 20-20: Replace ········ with ····

(prettier/prettier)


[error] 21-21: Replace ········ with ····

(prettier/prettier)


[error] 22-22: Delete ··

(prettier/prettier)


[error] 24-24: Delete ··

(prettier/prettier)


[error] 25-25: Delete ····

(prettier/prettier)


[error] 26-26: Delete ······

(prettier/prettier)


[error] 27-27: Replace ············ with ······

(prettier/prettier)


[error] 28-28: Delete ······

(prettier/prettier)


[error] 29-29: Delete ······

(prettier/prettier)


[error] 30-30: Replace ············ with ······

(prettier/prettier)


[error] 31-31: Delete ······

(prettier/prettier)


[error] 32-32: Delete ····

(prettier/prettier)


[error] 34-34: Delete ····

(prettier/prettier)


[error] 35-35: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 36-36: Delete ····

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 38-38: Replace ············ with ········

(prettier/prettier)


[error] 39-39: Replace ··]) with ])⏎····

(prettier/prettier)


[error] 40-40: Delete ··

(prettier/prettier)


[error] 42-42: Delete ··

(prettier/prettier)


[error] 43-43: Replace ········ with ····

(prettier/prettier)


[error] 44-44: Replace ········ with ····

(prettier/prettier)


[error] 45-47: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 48-48: Delete ····])

(prettier/prettier)


[error] 49-49: Replace ···· with ··

(prettier/prettier)


[error] 51-51: Delete ··

(prettier/prettier)


[error] 52-52: Delete ····

(prettier/prettier)


[error] 53-53: Delete ····

(prettier/prettier)


[error] 55-55: Delete ····

(prettier/prettier)


[error] 57-57: Replace ········ with ····

(prettier/prettier)


[error] 58-58: Delete ····

(prettier/prettier)


[error] 59-59: Delete ··

(prettier/prettier)


[error] 61-61: Replace ···· with ··

(prettier/prettier)


[error] 62-62: Delete ····

(prettier/prettier)


[error] 63-63: Replace ············ with ······

(prettier/prettier)


[error] 64-64: Delete ······

(prettier/prettier)


[error] 65-65: Replace ············ with ······

(prettier/prettier)


[error] 66-66: Replace ············ with ······

(prettier/prettier)


[error] 67-67: Delete ······

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ····

(prettier/prettier)


[error] 70-70: Replace ········ with ····

(prettier/prettier)


[error] 72-72: Replace ········ with ····

(prettier/prettier)


[error] 73-73: Delete ··

(prettier/prettier)


[error] 75-75: Delete ··

(prettier/prettier)


[error] 76-76: Delete ····

(prettier/prettier)


[error] 77-77: Delete ····

(prettier/prettier)


[error] 77-77: 'mockConsoleError' is already declared in the upper scope on line 12 column 9.

(no-shadow)


[error] 78-78: Delete ····

(prettier/prettier)


[error] 79-79: Delete ····

(prettier/prettier)


[error] 80-80: Delete ····

(prettier/prettier)


[error] 81-81: Delete ····

(prettier/prettier)


[error] 82-82: Delete ····

(prettier/prettier)


[error] 83-83: Replace ··});····· with });

(prettier/prettier)

🔇 Additional comments (2)
tests/markdown/check-markdown.test.js (2)

14-22: LGTM! Well-structured test lifecycle hooks.

The setup and teardown logic is well implemented with proper async handling and cleanup.

🧰 Tools
🪛 eslint

[error] 14-14: Replace ···· with ··

(prettier/prettier)


[error] 15-15: Delete ····

(prettier/prettier)


[error] 16-16: Delete ····

(prettier/prettier)


[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 19-19: Delete ··

(prettier/prettier)


[error] 20-20: Replace ········ with ····

(prettier/prettier)


[error] 21-21: Replace ········ with ····

(prettier/prettier)


[error] 22-22: Delete ··

(prettier/prettier)


11-13: ⚠️ Potential issue

Fix variable shadowing of mockConsoleError.

The mockConsoleError variable is already declared in the outer scope and is shadowed in a test case below (line 77). This could lead to confusion and potential issues.

🧰 Tools
🪛 eslint

[error] 11-11: Delete ··

(prettier/prettier)


[error] 12-12: Delete ··

(prettier/prettier)

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (2)
scripts/markdown/check-markdown.js (2)

146-156: Add input validation for folder paths

While the error handling is good, consider adding validation for the folder paths to prevent potential issues.

 async function main() {
+    if (!fs.access(docsFolderPath) || !fs.access(blogsFolderPath)) {
+        throw new Error('Invalid folder paths provided');
+    }
     try {
         await Promise.all([
             checkMarkdownFiles(docsFolderPath, validateDocs),
             checkMarkdownFiles(blogsFolderPath, validateBlogs)
         ]);
     } catch (error) {
         console.error('Failed to validate markdown files:', error);
         process.exit(1);
     }
 }
🧰 Tools
🪛 eslint

[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Replace ········ with ····

(prettier/prettier)


[error] 149-149: Delete ······

(prettier/prettier)


[error] 150-150: Replace ············ with ······

(prettier/prettier)


[error] 151-151: Replace ········ with ····

(prettier/prettier)


[error] 152-152: Delete ··

(prettier/prettier)


[error] 153-153: Delete ····

(prettier/prettier)


[error] 154-154: Delete ····

(prettier/prettier)


[error] 155-155: Delete ··

(prettier/prettier)


158-160: Consider conditional execution of main function

The immediate execution of the main function might interfere with testing. Consider executing only when the file is run directly.

-main();
+if (require.main === module) {
+    main();
+}

 module.exports = { validateBlogs, validateDocs, checkMarkdownFiles, main };
🧰 Tools
🪛 eslint

[error] 160-160: Insert ;

(prettier/prettier)

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 4558748 and 29cd78c.

📒 Files selected for processing (1)
  • scripts/markdown/check-markdown.js (4 hunks)
🧰 Additional context used
📓 Learnings (1)
scripts/markdown/check-markdown.js (4)
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:41:29.632Z
Learning: When updating workflows for the AsyncAPI website repository, use `.github/workflows/if-nodejs-pr-testing.yml` to include environment variables and secrets for Node.js PR testing.
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:34:51.303Z
Learning: When reviewing `scripts/markdown/check-markdown.js`, optimizations should be addressed in separate issues and not included in the current pull request.
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-11-12T06:59:33.851Z
Learning: In `scripts/markdown/check-markdown.js`, when processing large markdown files with recursion and loops, synchronous file reads (`fs.readFileSync`) are preferred over asynchronous reads.
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-11-12T06:59:33.852Z
Learning: In `scripts/markdown/check-markdown.js`, the script is not run in an asynchronous environment, so refactoring it to use `async/await` is unnecessary.
🪛 eslint
scripts/markdown/check-markdown.js

[error] 102-102: Replace ···· with ··

(prettier/prettier)


[error] 103-103: Delete ····

(prettier/prettier)


[error] 104-104: Replace ········ with ····

(prettier/prettier)


[error] 113-113: Delete ······

(prettier/prettier)


[error] 114-114: Delete ········

(prettier/prettier)


[error] 116-116: Delete ········

(prettier/prettier)


[error] 117-117: Replace ················ with ········

(prettier/prettier)


[error] 118-118: Delete ··········

(prettier/prettier)


[error] 119-119: Replace ················ with ········

(prettier/prettier)


[error] 120-120: Delete ··········

(prettier/prettier)


[error] 130-130: Replace ············ with ······

(prettier/prettier)


[error] 131-131: Delete ········

(prettier/prettier)


[error] 132-132: Delete ········

(prettier/prettier)


[error] 133-133: Delete ······

(prettier/prettier)


[error] 134-134: Replace ········ with ····

(prettier/prettier)


[error] 136-136: Delete ····

(prettier/prettier)


[error] 137-137: Delete ··

(prettier/prettier)


[error] 138-138: Delete ····

(prettier/prettier)


[error] 139-139: Delete ····

(prettier/prettier)


[error] 140-140: Delete ··

(prettier/prettier)


[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Replace ········ with ····

(prettier/prettier)


[error] 149-149: Delete ······

(prettier/prettier)


[error] 150-150: Replace ············ with ······

(prettier/prettier)


[error] 151-151: Replace ········ with ····

(prettier/prettier)


[error] 152-152: Delete ··

(prettier/prettier)


[error] 153-153: Delete ····

(prettier/prettier)


[error] 154-154: Delete ····

(prettier/prettier)


[error] 155-155: Delete ··

(prettier/prettier)


[error] 160-160: Insert ;

(prettier/prettier)

🔇 Additional comments (2)
scripts/markdown/check-markdown.js (2)

1-1: LGTM: Appropriate use of fs.promises

The switch to fs.promises is consistent with the async/await pattern used throughout the file.


Line range hint 101-140: LGTM: Well-structured async implementation with proper error handling

The async implementation includes:

  • Proper error handling with try-catch blocks
  • Clear error messages with file paths
  • Appropriate error propagation

Let's verify the error handling:

✅ Verification successful

Let me gather more information about the error handling patterns in the codebase to ensure consistency.


Error handling implementation is robust and consistent

The error handling implementation follows a consistent pattern throughout the file:

  • Proper error logging with contextual information (file paths)
  • Appropriate error propagation via throw statements
  • Clear distinction between validation errors (console.log) and processing errors (console.error)
  • Nested try-catch blocks handle errors at both file and directory levels
  • Process exit code is set appropriately for validation failures
🏁 Scripts executed

The following scripts were executed for the analysis:

Script:

#!/bin/bash
# Check if error handling is consistent across the codebase
rg -A 2 "console.error.*Error.*processing" .

Length of output: 280


Script:

#!/bin/bash
# Check for error handling patterns in the codebase
rg -A 2 "console\.(error|log).*Error" .

# Check for similar file processing functions
ast-grep --pattern 'async function $_(folderPath, $$$) {
  try {
    $$$
  } catch (err) {
    $$$
  }
}'

Length of output: 4427

🧰 Tools
🪛 eslint

[error] 110-110: Delete ········

(prettier/prettier)


[error] 111-111: Delete ······

(prettier/prettier)


[error] 113-113: Delete ······

(prettier/prettier)


[error] 114-114: Delete ········

(prettier/prettier)


[error] 116-116: Delete ········

(prettier/prettier)


[error] 117-117: Replace ················ with ········

(prettier/prettier)


[error] 118-118: Delete ··········

(prettier/prettier)


[error] 119-119: Replace ················ with ········

(prettier/prettier)


[error] 120-120: Delete ··········

(prettier/prettier)


[error] 121-121: Replace ···················· with ··········

(prettier/prettier)


[error] 123-123: Replace ···················· with ··········

(prettier/prettier)

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🧹 Outside diff range and nitpick comments (2)
scripts/markdown/check-markdown.js (2)

Line range hint 104-136: Consider batching file operations

While using Promise.all with map allows for parallel processing, it might lead to resource exhaustion with a large number of files. Consider processing files in batches.

-        const filePromises = files.map(async (file) => {
+        const batchSize = 10;
+        for (let i = 0; i < files.length; i += batchSize) {
+            const batch = files.slice(i, i + batchSize);
+            const filePromises = batch.map(async (file) => {
🧰 Tools
🪛 eslint

[error] 110-110: Replace ················ with ········

(prettier/prettier)


[error] 111-111: Replace ············ with ······

(prettier/prettier)


[error] 113-113: Replace ············ with ······

(prettier/prettier)


[error] 114-114: Delete ········

(prettier/prettier)


[error] 116-116: Replace ················ with ········

(prettier/prettier)


[error] 117-117: Delete ········

(prettier/prettier)


[error] 118-118: Replace ···················· with ··········

(prettier/prettier)


[error] 119-119: Delete ········

(prettier/prettier)


[error] 120-120: Replace ···················· with ··········

(prettier/prettier)


[error] 121-121: Replace ···················· with ··········

(prettier/prettier)


[error] 123-123: Delete ··········

(prettier/prettier)


161-166: Add missing semicolon

Add a semicolon after the module.exports statement to maintain consistency with the codebase style.

-module.exports = { validateBlogs, validateDocs, checkMarkdownFiles, main }
+module.exports = { validateBlogs, validateDocs, checkMarkdownFiles, main };
🧰 Tools
🪛 eslint

[error] 163-163: Delete ··

(prettier/prettier)


[error] 166-166: Insert ;

(prettier/prettier)

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 29cd78c and 8d9221b.

📒 Files selected for processing (1)
  • scripts/markdown/check-markdown.js (4 hunks)
🧰 Additional context used
📓 Learnings (1)
scripts/markdown/check-markdown.js (4)
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:41:29.632Z
Learning: When updating workflows for the AsyncAPI website repository, use `.github/workflows/if-nodejs-pr-testing.yml` to include environment variables and secrets for Node.js PR testing.
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:34:51.303Z
Learning: When reviewing `scripts/markdown/check-markdown.js`, optimizations should be addressed in separate issues and not included in the current pull request.
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-11-12T06:59:33.851Z
Learning: In `scripts/markdown/check-markdown.js`, when processing large markdown files with recursion and loops, synchronous file reads (`fs.readFileSync`) are preferred over asynchronous reads.
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-11-12T06:59:33.852Z
Learning: In `scripts/markdown/check-markdown.js`, the script is not run in an asynchronous environment, so refactoring it to use `async/await` is unnecessary.
🪛 eslint
scripts/markdown/check-markdown.js

[error] 102-102: Delete ··

(prettier/prettier)


[error] 103-103: Replace ········ with ····

(prettier/prettier)


[error] 104-104: Delete ····

(prettier/prettier)


[error] 113-113: Replace ············ with ······

(prettier/prettier)


[error] 114-114: Delete ········

(prettier/prettier)


[error] 116-116: Replace ················ with ········

(prettier/prettier)


[error] 117-117: Delete ········

(prettier/prettier)


[error] 118-118: Replace ···················· with ··········

(prettier/prettier)


[error] 119-119: Delete ········

(prettier/prettier)


[error] 120-120: Replace ···················· with ··········

(prettier/prettier)


[error] 130-130: Delete ······

(prettier/prettier)


[error] 131-131: Delete ········

(prettier/prettier)


[error] 132-132: Delete ········

(prettier/prettier)


[error] 133-133: Replace ············ with ······

(prettier/prettier)


[error] 134-134: Replace ········ with ····

(prettier/prettier)


[error] 136-136: Delete ····

(prettier/prettier)


[error] 137-137: Delete ··

(prettier/prettier)


[error] 138-138: Replace ········ with ····

(prettier/prettier)


[error] 139-139: Delete ····

(prettier/prettier)


[error] 140-140: Replace ···· with ··

(prettier/prettier)


[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Delete ····

(prettier/prettier)


[error] 149-149: Replace ···· with ··

(prettier/prettier)


[error] 150-150: Delete ··

(prettier/prettier)


[error] 151-151: Delete ····

(prettier/prettier)


[error] 152-152: Delete ······

(prettier/prettier)


[error] 153-153: Replace ············ with ······

(prettier/prettier)


[error] 154-154: Delete ····

(prettier/prettier)


[error] 155-155: Delete ··

(prettier/prettier)


[error] 156-156: Delete ····

(prettier/prettier)


[error] 157-157: Replace ········ with ····

(prettier/prettier)


[error] 158-158: Delete ··

(prettier/prettier)


[error] 163-163: Delete ··

(prettier/prettier)


[error] 166-166: Insert ;

(prettier/prettier)

🪛 GitHub Check: codecov/patch
scripts/markdown/check-markdown.js

[warning] 148-148: scripts/markdown/check-markdown.js#L148
Added line #L148 was not covered by tests

🔇 Additional comments (1)
scripts/markdown/check-markdown.js (1)

1-1: LGTM: Appropriate use of fs.promises

The switch to fs.promises aligns well with the async/await pattern used throughout the file.

Comment on lines 147 to 149
if (!fs.access(docsFolderPath) || !fs.access(blogsFolderPath)) {
throw new Error('Invalid folder paths provided');
}
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue

Fix incorrect fs.access usage

The current implementation of fs.access is incorrect and will always evaluate to true. Additionally, this line is not covered by tests.

-    if (!fs.access(docsFolderPath) || !fs.access(blogsFolderPath)) {
-        throw new Error('Invalid folder paths provided');
-    }
+    try {
+        await Promise.all([
+            fs.access(docsFolderPath),
+            fs.access(blogsFolderPath)
+        ]);
+    } catch (error) {
+        throw new Error('Invalid folder paths provided');
+    }
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
if (!fs.access(docsFolderPath) || !fs.access(blogsFolderPath)) {
throw new Error('Invalid folder paths provided');
}
try {
await Promise.all([
fs.access(docsFolderPath),
fs.access(blogsFolderPath)
]);
} catch (error) {
throw new Error('Invalid folder paths provided');
}
🧰 Tools
🪛 eslint

[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Delete ····

(prettier/prettier)


[error] 149-149: Replace ···· with ··

(prettier/prettier)

🪛 GitHub Check: codecov/patch

[warning] 148-148: scripts/markdown/check-markdown.js#L148
Added line #L148 was not covered by tests

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (2)
scripts/markdown/check-markdown.js (1)

Line range hint 101-140: Consider adding concurrency control for parallel file processing.

The current implementation processes all files in parallel using Promise.all, which could lead to resource exhaustion with a large number of files. However, based on previous learnings, this optimization should be tracked in a separate issue.

🧰 Tools
🪛 eslint

[error] 110-110: Delete ········

(prettier/prettier)


[error] 111-111: Delete ······

(prettier/prettier)


[error] 113-113: Delete ······

(prettier/prettier)


[error] 114-114: Delete ········

(prettier/prettier)


[error] 116-116: Replace ················ with ········

(prettier/prettier)


[error] 117-117: Delete ········

(prettier/prettier)


[error] 118-118: Replace ···················· with ··········

(prettier/prettier)


[error] 119-119: Replace ················ with ········

(prettier/prettier)


[error] 120-120: Delete ··········

(prettier/prettier)


[error] 121-121: Replace ···················· with ··········

(prettier/prettier)


[error] 123-123: Replace ···················· with ··········

(prettier/prettier)

tests/markdown/check-markdown.test.js (1)

134-139: Add semicolon to the assertion.

-    expect(mockConsoleError).not.toHaveBeenCalledWith()
+    expect(mockConsoleError).not.toHaveBeenCalledWith();
🧰 Tools
🪛 eslint

[error] 134-134: Delete ··

(prettier/prettier)


[error] 135-136: Delete ⏎····

(prettier/prettier)


[error] 138-138: Replace ········expect(mockConsoleError).not.toHaveBeenCalledWith() with ····expect(mockConsoleError).not.toHaveBeenCalledWith();

(prettier/prettier)


[error] 139-139: Delete ··

(prettier/prettier)

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between 8d9221b and f595339.

📒 Files selected for processing (2)
  • scripts/markdown/check-markdown.js (4 hunks)
  • tests/markdown/check-markdown.test.js (1 hunks)
🧰 Additional context used
📓 Learnings (2)
scripts/markdown/check-markdown.js (4)
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:41:29.632Z
Learning: When updating workflows for the AsyncAPI website repository, use `.github/workflows/if-nodejs-pr-testing.yml` to include environment variables and secrets for Node.js PR testing.
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:34:51.303Z
Learning: When reviewing `scripts/markdown/check-markdown.js`, optimizations should be addressed in separate issues and not included in the current pull request.
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-11-12T06:59:33.851Z
Learning: In `scripts/markdown/check-markdown.js`, when processing large markdown files with recursion and loops, synchronous file reads (`fs.readFileSync`) are preferred over asynchronous reads.
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-11-12T06:59:33.852Z
Learning: In `scripts/markdown/check-markdown.js`, the script is not run in an asynchronous environment, so refactoring it to use `async/await` is unnecessary.
tests/markdown/check-markdown.test.js (1)
Learnt from: vishvamsinh28
PR: asyncapi/website#3378
File: tests/markdown/check-markdown.test.js:133-138
Timestamp: 2024-11-29T17:36:09.783Z
Learning: When testing the 'main' function in 'check-markdown.test.js', it's acceptable to simply ensure it doesn't throw any errors, as the functions it calls are already tested elsewhere.
🪛 eslint
scripts/markdown/check-markdown.js

[error] 102-102: Delete ··

(prettier/prettier)


[error] 103-103: Delete ····

(prettier/prettier)


[error] 104-104: Delete ····

(prettier/prettier)


[error] 113-113: Delete ······

(prettier/prettier)


[error] 114-114: Delete ········

(prettier/prettier)


[error] 116-116: Replace ················ with ········

(prettier/prettier)


[error] 117-117: Delete ········

(prettier/prettier)


[error] 118-118: Replace ···················· with ··········

(prettier/prettier)


[error] 119-119: Replace ················ with ········

(prettier/prettier)


[error] 120-120: Delete ··········

(prettier/prettier)


[error] 130-130: Delete ······

(prettier/prettier)


[error] 131-131: Delete ········

(prettier/prettier)


[error] 132-132: Delete ········

(prettier/prettier)


[error] 133-133: Replace ············ with ······

(prettier/prettier)


[error] 134-134: Delete ····

(prettier/prettier)


[error] 136-136: Delete ····

(prettier/prettier)


[error] 137-137: Delete ··

(prettier/prettier)


[error] 138-138: Replace ········ with ····

(prettier/prettier)


[error] 139-139: Delete ····

(prettier/prettier)


[error] 140-140: Delete ··

(prettier/prettier)


[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Delete ····

(prettier/prettier)


[error] 149-149: Replace ············ with ······

(prettier/prettier)


[error] 150-150: Replace ············ with ······

(prettier/prettier)


[error] 151-151: Delete ····

(prettier/prettier)


[error] 152-152: Delete ··

(prettier/prettier)


[error] 153-153: Delete ····

(prettier/prettier)


[error] 154-154: Replace ········ with ····

(prettier/prettier)


[error] 155-155: Delete ··

(prettier/prettier)


[error] 160-160: Delete ··

(prettier/prettier)


[error] 163-163: Insert ;

(prettier/prettier)

tests/markdown/check-markdown.test.js

[error] 5-5: Delete ··

(prettier/prettier)


[error] 6-6: Delete ··

(prettier/prettier)


[error] 7-7: Replace ···· with ··

(prettier/prettier)


[error] 8-8: Replace ···· with ··

(prettier/prettier)


[error] 9-9: Replace ···· with ··

(prettier/prettier)


[error] 13-13: Delete ··

(prettier/prettier)


[error] 14-14: Delete ··

(prettier/prettier)


[error] 15-15: Delete ··

(prettier/prettier)


[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 18-18: Delete ····

(prettier/prettier)


[error] 19-19: Replace ········ with ····

(prettier/prettier)


[error] 20-20: Replace ········ with ····

(prettier/prettier)


[error] 21-21: Delete ··

(prettier/prettier)


[error] 23-23: Replace ···· with ··

(prettier/prettier)


[error] 24-24: Delete ····

(prettier/prettier)


[error] 25-25: Delete ····

(prettier/prettier)


[error] 26-26: Delete ····

(prettier/prettier)


[error] 27-27: Delete ··

(prettier/prettier)


[error] 29-29: Delete ··

(prettier/prettier)


[error] 30-30: Delete ····

(prettier/prettier)


[error] 31-31: Replace ············ with ······

(prettier/prettier)


[error] 32-32: Delete ······

(prettier/prettier)


[error] 33-33: Delete ······

(prettier/prettier)


[error] 34-34: Replace ············ with ······

(prettier/prettier)


[error] 35-35: Replace ············ with ······

(prettier/prettier)


[error] 36-36: Delete ······

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 39-39: Delete ····

(prettier/prettier)


[error] 40-40: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 41-41: Delete ····

(prettier/prettier)


[error] 42-42: Replace ············ with ········

(prettier/prettier)


[error] 43-43: Delete ····

(prettier/prettier)


[error] 44-44: Replace ········])); with ······])

(prettier/prettier)


[error] 45-45: Insert );⏎··

(prettier/prettier)


[error] 47-47: Replace ···· with ··

(prettier/prettier)


[error] 48-48: Delete ····

(prettier/prettier)


[error] 49-49: Delete ····

(prettier/prettier)


[error] 50-52: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 53-53: Replace ········]) with ····

(prettier/prettier)


[error] 54-54: Delete ··

(prettier/prettier)


[error] 56-56: Delete ··

(prettier/prettier)


[error] 57-57: Delete ····

(prettier/prettier)


[error] 58-58: Delete ····

(prettier/prettier)


[error] 60-60: Delete ····

(prettier/prettier)


[error] 62-62: Delete ····

(prettier/prettier)


[error] 63-63: Replace ········ with ····

(prettier/prettier)


[error] 64-64: Delete ··

(prettier/prettier)


[error] 66-66: Delete ··

(prettier/prettier)


[error] 67-67: Replace ········ with ····

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ······

(prettier/prettier)


[error] 70-70: Replace ············ with ······

(prettier/prettier)


[error] 71-71: Replace ············ with ······

(prettier/prettier)


[error] 72-72: Replace ············ with ······

(prettier/prettier)


[error] 73-73: Delete ······

(prettier/prettier)


[error] 74-74: Replace ········ with ····

(prettier/prettier)


[error] 75-75: Delete ····

(prettier/prettier)


[error] 77-77: Replace ········ with ····

(prettier/prettier)


[error] 78-78: Replace ······"Invalid·date·format:·invalid-date" with 'Invalid·date·format:·invalid-date'

(prettier/prettier)


[error] 79-79: Replace ······"Tags·should·be·an·array" with 'Tags·should·be·an·array'

(prettier/prettier)


[error] 80-80: Replace ············"Cover·must·be·a·string" with ······'Cover·must·be·a·string'

(prettier/prettier)


[error] 81-81: Replace ······"Authors·should·be·an·array" with 'Authors·should·be·an·array'⏎····

(prettier/prettier)


[error] 82-82: Replace ···· with ··

(prettier/prettier)


[error] 84-84: Delete ··

(prettier/prettier)


[error] 85-85: Delete ····

(prettier/prettier)


[error] 87-88: Replace ········await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))⏎············ with ····await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))

(prettier/prettier)


[error] 90-90: Replace ········ with ····

(prettier/prettier)


[error] 91-91: Replace ···· with ··

(prettier/prettier)


[error] 93-93: Delete ··

(prettier/prettier)


[error] 94-94: Replace ········ with ····

(prettier/prettier)


[error] 95-95: Delete ····

(prettier/prettier)


[error] 96-96: Replace ········ with ····

(prettier/prettier)


[error] 98-98: Delete ····

(prettier/prettier)


[error] 100-100: Replace ········ with ····

(prettier/prettier)


[error] 102-102: Replace ········expect(mockConsoleLog).not.toHaveBeenCalledWith(expect.stringContaining('Errors·in·file·reference/specification/skipped.md')); with ····expect(mockConsoleLog).not.toHaveBeenCalledWith(⏎······expect.stringContaining('Errors·in·file·reference/specification/skipped.md')

(prettier/prettier)


[error] 103-103: Insert );⏎

(prettier/prettier)


[error] 104-104: Delete ··

(prettier/prettier)


[error] 106-106: Delete ··

(prettier/prettier)


[error] 107-107: Replace ········ with ····

(prettier/prettier)


[error] 108-108: Delete ····

(prettier/prettier)


[error] 110-110: Replace ········ with ····

(prettier/prettier)


[error] 112-112: Delete ····

(prettier/prettier)


[error] 113-113: Replace ········ with ····

(prettier/prettier)


[error] 114-114: Delete ······

(prettier/prettier)


[error] 115-115: Delete ······

(prettier/prettier)


[error] 116-116: Replace ········ with ····

(prettier/prettier)


[error] 118-118: Delete ····

(prettier/prettier)


[error] 119-119: Delete ··

(prettier/prettier)


[error] 121-121: Delete ··

(prettier/prettier)


[error] 122-122: Delete ····

(prettier/prettier)


[error] 124-124: Replace ········ with ····

(prettier/prettier)


[error] 126-126: Delete ····

(prettier/prettier)


[error] 128-131: Replace ········expect(mockConsoleError).toHaveBeenCalledWith(⏎············'Failed·to·validate·markdown·files:',⏎············expect.any(Error)⏎········ with ····expect(mockConsoleError).toHaveBeenCalledWith('Failed·to·validate·markdown·files:',·expect.any(Error)

(prettier/prettier)


[error] 132-132: Replace ···· with ··

(prettier/prettier)


[error] 134-134: Delete ··

(prettier/prettier)


[error] 135-136: Delete ⏎····

(prettier/prettier)


[error] 138-138: Replace ········expect(mockConsoleError).not.toHaveBeenCalledWith() with ····expect(mockConsoleError).not.toHaveBeenCalledWith();

(prettier/prettier)


[error] 139-139: Delete ··

(prettier/prettier)


[error] 141-141: Delete ··

(prettier/prettier)


[error] 142-142: Replace ········ with ····

(prettier/prettier)


[error] 143-143: Delete ····

(prettier/prettier)


[error] 144-144: Replace ········ with ····

(prettier/prettier)


[error] 145-145: Delete ····

(prettier/prettier)


[error] 146-146: Replace ········ with ····

(prettier/prettier)


[error] 147-147: Replace ········ with ····

(prettier/prettier)


[error] 148-149: Replace ··});⏎ with });

(prettier/prettier)

🔇 Additional comments (4)
scripts/markdown/check-markdown.js (2)

146-156: LGTM! Error handling is well implemented.

The main function properly handles errors and sets the process exit code appropriately.

🧰 Tools
🪛 eslint

[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Delete ····

(prettier/prettier)


[error] 149-149: Replace ············ with ······

(prettier/prettier)


[error] 150-150: Replace ············ with ······

(prettier/prettier)


[error] 151-151: Delete ····

(prettier/prettier)


[error] 152-152: Delete ··

(prettier/prettier)


[error] 153-153: Delete ····

(prettier/prettier)


[error] 154-154: Replace ········ with ····

(prettier/prettier)


[error] 155-155: Delete ··

(prettier/prettier)


158-161: LGTM! Entry point and exports are properly configured.

The module exports all necessary functions and correctly handles CLI usage.

Also applies to: 163-163

🧰 Tools
🪛 eslint

[error] 160-160: Delete ··

(prettier/prettier)

tests/markdown/check-markdown.test.js (2)

17-27: LGTM! Test setup and teardown are well implemented.

The test suite properly manages temporary directories and mocks, with cleanup in afterEach.

🧰 Tools
🪛 eslint

[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 18-18: Delete ····

(prettier/prettier)


[error] 19-19: Replace ········ with ····

(prettier/prettier)


[error] 20-20: Replace ········ with ····

(prettier/prettier)


[error] 21-21: Delete ··

(prettier/prettier)


[error] 23-23: Replace ···· with ··

(prettier/prettier)


[error] 24-24: Delete ····

(prettier/prettier)


[error] 25-25: Delete ····

(prettier/prettier)


[error] 26-26: Delete ····

(prettier/prettier)


[error] 27-27: Delete ··

(prettier/prettier)


29-82: LGTM! Comprehensive test coverage with good error handling.

The test suite provides thorough coverage of validation rules, error scenarios, and edge cases.

Also applies to: 84-119, 141-148

🧰 Tools
🪛 eslint

[error] 29-29: Delete ··

(prettier/prettier)


[error] 30-30: Delete ····

(prettier/prettier)


[error] 31-31: Replace ············ with ······

(prettier/prettier)


[error] 32-32: Delete ······

(prettier/prettier)


[error] 33-33: Delete ······

(prettier/prettier)


[error] 34-34: Replace ············ with ······

(prettier/prettier)


[error] 35-35: Replace ············ with ······

(prettier/prettier)


[error] 36-36: Delete ······

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 39-39: Delete ····

(prettier/prettier)


[error] 40-40: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 41-41: Delete ····

(prettier/prettier)


[error] 42-42: Replace ············ with ········

(prettier/prettier)


[error] 43-43: Delete ····

(prettier/prettier)


[error] 44-44: Replace ········])); with ······])

(prettier/prettier)


[error] 45-45: Insert );⏎··

(prettier/prettier)


[error] 47-47: Replace ···· with ··

(prettier/prettier)


[error] 48-48: Delete ····

(prettier/prettier)


[error] 49-49: Delete ····

(prettier/prettier)


[error] 50-52: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 53-53: Replace ········]) with ····

(prettier/prettier)


[error] 54-54: Delete ··

(prettier/prettier)


[error] 56-56: Delete ··

(prettier/prettier)


[error] 57-57: Delete ····

(prettier/prettier)


[error] 58-58: Delete ····

(prettier/prettier)


[error] 60-60: Delete ····

(prettier/prettier)


[error] 62-62: Delete ····

(prettier/prettier)


[error] 63-63: Replace ········ with ····

(prettier/prettier)


[error] 64-64: Delete ··

(prettier/prettier)


[error] 66-66: Delete ··

(prettier/prettier)


[error] 67-67: Replace ········ with ····

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ······

(prettier/prettier)


[error] 70-70: Replace ············ with ······

(prettier/prettier)


[error] 71-71: Replace ············ with ······

(prettier/prettier)


[error] 72-72: Replace ············ with ······

(prettier/prettier)


[error] 73-73: Delete ······

(prettier/prettier)


[error] 74-74: Replace ········ with ····

(prettier/prettier)


[error] 75-75: Delete ····

(prettier/prettier)


[error] 77-77: Replace ········ with ····

(prettier/prettier)


[error] 78-78: Replace ······"Invalid·date·format:·invalid-date" with 'Invalid·date·format:·invalid-date'

(prettier/prettier)


[error] 79-79: Replace ······"Tags·should·be·an·array" with 'Tags·should·be·an·array'

(prettier/prettier)


[error] 80-80: Replace ············"Cover·must·be·a·string" with ······'Cover·must·be·a·string'

(prettier/prettier)


[error] 81-81: Replace ······"Authors·should·be·an·array" with 'Authors·should·be·an·array'⏎····

(prettier/prettier)


[error] 82-82: Replace ···· with ··

(prettier/prettier)

console.error('Error reading file stats:', err);
return;
}
try {
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why there are nesting try/catch in this function?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

the outer block manages directory-level issues like reading or iterating through folders, while the inner block handles file-specific errors such as reading markdown files

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

But a single try catch can handle multiple errors inside that block, so you should have a single try catch block only.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

UPDATED

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (4)
scripts/markdown/check-markdown.js (2)

141-151: Add input validation for folder paths.

While the implementation is correct, consider adding validation for the folder paths before processing:

 async function main() {
     try {
+        // Validate folder paths exist before processing
+        try {
+            await Promise.all([
+                fs.access(docsFolderPath),
+                fs.access(blogsFolderPath)
+            ]);
+        } catch (error) {
+            throw new Error('Invalid folder paths provided');
+        }
         await Promise.all([
             checkMarkdownFiles(docsFolderPath, validateDocs),
             checkMarkdownFiles(blogsFolderPath, validateBlogs)
         ]);
     } catch (error) {
🧰 Tools
🪛 eslint

[error] 142-142: Delete ··

(prettier/prettier)


[error] 143-143: Delete ····

(prettier/prettier)


[error] 144-144: Replace ············ with ······

(prettier/prettier)


[error] 145-145: Replace ············ with ······

(prettier/prettier)


[error] 146-146: Delete ····

(prettier/prettier)


[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Delete ····

(prettier/prettier)


[error] 149-149: Replace ········ with ····

(prettier/prettier)


[error] 150-150: Delete ··

(prettier/prettier)


158-158: Add missing semicolon.

Add a semicolon at the end of the module.exports statement.

-module.exports = { validateBlogs, validateDocs, checkMarkdownFiles, main, isValidURL }
+module.exports = { validateBlogs, validateDocs, checkMarkdownFiles, main, isValidURL };
🧰 Tools
🪛 eslint

[error] 158-158: Insert ;

(prettier/prettier)

tests/markdown/check-markdown.test.js (2)

77-81: Use consistent string quotes.

Use single quotes consistently throughout the test file.

 expect(errors).toEqual([
-            "Invalid date format: invalid-date",
-            "Tags should be an array",
-            "Cover must be a string",
-            "Authors should be an array"]);
+            'Invalid date format: invalid-date',
+            'Tags should be an array',
+            'Cover must be a string',
+            'Authors should be an array'
+        ]);
🧰 Tools
🪛 eslint

[error] 77-77: Delete ····

(prettier/prettier)


[error] 78-78: Replace ······"Invalid·date·format:·invalid-date" with 'Invalid·date·format:·invalid-date'

(prettier/prettier)


[error] 79-79: Replace ······"Tags·should·be·an·array" with 'Tags·should·be·an·array'

(prettier/prettier)


[error] 80-80: Replace ············"Cover·must·be·a·string" with ······'Cover·must·be·a·string'

(prettier/prettier)


[error] 81-81: Replace ······"Authors·should·be·an·array" with 'Authors·should·be·an·array'⏎····

(prettier/prettier)


138-138: Add missing semicolon.

Add a semicolon after the expect statement.

-expect(mockConsoleError).not.toHaveBeenCalledWith()
+expect(mockConsoleError).not.toHaveBeenCalledWith();
🧰 Tools
🪛 eslint

[error] 138-138: Replace ········expect(mockConsoleError).not.toHaveBeenCalledWith() with ····expect(mockConsoleError).not.toHaveBeenCalledWith();

(prettier/prettier)

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between f595339 and bcaf621.

📒 Files selected for processing (2)
  • scripts/markdown/check-markdown.js (4 hunks)
  • tests/markdown/check-markdown.test.js (1 hunks)
🧰 Additional context used
📓 Learnings (2)
scripts/markdown/check-markdown.js (3)
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:41:29.632Z
Learning: When updating workflows for the AsyncAPI website repository, use `.github/workflows/if-nodejs-pr-testing.yml` to include environment variables and secrets for Node.js PR testing.
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:34:51.303Z
Learning: When reviewing `scripts/markdown/check-markdown.js`, optimizations should be addressed in separate issues and not included in the current pull request.
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-11-12T06:59:33.851Z
Learning: In `scripts/markdown/check-markdown.js`, when processing large markdown files with recursion and loops, synchronous file reads (`fs.readFileSync`) are preferred over asynchronous reads.
tests/markdown/check-markdown.test.js (1)
Learnt from: vishvamsinh28
PR: asyncapi/website#3378
File: tests/markdown/check-markdown.test.js:133-138
Timestamp: 2024-11-29T17:36:09.783Z
Learning: When testing the 'main' function in 'check-markdown.test.js', it's acceptable to simply ensure it doesn't throw any errors, as the functions it calls are already tested elsewhere.
🪛 eslint
scripts/markdown/check-markdown.js

[error] 102-102: Delete ··

(prettier/prettier)


[error] 103-103: Delete ····

(prettier/prettier)


[error] 104-104: Replace ········ with ····

(prettier/prettier)


[error] 113-113: Delete ··········

(prettier/prettier)


[error] 115-115: Delete ··········

(prettier/prettier)


[error] 116-116: Delete ··········

(prettier/prettier)


[error] 117-117: Delete ············

(prettier/prettier)


[error] 118-118: Delete ··········

(prettier/prettier)


[error] 119-119: Replace ···················· with ········

(prettier/prettier)


[error] 131-131: Replace ········ with ····

(prettier/prettier)


[error] 132-132: Delete ··

(prettier/prettier)


[error] 133-133: Replace ········ with ····

(prettier/prettier)


[error] 134-134: Delete ····

(prettier/prettier)


[error] 135-135: Delete ··

(prettier/prettier)


[error] 142-142: Delete ··

(prettier/prettier)


[error] 143-143: Delete ····

(prettier/prettier)


[error] 144-144: Replace ············ with ······

(prettier/prettier)


[error] 145-145: Replace ············ with ······

(prettier/prettier)


[error] 146-146: Delete ····

(prettier/prettier)


[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Delete ····

(prettier/prettier)


[error] 149-149: Replace ········ with ····

(prettier/prettier)


[error] 150-150: Delete ··

(prettier/prettier)


[error] 155-155: Delete ··

(prettier/prettier)


[error] 158-158: Insert ;

(prettier/prettier)

tests/markdown/check-markdown.test.js

[error] 5-5: Delete ··

(prettier/prettier)


[error] 6-6: Delete ··

(prettier/prettier)


[error] 7-7: Replace ···· with ··

(prettier/prettier)


[error] 8-8: Replace ···· with ··

(prettier/prettier)


[error] 9-9: Replace ···· with ··

(prettier/prettier)


[error] 13-13: Delete ··

(prettier/prettier)


[error] 14-14: Delete ··

(prettier/prettier)


[error] 15-15: Delete ··

(prettier/prettier)


[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 18-18: Delete ····

(prettier/prettier)


[error] 19-19: Delete ····

(prettier/prettier)


[error] 20-20: Delete ····

(prettier/prettier)


[error] 21-21: Delete ··

(prettier/prettier)


[error] 23-23: Delete ··

(prettier/prettier)


[error] 24-24: Delete ····

(prettier/prettier)


[error] 25-25: Replace ········ with ····

(prettier/prettier)


[error] 26-26: Replace ········ with ····

(prettier/prettier)


[error] 27-27: Delete ··

(prettier/prettier)


[error] 29-29: Delete ··

(prettier/prettier)


[error] 30-30: Replace ········ with ····

(prettier/prettier)


[error] 31-31: Delete ······

(prettier/prettier)


[error] 32-32: Delete ······

(prettier/prettier)


[error] 33-33: Replace ············ with ······

(prettier/prettier)


[error] 34-34: Replace ············ with ······

(prettier/prettier)


[error] 35-35: Delete ······

(prettier/prettier)


[error] 36-36: Replace ············ with ······

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 39-39: Delete ····

(prettier/prettier)


[error] 40-40: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 41-41: Replace ············ with ········

(prettier/prettier)


[error] 42-42: Delete ····

(prettier/prettier)


[error] 43-43: Replace ············ with ········

(prettier/prettier)


[error] 44-44: Replace ··])); with ])

(prettier/prettier)


[error] 45-46: Replace });⏎ with );

(prettier/prettier)


[error] 47-47: Insert });⏎⏎

(prettier/prettier)


[error] 48-48: Replace ········ with ····

(prettier/prettier)


[error] 49-49: Delete ····

(prettier/prettier)


[error] 50-52: Replace ········expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with ····expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 53-53: Replace ········]) with ····

(prettier/prettier)


[error] 54-54: Delete ··

(prettier/prettier)


[error] 56-56: Delete ··

(prettier/prettier)


[error] 57-57: Delete ····

(prettier/prettier)


[error] 58-58: Replace ········ with ····

(prettier/prettier)


[error] 60-60: Delete ····

(prettier/prettier)


[error] 62-62: Replace ········ with ····

(prettier/prettier)


[error] 63-63: Delete ····

(prettier/prettier)


[error] 64-64: Delete ··

(prettier/prettier)


[error] 66-66: Delete ··

(prettier/prettier)


[error] 67-67: Delete ····

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ······

(prettier/prettier)


[error] 70-70: Replace ············ with ······

(prettier/prettier)


[error] 71-71: Replace ············ with ······

(prettier/prettier)


[error] 72-72: Delete ······

(prettier/prettier)


[error] 73-73: Delete ······

(prettier/prettier)


[error] 74-74: Replace ········ with ····

(prettier/prettier)


[error] 75-75: Delete ····

(prettier/prettier)


[error] 77-77: Delete ····

(prettier/prettier)


[error] 78-78: Replace ······"Invalid·date·format:·invalid-date" with 'Invalid·date·format:·invalid-date'

(prettier/prettier)


[error] 79-79: Replace ······"Tags·should·be·an·array" with 'Tags·should·be·an·array'

(prettier/prettier)


[error] 80-80: Replace ············"Cover·must·be·a·string" with ······'Cover·must·be·a·string'

(prettier/prettier)


[error] 81-81: Replace ······"Authors·should·be·an·array" with 'Authors·should·be·an·array'⏎····

(prettier/prettier)


[error] 82-82: Delete ··

(prettier/prettier)


[error] 84-84: Delete ··

(prettier/prettier)


[error] 85-85: Delete ····

(prettier/prettier)


[error] 87-88: Replace ········await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))⏎············ with ····await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))

(prettier/prettier)


[error] 90-90: Delete ····

(prettier/prettier)


[error] 91-91: Delete ··

(prettier/prettier)


[error] 93-93: Delete ··

(prettier/prettier)


[error] 94-94: Replace ········ with ····

(prettier/prettier)


[error] 95-95: Replace ········ with ····

(prettier/prettier)


[error] 96-96: Delete ····

(prettier/prettier)


[error] 98-98: Replace ········ with ····

(prettier/prettier)


[error] 100-100: Delete ····

(prettier/prettier)


[error] 102-102: Replace ········expect(mockConsoleLog).not.toHaveBeenCalledWith(expect.stringContaining('Errors·in·file·reference/specification/skipped.md')); with ····expect(mockConsoleLog).not.toHaveBeenCalledWith(⏎······expect.stringContaining('Errors·in·file·reference/specification/skipped.md')

(prettier/prettier)


[error] 103-103: Insert );⏎

(prettier/prettier)


[error] 104-104: Delete ··

(prettier/prettier)


[error] 106-106: Replace ···· with ··

(prettier/prettier)


[error] 107-107: Delete ····

(prettier/prettier)


[error] 108-108: Replace ········ with ····

(prettier/prettier)


[error] 110-110: Delete ····

(prettier/prettier)


[error] 112-112: Replace ········ with ····

(prettier/prettier)


[error] 113-116: Replace ····expect(mockConsoleError).toHaveBeenCalledWith(⏎············expect.stringContaining(Error·in·directory),⏎············expect.any(Error)⏎········ with expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining(Error·in·directory),·expect.any(Error)

(prettier/prettier)


[error] 118-118: Replace ········ with ····

(prettier/prettier)


[error] 119-119: Delete ··

(prettier/prettier)


[error] 121-121: Delete ··

(prettier/prettier)


[error] 122-122: Delete ····

(prettier/prettier)


[error] 124-124: Delete ····

(prettier/prettier)


[error] 126-126: Delete ····

(prettier/prettier)


[error] 128-131: Replace ····expect(mockConsoleError).toHaveBeenCalledWith(⏎············'Failed·to·validate·markdown·files:',⏎············expect.any(Error)⏎········ with expect(mockConsoleError).toHaveBeenCalledWith('Failed·to·validate·markdown·files:',·expect.any(Error)

(prettier/prettier)


[error] 132-132: Delete ··

(prettier/prettier)


[error] 134-134: Delete ··

(prettier/prettier)


[error] 135-136: Delete ⏎····

(prettier/prettier)


[error] 138-138: Replace ········expect(mockConsoleError).not.toHaveBeenCalledWith() with ····expect(mockConsoleError).not.toHaveBeenCalledWith();

(prettier/prettier)


[error] 139-139: Delete ··

(prettier/prettier)


[error] 141-141: Replace ···· with ··

(prettier/prettier)


[error] 142-142: Replace ········ with ····

(prettier/prettier)


[error] 143-143: Delete ····

(prettier/prettier)


[error] 144-144: Replace ········ with ····

(prettier/prettier)


[error] 145-145: Delete ····

(prettier/prettier)


[error] 146-146: Replace ········ with ····

(prettier/prettier)


[error] 147-147: Replace ········ with ····

(prettier/prettier)


[error] 148-149: Replace ··});⏎ with });

(prettier/prettier)

🔇 Additional comments (3)
scripts/markdown/check-markdown.js (1)

Line range hint 101-135: LGTM! The async implementation looks good.

The function correctly implements async/await pattern with proper error handling. While there's potential for optimization regarding parallel file processing, this can be addressed in a separate issue as per previous discussions.

🧰 Tools
🪛 eslint

[error] 110-110: Delete ········

(prettier/prettier)


[error] 111-111: Replace ············ with ······

(prettier/prettier)


[error] 113-113: Delete ··········

(prettier/prettier)


[error] 115-115: Delete ··········

(prettier/prettier)


[error] 116-116: Delete ··········

(prettier/prettier)


[error] 117-117: Delete ············

(prettier/prettier)


[error] 118-118: Delete ··········

(prettier/prettier)


[error] 119-119: Replace ···················· with ········

(prettier/prettier)


[error] 120-120: Delete ············

(prettier/prettier)


[error] 122-122: Delete ············

(prettier/prettier)

tests/markdown/check-markdown.test.js (2)

1-27: LGTM! Test setup is comprehensive.

The test setup follows best practices with proper mocking and cleanup.

🧰 Tools
🪛 eslint

[error] 5-5: Delete ··

(prettier/prettier)


[error] 6-6: Delete ··

(prettier/prettier)


[error] 7-7: Replace ···· with ··

(prettier/prettier)


[error] 8-8: Replace ···· with ··

(prettier/prettier)


[error] 9-9: Replace ···· with ··

(prettier/prettier)


[error] 13-13: Delete ··

(prettier/prettier)


[error] 14-14: Delete ··

(prettier/prettier)


[error] 15-15: Delete ··

(prettier/prettier)


[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 18-18: Delete ····

(prettier/prettier)


[error] 19-19: Delete ····

(prettier/prettier)


[error] 20-20: Delete ····

(prettier/prettier)


[error] 21-21: Delete ··

(prettier/prettier)


[error] 23-23: Delete ··

(prettier/prettier)


[error] 24-24: Delete ····

(prettier/prettier)


[error] 25-25: Replace ········ with ····

(prettier/prettier)


[error] 26-26: Replace ········ with ····

(prettier/prettier)


[error] 27-27: Delete ··

(prettier/prettier)


84-119: LGTM! Error handling tests are thorough.

The tests cover various error scenarios and use modern Jest patterns for testing rejections.

🧰 Tools
🪛 eslint

[error] 84-84: Delete ··

(prettier/prettier)


[error] 85-85: Delete ····

(prettier/prettier)


[error] 87-88: Replace ········await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))⏎············ with ····await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))

(prettier/prettier)


[error] 90-90: Delete ····

(prettier/prettier)


[error] 91-91: Delete ··

(prettier/prettier)


[error] 93-93: Delete ··

(prettier/prettier)


[error] 94-94: Replace ········ with ····

(prettier/prettier)


[error] 95-95: Replace ········ with ····

(prettier/prettier)


[error] 96-96: Delete ····

(prettier/prettier)


[error] 98-98: Replace ········ with ····

(prettier/prettier)


[error] 100-100: Delete ····

(prettier/prettier)


[error] 102-102: Replace ········expect(mockConsoleLog).not.toHaveBeenCalledWith(expect.stringContaining('Errors·in·file·reference/specification/skipped.md')); with ····expect(mockConsoleLog).not.toHaveBeenCalledWith(⏎······expect.stringContaining('Errors·in·file·reference/specification/skipped.md')

(prettier/prettier)


[error] 103-103: Insert );⏎

(prettier/prettier)


[error] 104-104: Delete ··

(prettier/prettier)


[error] 106-106: Replace ···· with ··

(prettier/prettier)


[error] 107-107: Delete ····

(prettier/prettier)


[error] 108-108: Replace ········ with ····

(prettier/prettier)


[error] 110-110: Delete ····

(prettier/prettier)


[error] 112-112: Replace ········ with ····

(prettier/prettier)


[error] 113-116: Replace ····expect(mockConsoleError).toHaveBeenCalledWith(⏎············expect.stringContaining(Error·in·directory),⏎············expect.any(Error)⏎········ with expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining(Error·in·directory),·expect.any(Error)

(prettier/prettier)


[error] 118-118: Replace ········ with ····

(prettier/prettier)


[error] 119-119: Delete ··

(prettier/prettier)

}
}

/* istanbul ignore next */
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why this comment is added?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is added to exclude the if block beneath it from coverage reporting. This block ensures that the script runs its main() function only when executed directly (and not when imported as a module). Without this check, the main() function would execute automatically when the script is imported during testing.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Outside diff range and nitpick comments (4)
scripts/markdown/check-markdown.js (2)

Line range hint 101-135: Add input validation and improve error handling

Consider adding input validation and making error messages more specific:

 async function checkMarkdownFiles(folderPath, validateFunction, relativePath = '') {
+    if (!folderPath || typeof folderPath !== 'string') {
+        throw new Error('folderPath must be a non-empty string');
+    }
+    if (typeof validateFunction !== 'function') {
+        throw new Error('validateFunction must be a function');
+    }
     try {
         const files = await fs.readdir(folderPath);
         const filePromises = files.map(async (file) => {
             // ... rest of the code
         });
         await Promise.all(filePromises);
     } catch (err) {
-        console.error(`Error in directory ${folderPath}:`, err);
+        const errorMessage = err.code === 'ENOENT' 
+            ? `Directory not found: ${folderPath}` 
+            : `Error processing directory ${folderPath}: ${err.message}`;
+        console.error(errorMessage);
         throw err;
     }
 }
🧰 Tools
🪛 eslint

[error] 110-110: Delete ········

(prettier/prettier)


[error] 111-111: Replace ············ with ······

(prettier/prettier)


[error] 113-113: Delete ··········

(prettier/prettier)


[error] 115-115: Delete ··········

(prettier/prettier)


[error] 116-116: Delete ··········

(prettier/prettier)


[error] 117-117: Delete ············

(prettier/prettier)


[error] 118-118: Delete ··········

(prettier/prettier)


[error] 119-119: Delete ············

(prettier/prettier)


[error] 120-120: Replace ···················· with ········

(prettier/prettier)


[error] 122-122: Delete ············

(prettier/prettier)


141-151: Improve error handling and separate concerns

The main function mixes error handling with process termination. Consider separating these concerns:

 async function main() {
     try {
         await Promise.all([
             checkMarkdownFiles(docsFolderPath, validateDocs),
             checkMarkdownFiles(blogsFolderPath, validateBlogs)
         ]);
+        return true;
     } catch (error) {
         console.error('Failed to validate markdown files:', error);
-        process.exit(1);
+        return false;
     }
 }

 if (require.main === module) {
-    main();
+    main().then(success => {
+        if (!success) process.exit(1);
+    });
 }
🧰 Tools
🪛 eslint

[error] 142-142: Delete ··

(prettier/prettier)


[error] 143-143: Delete ····

(prettier/prettier)


[error] 144-144: Delete ······

(prettier/prettier)


[error] 145-145: Replace ············ with ······

(prettier/prettier)


[error] 146-146: Replace ········ with ····

(prettier/prettier)


[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Delete ····

(prettier/prettier)


[error] 149-149: Replace ········ with ····

(prettier/prettier)


[error] 150-150: Delete ··

(prettier/prettier)

tests/markdown/check-markdown.test.js (2)

29-82: Consider adding edge cases to validation tests

The validation tests are good but could be more comprehensive. Consider adding tests for:

  1. Empty frontmatter object
  2. Null/undefined values
  3. Empty arrays for tags and authors
  4. Special characters in titles
it('handles edge cases in blog frontmatter', async () => {
    const frontmatter = {
        title: '',
        date: null,
        type: 'blog',
        tags: [],
        cover: undefined,
        authors: []
    };
    const errors = validateBlogs(frontmatter);
    expect(errors).toContain('Empty title is not allowed');
    expect(errors).toContain('Date is required');
    expect(errors).toContain('At least one tag is required');
    expect(errors).toContain('Cover image is required');
    expect(errors).toContain('At least one author is required');
});
🧰 Tools
🪛 eslint

[error] 29-29: Delete ··

(prettier/prettier)


[error] 30-30: Delete ····

(prettier/prettier)


[error] 31-31: Replace ············ with ······

(prettier/prettier)


[error] 32-32: Delete ······

(prettier/prettier)


[error] 33-33: Delete ······

(prettier/prettier)


[error] 34-34: Replace ············ with ······

(prettier/prettier)


[error] 35-35: Replace ············ with ······

(prettier/prettier)


[error] 36-36: Delete ······

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 39-39: Delete ····

(prettier/prettier)


[error] 40-40: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 41-41: Delete ····

(prettier/prettier)


[error] 42-42: Replace ············ with ········

(prettier/prettier)


[error] 43-43: Delete ····

(prettier/prettier)


[error] 44-44: Replace ········])); with ······])

(prettier/prettier)


[error] 45-45: Insert );⏎··

(prettier/prettier)


[error] 47-47: Replace ···· with ··

(prettier/prettier)


[error] 48-48: Delete ····

(prettier/prettier)


[error] 49-49: Delete ····

(prettier/prettier)


[error] 50-52: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 53-53: Replace ········]) with ····

(prettier/prettier)


[error] 54-54: Delete ··

(prettier/prettier)


[error] 56-56: Delete ··

(prettier/prettier)


[error] 57-57: Delete ····

(prettier/prettier)


[error] 58-58: Delete ····

(prettier/prettier)


[error] 60-60: Delete ····

(prettier/prettier)


[error] 62-62: Delete ····

(prettier/prettier)


[error] 63-63: Replace ········ with ····

(prettier/prettier)


[error] 64-64: Delete ··

(prettier/prettier)


[error] 66-66: Delete ··

(prettier/prettier)


[error] 67-67: Replace ········ with ····

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ······

(prettier/prettier)


[error] 70-70: Replace ············ with ······

(prettier/prettier)


[error] 71-71: Replace ············ with ······

(prettier/prettier)


[error] 72-72: Replace ············ with ······

(prettier/prettier)


[error] 73-73: Delete ······

(prettier/prettier)


[error] 74-74: Replace ········ with ····

(prettier/prettier)


[error] 75-75: Delete ····

(prettier/prettier)


[error] 77-77: Replace ········ with ····

(prettier/prettier)


[error] 78-78: Delete ······

(prettier/prettier)


[error] 79-79: Delete ······

(prettier/prettier)


[error] 80-80: Replace ············ with ······

(prettier/prettier)


[error] 81-81: Replace ············'Authors·should·be·an·array' with ······'Authors·should·be·an·array'⏎····

(prettier/prettier)


[error] 82-82: Replace ···· with ··

(prettier/prettier)


84-119: Make error assertions more specific

The error handling tests could be more specific about the types of errors they expect:

 it('logs error to console when an error occurs in checkMarkdownFiles', async () => {
     const invalidFolderPath = path.join(tempDir, 'non-existent-folder');

     await expect(checkMarkdownFiles(invalidFolderPath, validateBlogs))
-        .rejects.toThrow('ENOENT');
+        .rejects.toThrow(expect.objectContaining({
+            code: 'ENOENT',
+            syscall: 'opendir'
+        }));

     expect(mockConsoleError.mock.calls[0][0]).toContain('Error in directory');
 });
🧰 Tools
🪛 eslint

[error] 84-84: Delete ··

(prettier/prettier)


[error] 85-85: Delete ····

(prettier/prettier)


[error] 87-88: Replace ········await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))⏎············ with ····await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))

(prettier/prettier)


[error] 90-90: Replace ········ with ····

(prettier/prettier)


[error] 91-91: Replace ···· with ··

(prettier/prettier)


[error] 93-93: Delete ··

(prettier/prettier)


[error] 94-94: Replace ········ with ····

(prettier/prettier)


[error] 95-95: Delete ····

(prettier/prettier)


[error] 96-96: Replace ········ with ····

(prettier/prettier)


[error] 98-98: Delete ····

(prettier/prettier)


[error] 100-100: Replace ········ with ····

(prettier/prettier)


[error] 102-102: Replace ····expect(mockConsoleLog).not.toHaveBeenCalledWith(expect.stringContaining('Errors·in·file·reference/specification/skipped.md')); with expect(mockConsoleLog).not.toHaveBeenCalledWith(⏎······expect.stringContaining('Errors·in·file·reference/specification/skipped.md')

(prettier/prettier)


[error] 103-103: Insert );⏎

(prettier/prettier)


[error] 104-104: Delete ··

(prettier/prettier)


[error] 106-106: Delete ··

(prettier/prettier)


[error] 107-107: Replace ········ with ····

(prettier/prettier)


[error] 108-108: Delete ····

(prettier/prettier)


[error] 110-110: Replace ········ with ····

(prettier/prettier)


[error] 112-112: Delete ····

(prettier/prettier)


[error] 113-116: Replace ········expect(mockConsoleError).toHaveBeenCalledWith(⏎············expect.stringContaining(Error·in·directory),⏎············expect.any(Error)⏎········ with ····expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining(Error·in·directory),·expect.any(Error)

(prettier/prettier)


[error] 118-118: Delete ····

(prettier/prettier)


[error] 119-119: Replace ···· with ··

(prettier/prettier)

📜 Review details

Configuration used: .coderabbit.yaml
Review profile: CHILL

📥 Commits

Reviewing files that changed from the base of the PR and between bcaf621 and cc23800.

📒 Files selected for processing (2)
  • scripts/markdown/check-markdown.js (4 hunks)
  • tests/markdown/check-markdown.test.js (1 hunks)
🧰 Additional context used
📓 Learnings (2)
scripts/markdown/check-markdown.js (3)
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:41:29.632Z
Learning: When updating workflows for the AsyncAPI website repository, use `.github/workflows/if-nodejs-pr-testing.yml` to include environment variables and secrets for Node.js PR testing.
Learnt from: akshatnema
PR: asyncapi/website#3378
File: scripts/markdown/check-markdown.js:1-1
Timestamp: 2024-11-25T18:34:51.303Z
Learning: When reviewing `scripts/markdown/check-markdown.js`, optimizations should be addressed in separate issues and not included in the current pull request.
Learnt from: anshgoyalevil
PR: asyncapi/website#3301
File: scripts/markdown/check-markdown.js:0-0
Timestamp: 2024-11-12T06:59:33.851Z
Learning: In `scripts/markdown/check-markdown.js`, when processing large markdown files with recursion and loops, synchronous file reads (`fs.readFileSync`) are preferred over asynchronous reads.
tests/markdown/check-markdown.test.js (1)
Learnt from: vishvamsinh28
PR: asyncapi/website#3378
File: tests/markdown/check-markdown.test.js:133-138
Timestamp: 2024-11-29T17:36:09.783Z
Learning: When testing the 'main' function in 'check-markdown.test.js', it's acceptable to simply ensure it doesn't throw any errors, as the functions it calls are already tested elsewhere.
🪛 eslint
scripts/markdown/check-markdown.js

[error] 102-102: Delete ··

(prettier/prettier)


[error] 103-103: Delete ····

(prettier/prettier)


[error] 104-104: Replace ········ with ····

(prettier/prettier)


[error] 113-113: Delete ··········

(prettier/prettier)


[error] 115-115: Delete ··········

(prettier/prettier)


[error] 116-116: Delete ··········

(prettier/prettier)


[error] 117-117: Delete ············

(prettier/prettier)


[error] 118-118: Delete ··········

(prettier/prettier)


[error] 119-119: Delete ············

(prettier/prettier)


[error] 131-131: Delete ····

(prettier/prettier)


[error] 132-132: Delete ··

(prettier/prettier)


[error] 133-133: Replace ········ with ····

(prettier/prettier)


[error] 134-134: Delete ····

(prettier/prettier)


[error] 135-135: Delete ··

(prettier/prettier)


[error] 142-142: Delete ··

(prettier/prettier)


[error] 143-143: Delete ····

(prettier/prettier)


[error] 144-144: Delete ······

(prettier/prettier)


[error] 145-145: Replace ············ with ······

(prettier/prettier)


[error] 146-146: Replace ········ with ····

(prettier/prettier)


[error] 147-147: Delete ··

(prettier/prettier)


[error] 148-148: Delete ····

(prettier/prettier)


[error] 149-149: Replace ········ with ····

(prettier/prettier)


[error] 150-150: Delete ··

(prettier/prettier)


[error] 155-155: Delete ··

(prettier/prettier)

tests/markdown/check-markdown.test.js

[error] 5-5: Delete ··

(prettier/prettier)


[error] 6-6: Delete ··

(prettier/prettier)


[error] 7-7: Replace ···· with ··

(prettier/prettier)


[error] 8-8: Replace ···· with ··

(prettier/prettier)


[error] 9-9: Replace ···· with ··

(prettier/prettier)


[error] 13-13: Delete ··

(prettier/prettier)


[error] 14-14: Delete ··

(prettier/prettier)


[error] 15-15: Delete ··

(prettier/prettier)


[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 18-18: Delete ····

(prettier/prettier)


[error] 19-19: Replace ········ with ····

(prettier/prettier)


[error] 20-20: Replace ········ with ····

(prettier/prettier)


[error] 21-21: Delete ··

(prettier/prettier)


[error] 23-23: Replace ···· with ··

(prettier/prettier)


[error] 24-24: Delete ····

(prettier/prettier)


[error] 25-25: Delete ····

(prettier/prettier)


[error] 26-26: Delete ····

(prettier/prettier)


[error] 27-27: Delete ··

(prettier/prettier)


[error] 29-29: Delete ··

(prettier/prettier)


[error] 30-30: Delete ····

(prettier/prettier)


[error] 31-31: Replace ············ with ······

(prettier/prettier)


[error] 32-32: Delete ······

(prettier/prettier)


[error] 33-33: Delete ······

(prettier/prettier)


[error] 34-34: Replace ············ with ······

(prettier/prettier)


[error] 35-35: Replace ············ with ······

(prettier/prettier)


[error] 36-36: Delete ······

(prettier/prettier)


[error] 37-37: Delete ····

(prettier/prettier)


[error] 39-39: Delete ····

(prettier/prettier)


[error] 40-40: Replace ········expect(errors).toEqual( with ····expect(errors).toEqual(⏎······

(prettier/prettier)


[error] 41-41: Delete ····

(prettier/prettier)


[error] 42-42: Replace ············ with ········

(prettier/prettier)


[error] 43-43: Delete ····

(prettier/prettier)


[error] 44-44: Replace ········])); with ······])

(prettier/prettier)


[error] 45-45: Insert );⏎··

(prettier/prettier)


[error] 47-47: Replace ···· with ··

(prettier/prettier)


[error] 48-48: Delete ····

(prettier/prettier)


[error] 49-49: Delete ····

(prettier/prettier)


[error] 50-52: Replace ····expect(errors).toEqual(expect.arrayContaining([⏎············'Title·is·missing·or·not·a·string',⏎············'Weight·is·missing·or·not·a·number' with expect(errors).toEqual(⏎······expect.arrayContaining(['Title·is·missing·or·not·a·string',·'Weight·is·missing·or·not·a·number'])

(prettier/prettier)


[error] 53-53: Replace ········]) with ····

(prettier/prettier)


[error] 54-54: Delete ··

(prettier/prettier)


[error] 56-56: Delete ··

(prettier/prettier)


[error] 57-57: Delete ····

(prettier/prettier)


[error] 58-58: Delete ····

(prettier/prettier)


[error] 60-60: Delete ····

(prettier/prettier)


[error] 62-62: Delete ····

(prettier/prettier)


[error] 63-63: Replace ········ with ····

(prettier/prettier)


[error] 64-64: Delete ··

(prettier/prettier)


[error] 66-66: Delete ··

(prettier/prettier)


[error] 67-67: Replace ········ with ····

(prettier/prettier)


[error] 68-68: Replace ············ with ······

(prettier/prettier)


[error] 69-69: Delete ······

(prettier/prettier)


[error] 70-70: Replace ············ with ······

(prettier/prettier)


[error] 71-71: Replace ············ with ······

(prettier/prettier)


[error] 72-72: Replace ············ with ······

(prettier/prettier)


[error] 73-73: Delete ······

(prettier/prettier)


[error] 74-74: Replace ········ with ····

(prettier/prettier)


[error] 75-75: Delete ····

(prettier/prettier)


[error] 77-77: Replace ········ with ····

(prettier/prettier)


[error] 78-78: Delete ······

(prettier/prettier)


[error] 79-79: Delete ······

(prettier/prettier)


[error] 80-80: Replace ············ with ······

(prettier/prettier)


[error] 81-81: Replace ············'Authors·should·be·an·array' with ······'Authors·should·be·an·array'⏎····

(prettier/prettier)


[error] 82-82: Replace ···· with ··

(prettier/prettier)


[error] 84-84: Delete ··

(prettier/prettier)


[error] 85-85: Delete ····

(prettier/prettier)


[error] 87-88: Replace ········await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))⏎············ with ····await·expect(checkMarkdownFiles(invalidFolderPath,·validateBlogs))

(prettier/prettier)


[error] 90-90: Replace ········ with ····

(prettier/prettier)


[error] 91-91: Replace ···· with ··

(prettier/prettier)


[error] 93-93: Delete ··

(prettier/prettier)


[error] 94-94: Replace ········ with ····

(prettier/prettier)


[error] 95-95: Delete ····

(prettier/prettier)


[error] 96-96: Replace ········ with ····

(prettier/prettier)


[error] 98-98: Delete ····

(prettier/prettier)


[error] 100-100: Replace ········ with ····

(prettier/prettier)


[error] 102-102: Replace ····expect(mockConsoleLog).not.toHaveBeenCalledWith(expect.stringContaining('Errors·in·file·reference/specification/skipped.md')); with expect(mockConsoleLog).not.toHaveBeenCalledWith(⏎······expect.stringContaining('Errors·in·file·reference/specification/skipped.md')

(prettier/prettier)


[error] 103-103: Insert );⏎

(prettier/prettier)


[error] 104-104: Delete ··

(prettier/prettier)


[error] 106-106: Delete ··

(prettier/prettier)


[error] 107-107: Replace ········ with ····

(prettier/prettier)


[error] 108-108: Delete ····

(prettier/prettier)


[error] 110-110: Replace ········ with ····

(prettier/prettier)


[error] 112-112: Delete ····

(prettier/prettier)


[error] 113-116: Replace ········expect(mockConsoleError).toHaveBeenCalledWith(⏎············expect.stringContaining(Error·in·directory),⏎············expect.any(Error)⏎········ with ····expect(mockConsoleError).toHaveBeenCalledWith(expect.stringContaining(Error·in·directory),·expect.any(Error)

(prettier/prettier)


[error] 118-118: Delete ····

(prettier/prettier)


[error] 119-119: Replace ···· with ··

(prettier/prettier)


[error] 121-121: Delete ··

(prettier/prettier)


[error] 122-122: Delete ····

(prettier/prettier)


[error] 124-124: Replace ········ with ····

(prettier/prettier)


[error] 126-126: Delete ····

(prettier/prettier)


[error] 128-131: Replace ········expect(mockConsoleError).toHaveBeenCalledWith(⏎············'Failed·to·validate·markdown·files:',⏎············expect.any(Error)⏎········ with ····expect(mockConsoleError).toHaveBeenCalledWith('Failed·to·validate·markdown·files:',·expect.any(Error)

(prettier/prettier)


[error] 132-132: Delete ··

(prettier/prettier)


[error] 134-134: Delete ··

(prettier/prettier)


[error] 135-136: Delete ⏎····

(prettier/prettier)


[error] 138-138: Replace ········ with ····

(prettier/prettier)


[error] 139-139: Delete ··

(prettier/prettier)


[error] 141-141: Replace ···· with ··

(prettier/prettier)


[error] 142-142: Replace ········ with ····

(prettier/prettier)


[error] 143-143: Delete ····

(prettier/prettier)


[error] 144-144: Replace ········ with ····

(prettier/prettier)


[error] 145-145: Delete ····

(prettier/prettier)


[error] 146-146: Replace ········ with ····

(prettier/prettier)


[error] 147-147: Replace ········ with ····

(prettier/prettier)


[error] 148-149: Replace ··});⏎ with });

(prettier/prettier)

🔇 Additional comments (3)
scripts/markdown/check-markdown.js (1)

158-158: LGTM!

The exports correctly include all the necessary functions.

tests/markdown/check-markdown.test.js (2)

17-27: LGTM!

The test setup and teardown are well-structured and handle cleanup properly.

🧰 Tools
🪛 eslint

[error] 17-17: Replace ···· with ··

(prettier/prettier)


[error] 18-18: Delete ····

(prettier/prettier)


[error] 19-19: Replace ········ with ····

(prettier/prettier)


[error] 20-20: Replace ········ with ····

(prettier/prettier)


[error] 21-21: Delete ··

(prettier/prettier)


[error] 23-23: Replace ···· with ··

(prettier/prettier)


[error] 24-24: Delete ····

(prettier/prettier)


[error] 25-25: Delete ····

(prettier/prettier)


[error] 26-26: Delete ····

(prettier/prettier)


[error] 27-27: Delete ··

(prettier/prettier)


121-139: LGTM!

The main function tests appropriately cover both error and success cases. As per previous learnings, the simple success test is sufficient since the underlying functions are tested elsewhere.

🧰 Tools
🪛 eslint

[error] 121-121: Delete ··

(prettier/prettier)


[error] 122-122: Delete ····

(prettier/prettier)


[error] 124-124: Replace ········ with ····

(prettier/prettier)


[error] 126-126: Delete ····

(prettier/prettier)


[error] 128-131: Replace ········expect(mockConsoleError).toHaveBeenCalledWith(⏎············'Failed·to·validate·markdown·files:',⏎············expect.any(Error)⏎········ with ····expect(mockConsoleError).toHaveBeenCalledWith('Failed·to·validate·markdown·files:',·expect.any(Error)

(prettier/prettier)


[error] 132-132: Delete ··

(prettier/prettier)


[error] 134-134: Delete ··

(prettier/prettier)


[error] 135-136: Delete ⏎····

(prettier/prettier)


[error] 138-138: Replace ········ with ····

(prettier/prettier)


[error] 139-139: Delete ··

(prettier/prettier)

@vishvamsinh28
Copy link
Contributor Author

@akshatnema I have applied the suggestions provided by Coderabbit. However, I have ignored a few suggestions because they caused the script/test to not work as expected.

@akshatnema
Copy link
Member

/rtm

@asyncapi-bot asyncapi-bot merged commit 55f0147 into asyncapi:master Dec 14, 2024
19 checks passed
@anshgoyalevil anshgoyalevil added the gsoc This label should be used for issues or discussions related to ideas for Google Summer of Code label Dec 14, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
gsoc This label should be used for issues or discussions related to ideas for Google Summer of Code ready-to-merge
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants