macvpnhelper

Copyright (c) 2018 Ryan SHea

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. Description: INSTALLATION ------------ 1) Homebrew a) Install Homebrew (if you don't have it) /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" b) Update Homebrew brew update && brew upgrade 2) Install python3 brew install python 3) Install package pip3 install macvpnhelper

    Run by typing "macvpnhelper" in the terminal.
    
    Alternatively, you can run the script located in this package directly. It is located in the bin/ folder.
      ./macvpnhelper
      
    NOTE: You will be prompted for keychain access for storing/retrieving the user, password, and vpn name.
    
    UPDATING
    --------
      pip3 install --upgrade macvpnhelper
    or
      pip3 uninstall macvpnhelper
      pip3 --no-cache-dir install macvpnhelper
    
    USAGE
    -----
    usage: macvpnhelper [-h] [--duration DURATION] [--clickspeed CLICKSPEED]
                        [--fillpassword FILLPASSWORD] [--warning WARNING]
                        [--interval INTERVAL] [--simulate] [--reset] [--vpn VPN]
    
    Examples:
          macvpnhelper
      Uses existing defaults of --warning=yes --duration=fd --clickspeed=normal.  The app will display a warning (which must be clicked) before filling password information and stop executing at 6pm.
    
          macvpnhelper --fillpassword=andReturn --warning=no --clickspeed=fast --interval=3
      Fills password prompt and doesn't warn that it is doing so (could type password into a different active dialog!), clicks dialog buttons quickly (use on fast machine)
    
          macvpnhelper --reset --vpn="ISS Wi-fi" --duration=3h
      Clears existing user/password information and defines a new VPN name. Runs for 3 hours before terminating.
    
    optional arguments:
      -h, --help            show this help message and exit
      --duration DURATION, -d DURATION
                            (time in hours|'wd'|'fd'|'runOnce') E.g., 8h, the amount of time (in hours) to keep the VPN active. Use 'wd' to do 9-12 and 1-6 (default), 'fd' to do 9-6, and 'runOnce' to do a single check and then terminate.
      --clickspeed CLICKSPEED, -cs CLICKSPEED
                            (superfast|fast|normal|slow|superslow) adjust based on responsiveness of your GUI
      --fillpassword FILLPASSWORD, -fp FILLPASSWORD
                            (yes|no|andReturn) type in password and optionally hit return in the dialogs.  CAUTION: since this password is provided to the GUI, it is possible that intermediate clicks will result in your password being typed to, e.g., chat dialogs. Prevent this by using 'yes' instead of 'andReturn', or making sure the clickspeed matches your GUI responsiveness.
      --warning WARNING, -w WARNING
                            (yes|no) Displays warning message prior to filling in password.
      --interval INTERVAL, -i INTERVAL
                            number of seconds to wait between polling connection status (default is 5)
      --simulate, -s        When set, script which would be executed is instead printed to the terminal.
      --reset               Use to reset your login information.
      --vpn VPN, -n VPN     Name of VPN to connect to. Must match your configured connection.

Platform: UNKNOWN Classifier: Programming Language :: Python :: 3 Classifier: License :: OSI Approved :: MIT License Classifier: Operating System :: MacOS :: MacOS X Classifier: Topic :: Utilities Classifier: Topic :: System :: Networking Classifier: Natural Language :: English Classifier: Development Status :: 4 - BetaIntended Audience :: End Users/Desktop Classifier: Environment :: Console Classifier: Environment :: MacOS X Description-Content-Type: text/markdown