Merge pull request #247 from schmouk/dev

schmouk · web-flow · commit 9a93efca349a · 2026-01-01T16:45:33.000+01:00
Dev -- Main
diff --git a/LICENSE b/LICENSE
@@ -1,7 +1,7 @@
                     GNU GENERAL PUBLIC LICENSE
                        Version 3, 29 June 2007
 
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Copyright (C) 2007-2026 Free Software Foundation, Inc. <https://fsf.org/>
  Everyone is permitted to copy and distribute verbatim copies
  of this license document, but changing it is not allowed.
 
diff --git a/README.md b/README.md
@@ -40,7 +40,7 @@ pythonic-cpp-strings github web pages: [https://schmouk.github.io/pythonic-cpp-s
     Library cpp-strings
     "What if c++ strings where as easy to use as Python strings?"
 
-    Copyright (C) 2023-2025 Philippe Schmouker
+    Copyright (C) 2023-2026 Philippe Schmouker
     contact - ph (dot) schmouker (at) gmail (dot) com
 
     This program is free software: you can redistribute it and/or modify
diff --git a/cpp-strings-tests/cpp-strings-tests.cpp b/cpp-strings-tests/cpp-strings-tests.cpp
@@ -3,7 +3,7 @@
 	"What if c++ strings where as easy to use as Python strings?"
 	Unit tests part of the library.
 
-	Copyright (C) 2025 Philippe Schmouker
+	Copyright (C) 2025-2026 Philippe Schmouker
 	contact - ph (dot) schmouker (at) gmail (dot) com
 
 	This program is free software: you can redistribute it and/or modify
diff --git a/cpp-strings/cppstrings.h b/cpp-strings/cppstrings.h
@@ -3,7 +3,7 @@
     Library cppstrings
     "What if c++ strings where as easy to use as Python strings?"
 
-    Copyright (C) 2023-2025 Philippe Schmouker
+    Copyright (C) 2023-2026 Philippe Schmouker
     contact - ph (dot) schmouker (at) gmail (dot) com
 
     This program is free software: you can redistribute it and/or modify
diff --git a/documentation/clipboard.js b/documentation/clipboard.js
@@ -5,7 +5,7 @@ https://github.com/jothepro/doxygen-awesome-css
 
 MIT License
 
-Copyright (c) 2021 - 2022 jothepro
+Copyright (c) 2021 - 2026 jothepro
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/documentation/cookie.js b/documentation/cookie.js
@@ -1,6 +1,6 @@
 /*!
  Cookie helper functions
- Copyright (c) 2023 Dimitri van Heesch
+ Copyright (c) 2023-2026 Dimitri van Heesch
  Released under MIT license.
 */
 let Cookie = {
diff --git a/documentation/dynsections.js b/documentation/dynsections.js
@@ -3,7 +3,7 @@
 
  The MIT License (MIT)
 
- Copyright (C) 1997-2020 by Dimitri van Heesch
+ Copyright (C) 1997-2026 by Dimitri van Heesch
 
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software
  and associated documentation files (the "Software"), to deal in the Software without restriction,
diff --git a/documentation/jquery.js b/documentation/jquery.js
diff --git a/documentation/menu.js b/documentation/menu.js
@@ -3,7 +3,7 @@
 
  The MIT License (MIT)
 
- Copyright (C) 1997-2020 by Dimitri van Heesch
+ Copyright (C) 1997-2026 by Dimitri van Heesch
 
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software
  and associated documentation files (the "Software"), to deal in the Software without restriction,
diff --git a/documentation/menudata.js b/documentation/menudata.js
@@ -3,7 +3,7 @@
 
  The MIT License (MIT)
 
- Copyright (C) 1997-2020 by Dimitri van Heesch
+ Copyright (C) 1997-2026 by Dimitri van Heesch
 
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software
  and associated documentation files (the "Software"), to deal in the Software without restriction,
diff --git a/documentation/namespacepcs.html b/documentation/namespacepcs.html
@@ -236,7 +236,7 @@
 </table>
 <a name="details" id="details"></a><h2 id="header-details" class="groupheader">Detailed Description</h2>
 <div class="textblock"><p>Library cppstrings "What if c++ strings where as easy to use as Python strings?"</p>
-<p>Copyright (C) 2023-2025 Philippe Schmouker contact - ph (dot) schmouker (at) gmail (dot) com</p>
+<p>Copyright (C) 2023-2026 Philippe Schmouker contact - ph (dot) schmouker (at) gmail (dot) com</p>
 <p>This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p>
 <p>This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.</p>
 <p>You should have received a copy of the GNU General Public License along with this program. If not, see <a href="https://www.gnu.org/licenses/">https://www.gnu.org/licenses/</a>. </p>
diff --git a/documentation/navtree.js b/documentation/navtree.js
@@ -3,7 +3,7 @@
 
  The MIT License (MIT)
 
- Copyright (C) 1997-2020 by Dimitri van Heesch
+ Copyright (C) 1997-2026 by Dimitri van Heesch
 
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software
  and associated documentation files (the "Software"), to deal in the Software without restriction,
diff --git a/documentation/navtreedata.js b/documentation/navtreedata.js
@@ -3,7 +3,7 @@
 
  The MIT License (MIT)
 
- Copyright (C) 1997-2020 by Dimitri van Heesch
+ Copyright (C) 1997-2026 by Dimitri van Heesch
 
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software
  and associated documentation files (the "Software"), to deal in the Software without restriction,
diff --git a/documentation/search/search.js b/documentation/search/search.js
@@ -3,7 +3,7 @@
 
  The MIT License (MIT)
 
- Copyright (C) 1997-2020 by Dimitri van Heesch
+ Copyright (C) 1997-2026 by Dimitri van Heesch
 
  Permission is hereby granted, free of charge, to any person obtaining a copy of this software
  and associated documentation files (the "Software"), to deal in the Software without restriction,
diff --git a/scripts/__init__.py b/scripts/__init__.py
diff --git a/scripts/__pycache__/copyright_dates_modification.cpython-313.opt-2.pyc b/scripts/__pycache__/copyright_dates_modification.cpython-313.opt-2.pyc
diff --git a/scripts/__pycache__/copyright_dates_modification.cpython-314.opt-2.pyc b/scripts/__pycache__/copyright_dates_modification.cpython-314.opt-2.pyc
diff --git a/scripts/copyright_dates_modification.py b/scripts/copyright_dates_modification.py
@@ -0,0 +1,192 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2017-2026 Philippe Schmouker, schmouk (at) gmail.com
+
+Permission is hereby granted,  free of charge,  to any person obtaining a copy
+of this software and associated documentation files (the "Software"),  to deal
+in the Software without restriction, including  without  limitation the rights
+to use,  copy,  modify,  merge,  publish,  distribute, sublicense, and/or sell
+copies of the Software,  and  to  permit  persons  to  whom  the  Software  is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS",  WITHOUT WARRANTY OF ANY  KIND,  EXPRESS  OR
+IMPLIED,  INCLUDING  BUT  NOT  LIMITED  TO  THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT  SHALL  THE
+AUTHORS  OR  COPYRIGHT  HOLDERS  BE  LIABLE  FOR  ANY CLAIM,  DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT,  TORT OR OTHERWISE, ARISING FROM,
+OUT  OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+"""
+
+#=============================================================================
+from   datetime  import date
+from   os        import listdir as os_listdir, path as os_path, remove as os_remove, replace as os_replace
+import re 
+from   sys       import stdout as sys_stdout
+
+
+#=============================================================================
+class CopyrightDatesModification:
+    """    Helps automatically modifying the dates of copyright for some S/W.
+    """
+    
+    #-------------------------------------------------------------------------
+    def __init__(self, base_directory      : str      ,
+                       excluded_directories: list = [],
+                       excluded_suffixes   : list = [] ) -> None:
+        '''Constructor.
+        
+        Args:
+            base_directory: the path to the base directory from which the
+                version,  revision  and  date of last modification of the
+                software will be evaluated down to the directories tree.
+        '''
+        self.base_directory       = base_directory
+        self.excluded_directories = excluded_directories + ['__pycache__']
+        self.excluded_suffixes    = excluded_suffixes
+        self.reset() 
+    
+    #-------------------------------------------------------------------------
+    def reset(self):
+        '''Resets internal status.
+        '''
+        self.already_evaluated = False
+        self.current_year = str( date.today().year )
+        self.reg_exp = re.compile( '(1|2)[0-9]{3}' )
+
+    
+    #-------------------------------------------------------------------------
+    def modify(self, stop_count: int  = -1   ,
+                     verbose   : bool = False, 
+                     max_size  : int  = 50    ) -> None:
+        '''Runs the script that modifies the files content.
+        
+        Args:
+            stop_count: the stop number.  Once number of found copyright 
+                texts is  equal  to this stop-number,  file modification 
+                stops.  Set this to -1 to run through the whole  content 
+                of  files.  Defaults to -1  (i.e. runs through the whole
+                file content).
+        '''
+        if not self.already_evaluated:
+            self.__run_directory( self.base_directory, stop_count, verbose, max_size )
+
+
+    #-------------------------------------------------------------------------
+    def __run_directory(self, dir_path: str ,
+                              count   : int ,
+                              verbose : bool,
+                              max_size: int  ):
+        '''Recursively runs through directories to modify dates of copyright.
+        
+        Args:
+            dir_path: The path to the directory to be parsed.
+            count: the stop number.  Once number of found copyright texts
+                is  equal  to this stop-number,  file modification stops.
+                Runs through the whole content of files if count = -1.
+        '''
+        #-----------------------------------------------------------------
+        def _get_substring(match):
+            return match.string[ match.start():match.end() ]
+        
+        #-----------------------------------------------------------------
+        def _print_verbose(src_filename):
+            if len(src_filename) <= max_size:
+                file_name = src_filename
+            else:
+                file_name = '...' + src_filename[3-max_size:]
+
+            the_format = '{' + ':{:d}s'.format( max_size ) + '}  ' 
+            print( the_format.format( file_name ), end='' )
+        
+        #-----------------------------------------------------------------
+        my_dir_content = [ os_path.join(dir_path, filename) for filename in os_listdir(dir_path) ]
+        my_subdirs     = [ dirpath  for dirpath  in my_dir_content \
+                            if os_path.isdir(dirpath) and os_path.basename(dirpath) not in self.excluded_directories ]
+        my_python_srcs = [ filepath for filepath in my_dir_content \
+                            if os_path.isfile(filepath) and not ('.git' in filepath or '.settings' in filepath) ]
+        
+        for subdir_path in my_subdirs:
+            self.__run_directory( subdir_path, count, verbose, max_size )
+        
+        for python_src_path in my_python_srcs:
+            
+            if verbose:
+                _print_verbose( python_src_path )
+                sys_stdout.flush()
+            
+            if any(python_src_path.endswith(suffix) for suffix in self.excluded_suffixes):
+                if verbose: print( 'excluded' )
+                continue
+
+            b_modified = False
+                
+            with open( python_src_path, 'r' ) as fp:
+                
+                file_content = fp.readlines()
+                for num_line, line in enumerate(file_content):
+                    if 'Copyright ' in line:
+                        dates_match = [ d for d in self.reg_exp.finditer( line ) ]
+                        
+                        if len(dates_match) == 1:
+                            try:
+                                # only one date. Is it current year?
+                                the_year = _get_substring( dates_match[0] )
+                                if the_year != self.current_year:
+                                    # well, no. So let's append current year in between
+                                    my_start_index, my_end_index = dates_match[0].start(), dates_match[0].end()
+                                    file_content[ num_line ] = '{}-{}{}'.format( line[:my_end_index],
+                                                                                 self.current_year  ,
+                                                                                 line[my_end_index:]  )
+                                    b_modified = True
+                            except:
+                                count += 1
+                        
+                        else:
+                            try:
+                                # two dates (and no more according to our copyright conventions)
+                                end_year = _get_substring( dates_match[1] )
+                                # does last year equals current one? 
+                                if end_year != self.current_year:
+                                    # well, no. So, let's change ending year with current one
+                                    my_start_index, my_end_index = dates_match[1].start(), dates_match[1].end()
+                                    file_content[ num_line ] = '{}{}{}'.format( line[:my_start_index],
+                                                                                self.current_year    ,
+                                                                                line[my_end_index:]    )
+                                    b_modified = True
+                            except:
+                                count += 1
+
+                        count -= 1
+                        if count == 0:
+                            # ok, let's stop modifying copyright dates in this file
+                            break
+                        
+            if b_modified:
+                # some copyright dates have been modified,
+                # so we have to modify file
+                try:
+                    if verbose:
+                        print( 'modified' )
+                    # save modified file
+                    new_name = python_src_path+'~'
+                    with open( new_name, 'w' ) as fp:
+                        fp.writelines( file_content )
+                    # remove former one
+                    os_remove( python_src_path )
+                    # rename new one
+                    os_replace( new_name, python_src_path )
+                    
+                except Exception as e:
+                    print( "!!! Exception raised while modifying file'{:s}\n  -- {:s}".format( python_src_path, str(e) ) )
+            else:
+                if verbose:
+                    print( 'ok' )
+
+
+        self.already_evaluated = True
+
+#=====   end of scripts.copyright_dates_modification.py   =====#
diff --git a/scripts/script_modify_copyrights.py b/scripts/script_modify_copyrights.py
@@ -0,0 +1,41 @@
+# -*- coding: utf-8 -*-
+"""
+Copyright (c) 2017-2026 Philippe Schmouker, schmouk (at) gmail.com
+
+Permission is hereby granted,  free of charge,  to any person obtaining a copy
+of this software and associated documentation files (the "Software"),  to deal
+in the Software without restriction, including  without  limitation the rights
+to use,  copy,  modify,  merge,  publish,  distribute, sublicense, and/or sell
+copies of the Software,  and  to  permit  persons  to  whom  the  Software  is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS",  WITHOUT WARRANTY OF ANY  KIND,  EXPRESS  OR
+IMPLIED,  INCLUDING  BUT  NOT  LIMITED  TO  THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT  SHALL  THE
+AUTHORS  OR  COPYRIGHT  HOLDERS  BE  LIABLE  FOR  ANY CLAIM,  DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT,  TORT OR OTHERWISE, ARISING FROM,
+OUT  OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+"""
+
+#=============================================================================
+from copyright_dates_modification import CopyrightDatesModification
+
+#=============================================================================
+if __name__ == '__main__':
+    """Modifies all copyright notices dates for the whole repository.
+    """
+
+    CopyrightDatesModification(
+        '..',
+        ['_config.yml', 'docs', '.vs', '.git', 'x64', 'Debug', 'Release', 'archive', 'packages'],
+        ['.jpg', '.png', '.js', '.vcxproj', 'vcxproj.filters', '.vcxproj.user', '.sln']
+    ).modify( verbose=True, max_size=64 )
+    
+    print( '\n-- done!' )
+   
+
+#=====   end of   scripts.script_modify_copyrights   =====#
