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

[#2161] One-Stop Config File for Code Portfolio #2192

Open
wants to merge 33 commits into
base: master
Choose a base branch
from

Conversation

georgetayqy
Copy link
Contributor

@georgetayqy georgetayqy commented Apr 15, 2024

Part of #2161

Proposed commit message

Currently, `report-config.json` is underutilised (it is only used for
defining report titles). However, considering the code portfolio
feature, we need to implement a config file that allows users to
quickly set up and deploy it to their favourite platform to host
websites.

Let's move to repurpose `report-config.json` into a YAML file that
users can use it to set up configs to build their code portfolio more
easily.

Other information

Requires CI/CD to be updated to Java 11:

@github-actions github-actions bot requested a deployment to dashboard-2192 April 15, 2024 06:42 Abandoned
@github-actions github-actions bot requested a deployment to docs-2192 April 15, 2024 06:42 Abandoned
@georgetayqy georgetayqy requested a review from a team April 16, 2024 06:49
docs/ug/configFiles.md Outdated Show resolved Hide resolved
@jonasongg jonasongg requested review from a team April 18, 2024 17:55
@github-actions github-actions bot requested a deployment to dashboard-2192 April 27, 2024 07:32 Abandoned
@github-actions github-actions bot requested a deployment to docs-2192 April 27, 2024 07:32 Abandoned
@github-actions github-actions bot requested a deployment to dashboard-2192 April 27, 2024 08:22 Abandoned
@github-actions github-actions bot requested a deployment to docs-2192 April 27, 2024 08:22 Abandoned
@github-actions github-actions bot requested a deployment to dashboard-2192 May 6, 2024 11:56 Abandoned
@github-actions github-actions bot requested a deployment to docs-2192 May 6, 2024 11:56 Abandoned
@github-actions github-actions bot requested a deployment to dashboard-2192 May 7, 2024 04:16 Abandoned
@github-actions github-actions bot requested a deployment to docs-2192 May 7, 2024 04:16 Abandoned
@github-actions github-actions bot requested a deployment to dashboard-2192 May 7, 2024 04:48 Abandoned
@github-actions github-actions bot requested a deployment to docs-2192 May 7, 2024 04:48 Abandoned
Copy link
Contributor

@jonasongg jonasongg left a comment

Choose a reason for hiding this comment

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

LGTM!

Copy link
Member

@ckcherry23 ckcherry23 left a comment

Choose a reason for hiding this comment

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

Great work on the YAML config file @asdfghjkxd! I have some questions and left them as comments below.

config/report-config.yaml Outdated Show resolved Hide resolved
config/report-config.yaml Outdated Show resolved Hide resolved
docs/ug/configFiles.md Show resolved Hide resolved
@@ -107,12 +107,22 @@ e.g.: `example.java` in `example-repo` can either be in the `test` group or the

<!-- ==================================================================================================== -->

## `report-config.json`
## `report-config.yaml`
Copy link
Member

Choose a reason for hiding this comment

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

Can we also update the --config flag under 'CLI syntax reference' to include report-config.yaml instead of json? https://docs-2192-pr-reposense-reposense.surge.sh/ug/cli.html#config-c

Let's also update the 'Customize using CSV config files' heading on the 'Customizing Reports` page to include YAML or remove file types entirely. https://docs-2192-pr-reposense-reposense.surge.sh/ug/customizingReports.html#customize-using-csv-config-files

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Will do!

Comment on lines 12 to 30
public static final List<String> DEFAULT_FILE_FORMATS = List.of(
"override:java", "md", "fxml"
);
public static final List<String> DEFAULT_IGNORE_GLOB_LIST = List.of(
"docs**"
);
public static final List<String> DEFAULT_IGNORE_COMMITS_LIST = List.of(
"2fb6b9b2dd9fa40bf0f9815da2cb0ae8731436c7",
"c5a6dc774e22099cd9ddeb0faff1e75f9cf4f151",
"cd7f610e0becbdf331d5231887d8010a689f87c7",
"768015345e70f06add2a8b7d1f901dc07bf70582"
);
public static final List<String> DEFAULT_IGNORE_AUTHORS_LIST = List.of(
"author1",
"author2"
);
public static final boolean DEFAULT_IS_FIND_PREVIOUS_AUTHOR = false;
public static final boolean DEFAULT_IS_SHALLOW_CLONING = true;
public static final boolean DEFAULT_IS_IGNORE_STANDALONE_CONFIG = true;
Copy link
Member

Choose a reason for hiding this comment

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

I'm not sure if we need these hardcoded default values here? Check for this in the other files inside reportconfig/ too.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I believe they are present for testing purposes (creating default instances), but I will have to check before reverting back to you!

Copy link
Contributor

Choose a reason for hiding this comment

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

If they're just for tests, could we move them into the test files like we do for test defaults for the other classes? It doesn't seem like these values are useful defaults outside of the tests.

@ckcherry23 ckcherry23 requested a review from a team May 11, 2024 20:03
@github-actions github-actions bot closed this Dec 7, 2024
@gok99 gok99 reopened this Dec 7, 2024
@github-actions github-actions bot requested a deployment to dashboard-2192 December 7, 2024 05:57 Abandoned
@github-actions github-actions bot requested a deployment to docs-2192 December 7, 2024 05:57 Abandoned
@gok99 gok99 removed the Stale label Dec 7, 2024
Copy link
Contributor

github-actions bot commented Jan 8, 2025

Hi,
We are going to mark this PR as stale because it has been inactive for the past 30 days.
If no further activity occurs within the following 7 days, it will be automatically closed so that others can take up the issue.
If you are still working on this PR, please make a follow-up commit within 7 days and leave a comment to remove the stale label.
Do let us know if you are stuck so that we can help you!'

@github-actions github-actions bot added the Stale label Jan 8, 2025
Copy link
Contributor

This PR was closed because it has been marked as stale for 7 days with no activity.
Feel free to reopen this PR if you would like to continue working on it.

@github-actions github-actions bot closed this Jan 16, 2025
@sopa301 sopa301 reopened this Jan 16, 2025
@github-actions github-actions bot requested a deployment to dashboard-2192 January 16, 2025 07:26 Abandoned
@github-actions github-actions bot requested a deployment to docs-2192 January 16, 2025 07:26 Abandoned
@sopa301 sopa301 removed the Stale label Jan 16, 2025
@georgetayqy
Copy link
Contributor Author

If anyone would like to jump onto this to complete the feature, please feel free to do so!

JoanneHing and others added 7 commits January 27, 2025 13:21
reposense#2260)

Update GitHub Action runner to macOS 13, 14, 15 and remove macOS 12

The macOS 12 version is deprecated and removed by the end of 2024.
This commit updates the GitHub Action runner to use macOS 13, 14,
and 15 instead.
Add ubuntu-24.04 to CI runners

This PR updates the CI configuration to include Ubuntu 24.04 as one 
of the runners. This ensures that our code is tested on the latest
Ubuntu version, providing better compatibility and early detection
of potential issues.
…sense#2274)

Upgrade artifact actions to v4

All workflows using v3 of artifact actions automatically fail from
2025-01-30 onwards due to deprecation.

Let's upgrade to the latest version (v4).
Update codecov version

The depreciation of older version of codecov script causes token-less
upload of coverage report fail.

Let's update the codecov action to the latest version.

---------

Co-authored-by: CHENYIXUN <guest1@CHENYIXUN>
…ackend Task 1 (reposense#2268)

* Update suggested solution for backend task 1 hint 3

* Remove error

* Update suggested solution for backend task 1 hint 2

---------

Co-authored-by: Ryan Poon <[email protected]>
Set UTC timezone for test reports

Running Cypress tests locally uses system's default timezone
(UTC+8), causing 3 tests that check for dates to fail. These 3 tests
pass on GitHub Actions as the system's default timezone is UTC.

Let's standardize the timezone for all cypress tests to UTC.
@lyuanww lyuanww self-assigned this Feb 3, 2025
CYX22222003 and others added 4 commits February 6, 2025 00:23
…eposense#2270)

Update GSON type adapter adding methods

The registration of custom adapters for ZoneID and LocalDateTime causes
The JsonIOException to pop up when trying to run the jar file in java
17.

Let's use the registerTypeHierarchyAdapter method to add the custom
adapters instead.
Fix the <hr> element not appearing in report

The <hr> element in title.md and blurbs.md is not appearing in the
report because the normalise.css defaults the <hr> element style.

Let's override the <hr> element style in style.scss so that it will
appear in the report.
Move from Vue CLI to Vite

Vue CLI has been put on maintenance mode and its dependencies have
security issues that have not been fixed for a while. Switching to Vite
also allows us to introduce Vitest for our unit testing.

Let's install Vite and remove Vue CLI.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

9 participants