ufload3 1.0__tar.gz

ufload3-1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 Médecins Sans Frontières (MSF)
+
+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.

ufload3-1.0/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.1
+Name: ufload3
+Version: 1.0
+Summary: UniField  python3 loader
+Author: MSF
+Project-URL: Homepage, https://github.com/Unifield/ufload3
+Classifier: Programming Language :: Python :: 3
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Office365-REST-Python-Client==2.3.3
+
+# ufload3
+The Unifield Loader
+
+[![Build Status](https://travis-ci.org/Unifield/ufload3.svg?branch=master)](https://travis-ci.org/Unifield/ufload3)
+
+ufload3 is targeted at people who load dumps from live Unifield
+instances into non-production testing/staging/training
+instances. ufload3 will never leave a non-production database in a
+production configuration (it will stomp production passwords and
+disconnect from the live sync server).
+
+ufload3 is 100% Python, and has been tested on Linux and Windows.
+
+ufload3 can iterate over all the backups in a directory on ownCloud,
+and restore the latest backup for each instance. You can limit the
+list of instances to be restored.
+
+ufload3 can make coffee for you in the morning, and then do your dishes.
+
+## Installing on Windows
+
+1. Install Python 3.10 from here: https://www.python.org/downloads/windows/
+2. Add this directory to your PATH, separated from previous ones
+by a semi-colon:
+  * ;C:\Python27;C:\Python27\Scripts
+  or with cmd line in windows:
+   ```SETX /M PATH "%PATH%;C:\Python3;C:\Python3\Scripts"```
+3. In a new CMD.EXE window, type: ```pip install --upgrade ufload3```
+4. Run ```ufload3 -h``` to get help.
+5. Use Notepad to create a config file. Put the file in the same place CMD.EXE starts from, for example ```d:\Users\jae```. The file should be named ufload3.txt. Be careful: notepad.exe will create a file called ufload3.txt.txt by default. To avoid this, use "Save as..." and do not include .txt. Put the following into it:
+```
+[owncloud]
+user=username
+pw=password for OneDrive backup
+oc=your OC:OCA/OCB/OCG/OCP
+
+[postgres]
+db_user=openpg
+db_pw=yourdatabasepassword
+
+[restore]
+#adminuser=admin
+#adminpw=youradminpassword
+#userspw=youruserpassword
+workingdir=D:\
+
+[logs]
+local=D:\logs
+```
+6. Use "dir" to confirm that the file is where you expect it to be, and is named "ufload3.txt" and not "ufload3.txt.txt".
+
+For each line, put the right thing. If you do not want to put your
+password in the file, you can add the ```-pw``` flag to any command,
+after ```ufload3.exe```.
+
+## Installing on Linux
+
+```sudo pip install --upgrade ufload3```
+
+The config file is in $HOME/.ufload3
+
+## Upgrading
+
+Use the same command as you used to install it: ```pip install --upgrade ufload3```
+
+## Example Commands
+
+To see a list of all backup files for an instance: ```ufload3 ls -i OCG_HQ```
+
+For all instances, remove the ```-i``` flag.
+
+To load all of the instances from OneDrive: ```ufload3 restore```
+
+To load the OCG_HQ instance and all the OCG_NE1 instances from OneDrive: ```ufload3 restore -i OCG_HQ -i OCG_NE1```
+
+To load the OCG_HQ and OCG_NE1 instances from OneDrive and load a sync server: ```ufload3 restore -i OCG_HQ -i OCG_NE1 -load-sync-server```
+
+## Scheduling ufload3 in Windows
+
+You can use the Windows Task Scheduler to run ufload3 in order to update a
+sandbox environment every night.
+
+Use the remote option in the [logs] section to arrange for remote logging.
+
+Use a command like this to schedule it once a day: ```schtasks /create /F /TN Ufload /SC DAILY /st 20:00 /tr "cmd.exe /C start /min cmd.exe /C C:\python27\Scripts\ufload3 restore -load-sync-server"```
+
+Or this to make it run every hour: ```schtasks /create /F /TN Ufload /SC DAILY /RI 60 /st 00:00 /du 24:00 /tr "cmd.exe /C start /min cmd.exe /C C:\python27\Scripts\ufload3 restore -load-sync-server"```
+
+## Integrating other tools into ufload3
+
+Ufload's ```restore``` command has a ```-notify``` flag which will
+call a program each time a database is sucessfully loaded. The program
+receives the name of the newly loaded database as it's first argument.
+
+For instance, the following script sends e-mail when a backup file is
+older than expected:
+
+```
+#!/bin/sh
+
+db=$1
+
+# Convert OCG_NE1_COO_20161210_2102 into 20161210
+d=`echo $db | perl -F_ -lane 'print $F[-2]'`
+limit=`date --date='5 days ago' +%Y%m%d`
+
+if [ "$d" -lt "$limit" ]; then
+   echo "Database $db is too old." | mail user@example.org
+fi
+```
+
+If it was loaded in ```/bin/notify-old-db```, then
+```ufload3 restore -notify /bin/notify-old-db``` will run the script.

ufload3-1.0/README.md

@@ -0,0 +1,113 @@
+# ufload3
+The Unifield Loader
+
+[![Build Status](https://travis-ci.org/Unifield/ufload3.svg?branch=master)](https://travis-ci.org/Unifield/ufload3)
+
+ufload3 is targeted at people who load dumps from live Unifield
+instances into non-production testing/staging/training
+instances. ufload3 will never leave a non-production database in a
+production configuration (it will stomp production passwords and
+disconnect from the live sync server).
+
+ufload3 is 100% Python, and has been tested on Linux and Windows.
+
+ufload3 can iterate over all the backups in a directory on ownCloud,
+and restore the latest backup for each instance. You can limit the
+list of instances to be restored.
+
+ufload3 can make coffee for you in the morning, and then do your dishes.
+
+## Installing on Windows
+
+1. Install Python 3.10 from here: https://www.python.org/downloads/windows/
+2. Add this directory to your PATH, separated from previous ones
+by a semi-colon:
+  * ;C:\Python27;C:\Python27\Scripts
+  or with cmd line in windows:
+   ```SETX /M PATH "%PATH%;C:\Python3;C:\Python3\Scripts"```
+3. In a new CMD.EXE window, type: ```pip install --upgrade ufload3```
+4. Run ```ufload3 -h``` to get help.
+5. Use Notepad to create a config file. Put the file in the same place CMD.EXE starts from, for example ```d:\Users\jae```. The file should be named ufload3.txt. Be careful: notepad.exe will create a file called ufload3.txt.txt by default. To avoid this, use "Save as..." and do not include .txt. Put the following into it:
+```
+[owncloud]
+user=username
+pw=password for OneDrive backup
+oc=your OC:OCA/OCB/OCG/OCP
+
+[postgres]
+db_user=openpg
+db_pw=yourdatabasepassword
+
+[restore]
+#adminuser=admin
+#adminpw=youradminpassword
+#userspw=youruserpassword
+workingdir=D:\
+
+[logs]
+local=D:\logs
+```
+6. Use "dir" to confirm that the file is where you expect it to be, and is named "ufload3.txt" and not "ufload3.txt.txt".
+
+For each line, put the right thing. If you do not want to put your
+password in the file, you can add the ```-pw``` flag to any command,
+after ```ufload3.exe```.
+
+## Installing on Linux
+
+```sudo pip install --upgrade ufload3```
+
+The config file is in $HOME/.ufload3
+
+## Upgrading
+
+Use the same command as you used to install it: ```pip install --upgrade ufload3```
+
+## Example Commands
+
+To see a list of all backup files for an instance: ```ufload3 ls -i OCG_HQ```
+
+For all instances, remove the ```-i``` flag.
+
+To load all of the instances from OneDrive: ```ufload3 restore```
+
+To load the OCG_HQ instance and all the OCG_NE1 instances from OneDrive: ```ufload3 restore -i OCG_HQ -i OCG_NE1```
+
+To load the OCG_HQ and OCG_NE1 instances from OneDrive and load a sync server: ```ufload3 restore -i OCG_HQ -i OCG_NE1 -load-sync-server```
+
+## Scheduling ufload3 in Windows
+
+You can use the Windows Task Scheduler to run ufload3 in order to update a
+sandbox environment every night.
+
+Use the remote option in the [logs] section to arrange for remote logging.
+
+Use a command like this to schedule it once a day: ```schtasks /create /F /TN Ufload /SC DAILY /st 20:00 /tr "cmd.exe /C start /min cmd.exe /C C:\python27\Scripts\ufload3 restore -load-sync-server"```
+
+Or this to make it run every hour: ```schtasks /create /F /TN Ufload /SC DAILY /RI 60 /st 00:00 /du 24:00 /tr "cmd.exe /C start /min cmd.exe /C C:\python27\Scripts\ufload3 restore -load-sync-server"```
+
+## Integrating other tools into ufload3
+
+Ufload's ```restore``` command has a ```-notify``` flag which will
+call a program each time a database is sucessfully loaded. The program
+receives the name of the newly loaded database as it's first argument.
+
+For instance, the following script sends e-mail when a backup file is
+older than expected:
+
+```
+#!/bin/sh
+
+db=$1
+
+# Convert OCG_NE1_COO_20161210_2102 into 20161210
+d=`echo $db | perl -F_ -lane 'print $F[-2]'`
+limit=`date --date='5 days ago' +%Y%m%d`
+
+if [ "$d" -lt "$limit" ]; then
+   echo "Database $db is too old." | mail user@example.org
+fi
+```
+
+If it was loaded in ```/bin/notify-old-db```, then
+```ufload3 restore -notify /bin/notify-old-db``` will run the script.

ufload3-1.0/pyproject.toml

@@ -0,0 +1,24 @@
+[project]
+name = "ufload3"
+version = "1.0"
+authors = [
+  { name="MSF" },
+]
+description = "UniField  python3 loader"
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Development Status :: 3 - Alpha",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "Office365-REST-Python-Client==2.3.3",
+]
+
+[project.urls]
+Homepage = "https://github.com/Unifield/ufload3"
+
+[project.scripts]
+ufload3 = "ufload3.cli.main:main"

ufload3-1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ufload3-1.0/ufload3/__init__.py

@@ -0,0 +1,11 @@
+from . import cloud; assert cloud
+from . import db; assert db
+
+__version__ = '1.0'
+
+# null progress, can be overridden by importers
+def _progress(p):
+    pass
+
+progress = _progress
+