python setup.py install
#or
pip install git+https://github.com/nagordon/pyver

python -m pyver --help  

usage: pyver.py [-h] [-u USER] [-f FILES] [-c COMMENT] [-z ZIP] [-d DUPLICATE] [-p PREFIXIGNORE]
                {log,tree,filediff,dirdiff,find_duplicates} ...

| pyver | version: 0.3 | author: Neal Gordon |

positional arguments:
  {log,tree,filediff,dirdiff,find_duplicates}
    log                 prints pyver logs
                        Example--$ python -m pyver log
    tree                print file tree
                        Example--$ python -m pyver tree
                        Example--$ pyver tree C:/Users/user/Desktop
    filediff            creates html file of the
                        differences of an ascii text file
                        EXAMPLE--$ python -m pyver filediff
    dirdiff             creates an html file
                        of the differences of all
                        ascii text files in a directory
                        EXAMPLE--$ python -m pyver dirdiff
    find_duplicates     warning-this will move files
                        in the first directory selected
                        Searches for duplicate files
                        by name only in second directory.
                        Moves all duplicates found in the
                        first directory to a subfolder
                        named duplicates.

optional arguments:
  -h, --help            show this help message and exit
  -u USER, --user USER  user that made the pyver entry
                        EXAMPLE--$ python -m pyver -u nagordon
  -f FILES, --files FILES
                        Default is "" to to add all files.EXAMPLE of specific file extension wildcards
                        $ python -m pyver -f "*.txt|*.docx"
                        EXAMPLE for only individual files
                        $ python -m pyver "file1.txt|file2.txt"
  -c COMMENT, --comment COMMENT
                        add a comment enclosed in double quotes.
                        EXAMPLE--$ pyver -m pver -v "This is my comment"
  -z ZIP, --zip ZIP     default is False to create a zipped archive.
                        EXAMPLE--$ python -m pyver -z True
  -d DUPLICATE, --duplicate DUPLICATE
                        default is to copy all files to archive
                        directory regardless if the file has changed.
                        Use duplicate flag to skip unchanged
                        files based on hash key
                        EXAMPLE--$ python -m pyver -d False
  -p PREFIXIGNORE, --prefixignore PREFIXIGNORE
                        default is to omit any filename that starts
                        with a "." or "~" or "_"
                        To specify individual prefix omissions, list
                        them without puncuation such as ".~"
                        EXAMPLE-If no omissions are desired
                        $ python -m pyver -p
                        EXAMPLE to omit files that start with "g"
                        $ python -m pyver -p g

pydoc pyver

Help on module pyver:

NAME
    pyver - Version control for dummies

DESCRIPTION
    https://github.com/nagordon/pyver

    other references
    https://docs.python.org/3/library/argparse.html#the-parse-args-method
    https://docs.python.org/3/library/difflib.html
    https://docs.python.org/3/library/filecmp.html#module-filecmp
    https://docs.python.org/3/library/filecmp.html#the-dircmp-class


    also see - https://github.com/yebrahim/pydiff

FUNCTIONS
    add_path(add_folder='C:\\Users\\ngordon\\test')
        temporarily adds path to the system PATH variable

    all_exts()
        recursively finds files match match all criteria of a specific fiel extension

    all_files(rootDir='.', wildcard='.', prefixignore='.~')
        returns all files and directories that do not start with prefixignore
        accepts wildcards in the format *.py   or *.txt

    all_files2(ext='png', andcriteria=['.'])
        recursively finds files match match all criteria of a specific fiel extension

    cleanquote(s)
        clear off extra quotes

    clearFiles(filetypes=['exe', 'spec'])
        WARNING THIS WILL DELETE FILES SO USE CAREFULLY
        clears the files

    clearFilesExcept(filetypes=['py', 'txt', 'docx', 'xlsx'])
        WARNING THIS WILL DELETE FILES SO USE CAREFULLY
        clears the files except filetypes

    create_md5_hex_hash(fname)
        return a md5 hash key for a individual file

    create_windows_shortcut(targetfile, targetfolder)
        IN WORK-NOT CURRENTLY USED
        generate a shorcut to a windows file

        # add if running in a thread
        pythoncom.CoInitialize()

        targetfile = 'test1.xlsx'
        targetfolder = 'file_compare'

    dirdiff(dir1, dir2, filereport=True)
        Here is a simplified example of using the subdirs attribute to search
        recursively through two directories to show common different files:

        dir1 = './tutorial/test1'
        dir2 = './tutorial/test2'


        './tutorial/test1' './tutorial/test2'

    dirdiff_interactive()
        creates html file with file diff results
        the file is created in the first directory selected

    file_mtime(path)
        returns the file modified time

    filediff(file1, file2, addconext=False, contextlines=0)
        Command line interface to difflib.py providing diffs in four formats:
        html:     generates side by side comparison with change highlights.

    filediff_interactive()
        creates html file with file diff results
        the file is created in the first directory selected

    files_same(f1, f2)
        https://docs.python.org/3.6/library/filecmp.html

        returns True if the files are the same

    find_dupe_files_in_directory_interactive(movedupefiles=False)
        searches for duplicate files by name only in second directory. Moves all
           duplicates found in the first directory to a subfolder named duplicates.

        1) select first directory to find duplicates in second directory
        3) find all files in the first directory and not in the second
        5) move all duplicate files from the first directory into a subdirectory 'duplicate'



        primary application. dir1 is a photo directory,
            dir2 is your exsiting master photo library with many more photos than dir1.
            you want to merge dir1 into dir2 but not any duplicates

    find_files_recusive_glob(ext='png')

    find_modified_time(myfile)
        find when the file was last modified

    log()
        shows the contents of the pyver log file

    main()
        ### uncomment if you want to use the graphic user interface
        #from gooey import Gooey
        #@Gooey

    make_hidden(hidedir)
        creates windows hidden folder
        can also use the windows command
        os.system("attrib +s +h "+.archive)

    make_win_exe()
        creates a windows exe file that allows the pyver program to be
        run without the windows interpreter

    pyver(user, comment, archivefiles, ziparchive, duplicate)
        main function of pyver. copys files from the current directory and creates an archive.
        comma-delimmeted log file pyver.log keeps a record of the file changes

    select_directory_dialog(titletext='choose directory', mycwd='.')

    select_genericfile_dialog(mytitle='Select your file', mycwd='.', myfiletypes=[('all files', '*')])

    show_file_info(filename)
        prints file info such as time created

    string_to_bool(string)
        returns a boolean type object given a string

    tree(path='.', indent=' ')
        recursiveley prints the contents of a directory

VERSION
    0.3

AUTHOR
    Neal Gordon

FILE
    d:\neal\github\pyver\pyver.py

python -m pyver.py

not currently a pyver repo, creating archive file directory .archive
.archive set to Hidden
----files archived----
.archive\00_20181126181536\test4.dat_test4.dat.html
.archive\00_20181126181536\test1\test1.dog
.archive\00_20181126181536\test1\test1.fish
.archive\00_20181126181536\test1\test1.txt
.archive\00_20181126181536\test1\test2.txt
.archive\00_20181126181536\test1\test3.dat
.archive\00_20181126181536\test1\test4.dat
.archive\00_20181126181536\test1\test7.xlsx
.archive\00_20181126181536\test2\test3.dat
.archive\00_20181126181536\test2\test4.dat
.archive\00_20181126181536\test2\test7.xlsx
.archive\00_20181126181536\test2\test8.txt
.archive\00_20181126181536\test2\test9.xlsx

@python.exe %~dp0\pyver.py %*

python pyver

python -m pyver -f "*.xlsx" -d False -c "updating my excel files only and only keeping files that change"

extension .html not found or skipping
extension .dog not found or skipping
extension .fish not found or skipping
extension .txt not found or skipping
extension .txt not found or skipping
extension .dat not found or skipping
extension .dat not found or skipping
.xlsx added .\test1\test7.xlsx
extension .dat not found or skipping
extension .dat not found or skipping
.xlsx added .\test2\test7.xlsx
extension .txt not found or skipping
.xlsx added .\test2\test9.xlsx
----files archived----
test1\test7.xlsx is an archived unchanged file, skipping new archive
test2\test7.xlsx is an archived unchanged file, skipping new archive
.archive\03_20181126182456\test2\test9.xlsx

$ python -m pyver dirdiff

----comparing directory test1 and test2----
diff test1 test2
Only in test1 : ['.test1.txt', 'test1.dog', 'test1.fish', 'test1.txt', 'test2.txt', '~test.txt']
Only in test2 : ['test8.txt', 'test9.xlsx']
Identical files : ['test3.dat', 'test7.xlsx']
Differing files : ['test4.dat']
created html diff report for test4.dat
created test4.dat_test4.dat.html

python -m pyver log

User,      Timestamp,            Size,      Comment

neal,      00_20181126181536,    11 kb,

neal,      01_20181126181633,    11 kb,

python -m pyver tree

   ./.archive
    |  ./00_20181126181536
    |   |  ./test1
    |   |   |     test1.dog
    |   |   |     test1.fish
    |   |   |     test1.txt
    |   |   |     test2.txt
    |   |   |     test3.dat
    |   |   |     test4.dat
    |   |   |     test7.xlsx
    |   |  ./test2
    |   |   |     test3.dat
    |   |   |     test4.dat
    |   |   |     test7.xlsx
    |   |   |     test8.txt
    |   |   |     test9.xlsx
    |   |     test4.dat_test4.dat.html
    |  ./01_20181126181633
    |   |  ./test1
    |   |   |     test1.dog
    |   |   |     test1.fish
    |   |   |     test1.txt
    |   |   |     test2.txt
    |   |   |     test3.dat
    |   |   |     test4.dat
    |   |   |     test7.xlsx
    |   |  ./test2
    |   |   |     test3.dat
    |   |   |     test4.dat
    |   |   |     test7.xlsx
    |   |   |     test8.txt
    |   |   |     test9.xlsx
    |   |     test4.dat_test4.dat.html
    |     pyver.jsn
    |     pyver.log
   ./test1
    |     .test1.txt
    |     test1.dog
    |     test1.fish
    |     test1.txt
    |     test2.txt
    |     test3.dat
    |     test4.dat
    |     test7.xlsx
    |     ~test.txt
   ./test2
    |     test3.dat
    |     test4.dat
    |     test7.xlsx
    |     test8.txt
    |     test9.xlsx
      test4.dat_test4.dat.html

pyinstaller pyver.py --onefile