Add suffix function to the fs module

Author: Jouke Witteveen

docs/markdown/Fs-module.md

@@ -206,13 +206,26 @@ fs.name('foo/bar/baz.dll.a')  # baz.dll.a
 *since 0.54.0*
 
 Returns the last component of the path, dropping the last part of the
-suffix
+suffix.
 
 ```meson
 fs.stem('foo/bar/baz.dll')  # baz
 fs.stem('foo/bar/baz.dll.a')  # baz.dll
 ```
 
+### suffix
+
+*since 1.9.0*
+
+Returns the last dot-separated portion of the final component of the path
+including the dot, if any.
+
+```meson
+fs.suffix('foo/bar/baz.dll')  # .dll
+fs.suffix('foo/bar/baz.dll.a')  # .a
+fs.suffix('foo/bar')  # (empty)
+```
+
 ### read
 - `read(path, encoding: 'utf-8')` *(since 0.57.0)*:
    return a [string](Syntax.md#strings) with the contents of the given `path`.

docs/markdown/snippets/fs_suffix.md

@@ -0,0 +1,4 @@
+## Added suffix function to the FS module
+
+The basename and stem were already available. For completeness, expose also the
+suffix.

mesonbuild/modules/fs.py

@@ -62,6 +62,7 @@ def __init__(self, interpreter: 'Interpreter') -> None:
             'replace_suffix': self.replace_suffix,
             'size': self.size,
             'stem': self.stem,
+            'suffix': self.suffix,
         })
 
     def _absolute_dir(self, state: 'ModuleState', arg: 'FileOrString') -> Path:
@@ -214,6 +215,13 @@ def stem(self, state: 'ModuleState', args: T.Tuple[T.Union[FileOrString, BuildTa
         path = self._obj_to_path('fs.stem', args[0], state)
         return str(path.stem)
 
+    @noKwargs
+    @typed_pos_args('fs.suffix', (str, File, CustomTarget, CustomTargetIndex, BuildTarget))
+    @FeatureNew('fs.suffix', '1.9.0')
+    def suffix(self, state: 'ModuleState', args: T.Tuple[T.Union[FileOrString, BuildTargetTypes]], kwargs: T.Dict[str, T.Any]) -> str:
+        path = self._obj_to_path('fs.suffix', args[0], state)
+        return str(path.suffix)
+
     @FeatureNew('fs.read', '0.57.0')
     @typed_pos_args('fs.read', (str, File))
     @typed_kwargs('fs.read', KwargInfo('encoding', str, default='utf-8'))

test cases/common/220 fs module/meson.build

@@ -153,8 +153,10 @@ assert(fs.name(f[1]) == 'meson.build', 'failed to get basename')
 assert(fs.name('foo/bar/baz.dll.a') == 'baz.dll.a', 'failed to get basename with compound suffix')
 if host_machine.system() in ['cygwin', 'windows']
   assert(fs.name(btgt) == 'btgt.exe', 'failed to get basename of build target')
+  assert(fs.suffix(btgt) == '.exe', 'failed to get build target suffix')
 else
   assert(fs.name(btgt) == 'btgt', 'failed to get basename of build target')
+  assert(fs.suffix(btgt) == '', 'failed to get build target suffix')
 endif
 assert(fs.name(ctgt) == 'ctgt.txt', 'failed to get basename of custom target')
 assert(fs.name(ctgt[0]) == 'ctgt.txt', 'failed to get basename of custom target index')
@@ -163,6 +165,11 @@ assert(fs.stem('foo/bar/baz.dll.a') == 'baz.dll', 'failed to get stem with compo
 assert(fs.stem(btgt) == 'btgt', 'failed to get stem of build target')
 assert(fs.stem(ctgt) == 'ctgt', 'failed to get stem of custom target')
 assert(fs.stem(ctgt[0]) == 'ctgt', 'failed to get stem of custom target index')
+assert(fs.suffix('foo/bar/baz') == '', 'failed to get missing suffix')
+assert(fs.suffix('foo/bar/baz.dll') == '.dll', 'failed to get plain suffix')
+assert(fs.suffix('foo/bar/baz.dll.a') == '.a', 'failed to get final suffix')
+assert(fs.suffix(ctgt) == '.txt', 'failed to get suffix of custom target')
+assert(fs.suffix(ctgt[0]) == '.txt', 'failed to get suffix of custom target index')
 
 # relative_to
 if build_machine.system() == 'windows'