Handle patch release versions (#2)

## Description

- Updated the version regex pattern in `StaflVersion` class to support optional prerelease metadata in the format: `major.minor.patch+build-metadata`
- Added `.DS_Store` to `.gitignore` to exclude macOS system files from version control
- Fix lint errors

## Motivation and Context

The current version regex only supports the strict format of `major.minor.patch+build` without any additional metadata. This change allows for prerelease tags and other metadata to be included after the build number with a hyphen separator, making the versioning system more flexible.

## How Has This Been Tested?

Added a new test case `test_version_patch_release` that verifies the versioner can correctly parse and handle version strings with prerelease metadata (e.g., `1.2.3+4-dev/patch`).

## Affected components

This change is self-contained and only affects the version parsing logic. Existing implementations that use the standard version format will continue to work as before.

Author: willson556

.flake8

@@ -5,7 +5,7 @@ exclude=
     env,
     build,
     dist
-max-line-length = 88
+max-line-length = 120
 # E203: whitespace before ":". Sometimes violated by black.
 # E402: Module level import not at top of file. Violated by lazy imports.
 # F401: Module imported but unused.

.gitignore

@@ -130,4 +130,7 @@ dmypy.json
 
 # example output
 example/*.csv
-settings.json
+settings.json
+
+# macOS files
+.DS_Store

staflversion/cli.py

@@ -1,5 +1,4 @@
-"""CLI interface for staflversion project.
-"""
+"""CLI interface for staflversion project."""
 
 import argparse
 

staflversion/git.py

@@ -5,7 +5,6 @@
 here you put your main classes and objects.
 """
 
-
 import subprocess
 
 from typing import List, Optional

staflversion/version.py

@@ -9,7 +9,7 @@
 @total_ordering
 class StaflVersion:
     VERSION_REGEX = re.compile(
-        r"^(?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)\+(?P<build>\d+)$"
+        r"^(?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)\+(?P<build>\d+)(-(?P<prerelease_metadata>.+))?$"
     )
 
     def __init__(self, major: int, minor: int, patch: int, build: int):
@@ -85,14 +85,16 @@ class StaflVersioner:
     _INCREMENT_MAJOR = "+semver:major"
     _INCREMENT_MINOR = "+semver:minor"
     _INCREMENT_PATCH = "+semver:patch"
-    _SET_VERSION = re.compile(r"\+semver-set:" + StaflVersion.VERSION_REGEX.pattern[1:-1])
+    _SET_VERSION = re.compile(
+        r"\+semver-set:" + StaflVersion.VERSION_REGEX.pattern[1:-1]
+    )
 
     def __init__(self, git: GitWrapper):
         self._git = git
 
     def determine_version(self) -> StaflVersion:
         tags = self._git.get_tags()
-        
+
         if tags:
             new_commit_messages = self._git.get_commit_messages_since_tag()
         else:
@@ -109,9 +111,7 @@ def determine_version(self) -> StaflVersion:
         increment_patch = any([self._INCREMENT_PATCH in m for m in new_commit_messages])
 
         versions = [
-            StaflVersion.parse(t)
-            for t in tags
-            if StaflVersion.try_parse(t) is not None
+            StaflVersion.parse(t) for t in tags if StaflVersion.try_parse(t) is not None
         ]
         versions.sort(reverse=True)
         last_version = versions[0] if versions else StaflVersion(0, 0, 0, 0)

tests/test_git.py

@@ -15,7 +15,8 @@ def tempdir():
 
 @pytest.fixture
 def sample_repo(tempdir: str, monkeypatch: MonkeyPatch):
-    # tempdir above must come before monkeypatch so that the directory is changed back before the directory is cleanup up
+    # tempdir above must come before monkeypatch so that the directory is
+    # changed back before the directory is cleaned up
     monkeypatch.chdir(tempdir)
     system(
         "git init &&\

tests/test_version.py

@@ -132,3 +132,11 @@ def test_version_determine_set_version():
     )
     versioner = StaflVersioner(git)
     assert versioner.determine_version() == StaflVersion(1, 2, 3, 4)
+
+
+def test_version_patch_release():
+    git = MockGitWrapper(
+        ["Fix critical bug +semver:patch"], ["1.2.3+4-dev/patch", "1.2.2+0"]
+    )
+    versioner = StaflVersioner(git)
+    assert versioner.determine_version() == StaflVersion(1, 2, 4, 0)