Automatic Grouping By Date #14169
Open
Automatic Grouping By Date #14169
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…c tests currently only group based on year not months
…to-date-groups
…year following month and day, changing AutomaticDateGroup/DateGroup+ DateGranularity + tests (year/month/day)
Model of auto date groups complelte and the test added
- Add AUTOMATIC_DATE_GROUP_ID constant to MetadataSerializationConfiguration - Implement serializeAutomaticDateGroup() in GroupSerializer * Serializes field name * Serializes granularity (YEAR/MONTH/FULL_DATE) - Add AutomaticDateGroup case in serialization switch - Add getField() and getGranularity() methods to AutomaticDateGroup - Fix deepCopy() and hashCode() to include granularity Serialization format: AutomaticDateGroup:name;context;field;granularity;...
- Add AutomaticDateGroup and DateGranularity imports to GroupsParser - Implement automaticDateGroupFromString() method * Parse name, context, field from serialized string * Parse and convert granularity string to DateGranularity enum * Create AutomaticDateGroup with all parameters * Restore group details (color, icon, description) - Add condition check in fromString() to handle AutomaticDateGroup This enables AutomaticDateGroup to be loaded from .bib files, completing the save/load cycle with serialization.
Serialization tests (GroupSerializerTest.java): - Test YEAR granularity serialization - Test MONTH granularity serialization - Test serialization with color, icon, and description - Verify format: AutomaticDateGroup:name;context;field;granularity;... Deserialization tests (GroupsParserTest.java): - Test parsing YEAR granularity - Test parsing MONTH granularity - Test parsing FULL_DATE granularity - Test parsing with color, icon, and description - Verify correct object reconstruction from string Total: 7 new test cases covering all granularity types and edge cases.
Checkstyle reported DateGranularity as an unused import because we only use it through method return type inference (getGranularity().name()). The import is not needed since we don't declare any variables of this type.
- Document DateGranularity enum values - Add class-level documentation for DateGroup - Ensures these files are detected as changed files in CI for JBang testing
Logic serialization
Implement the GUI for auto date grouping
Syncing the upstream update
Hey @elliotgnn!Thank you for contributing to JabRef! Your help is truly appreciated ❤️. We have automatic checks in place, based on which you will soon get automated feedback if any of them are failing. We also use TragBot with custom rules that scans your changes and provides some preliminary comments, before a maintainer takes a look. TragBot is still learning, and may not always be accurate. In the "Files changed" tab, you can go through its comments and just click on "Resolve conversation" if you are sure that it is incorrect, or comment on the conversation if you are doubtful. Please re-check our contribution guide in case of any other doubts related to our contribution workflow. |
elliotgnn
changed the title
elliotgnn
changed the title
added 3 commits
October 26, 2025 00:34
|
Please provide steps to test without using a walkthrough. |
calixtus
changed the title
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
5 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Closes #10822
This PR adds Automatic Date Groups feature to JabRef. Users can create automatic groups by year, by year-month or by full date when the date field of entries are set. Membership is dynamic—no manual assignment. The following are the specifics of implementation.
Model
DateGranularityenum:YEAR,MONTH,FULL_DATE.DateGroup extends AbstractGroup: represents a single key like2024,2024-10, or2024-10-14. Matching uses JabRef’s aliasing (date ↔ year/month/day).AutomaticDateGroup: builds childDateGroups for all entries at the chosen granularity and merges identical keys.Serialization
GroupsParser: read/write support forAutomaticDateGroup. Deserialization is tolerant—if the granularity token is missing/invalid, it defaults toYEAR(backward-compatible with older libraries).jablib/src/main/java/org/jabref/logic/exporterandjablib/src/main/java/org/jabref/logic/importerfolderGUI
YEAR)gui/groupsfolderSteps to test
Automated tests
Corresponding unit and integration tests for model, logic have been added for testing feature and persistence, in order to run them user can execute the command:
Manual Test
Manual Test can also be carried out through directly interacting with the GUI, steps will be:
+Add groupunder walkthrough section to generate example entriesAdd Groupat the lower left cornerDateoption under Collect by section and you can keep the default granularity for DATE and YEAROKBelow are the Demonstration images:
step 2:
step 3:
step 4:
step 5:
Mandatory checks
CHANGELOG.mdin a way that is understandable for the average user (if change is visible to the user)