Package: obasync
DESCRIPTIONobasyncis an OpenOffice/LibreOffice Basic macro source
synchronizer.  It synchronizes your Basic macros with your local
project files.Given the following source files:Directory:MyAppFiles:MyMacros.vbUtils.vbRegistry.vbData.vbRunningobasyncwill synchronize them with the following Basic
macros:Library:MyAppModules:MyMacrosUtilsRegistryDataIf the Basic libraryMyAppdoes not exist, it will be created.
Missing modules will be added, and excess modules will be removed.On the other hand, given the following Basic macros:Library:MyAppModules:MyMacrosUtilsRegistryDataRunningobasync--getwill synchronize them with the following
source files:Directory:MyAppFiles:MyMacros.vbUtils.vbRegistry.vbData.vbMissing source files will be added, and excess source files will be
deleted.INSTALLYou can either:Installobasyncwithpip(recommended), orDownload theobasyncscript manually, and run it with the
Python that come with your OpenOffice/LibreOffice installation.We will explain them in detail.OpenOffice/LibreOffice That Comes with Your LinuxInstall withpip(Recommended)Your system may already havepipinstalled.  If not, install thepython-pippackage from the system package manager.  Then, run:pip install obasyncDownload and Install ManuallyDownloadobasyncfrom eitherPyPIorGitHub.  Then, runobasyncas:python obasyncOr, you can edit the script and change the first line (shebang) to:#! /usr/bin/pythonand save this script somewhere in your path, say,/usr/local/bin.
Then you can runobasync.OpenOffice 4 on LinuxInstall withpip(Recommended)Installpipfor your OpenOffice installation, and then installobasyncwith thispip:wget https://bootstrap.pypa.io/get-pip.py
sudo /opt/openoffice4/program/python get-pip.py
/opt/openoffice4/program/python-core-2.7.6/bin/pip install obasyncDownload and Install ManuallyDownloadobasyncfrom eitherPyPIorGitHub.  Then, runobasyncas:/opt/openoffice4/program/python obasyncOr, you can edit the script and change the first line (shebang) to:#! /opt/openoffice4/program/pythonand save this script somewhere in your path, say,/usr/local/bin.
Then you can runobasync.LibreOffice on LinuxPython from LibreOffice on Linux does not installpipproperly.
However, you can still download and installobasyncmanually.Install withpip(Recommended)Downloadobasyncfrom eitherPyPIorGitHub.  Then, runobasyncas:/opt/libreoffice5.2/program/python obasyncOr, you can edit the script and change the first line (shebang) to:#! /opt/libreoffice5.2/program/pythonand save this script somewhere in your path, say,/usr/local/bin.
Then you can runobasync.OpenOffice on MS-WindowsYou can installobasyncwithpip, but the result is messy.
The recommended way is to download and installobasyncmanually.Download and Install ManuallyDownloadobasyncfrom eitherPyPIorGitHub.  Then, runobasyncas:"C:\Program Files (x86)\OpenOffice 4\program\python.exe" obasyncLibreOffice on MS-WindowsYou can installobasyncwithpip, but the result is messy.
The recommended way is to download and installobasyncmanually.Download and Install ManuallyDownloadobasyncfrom eitherPyPIorGitHub.  Then, runobasyncas:"C:\Program Files\LibreOffice 5\program\python.exe" obasyncOpenOffice on Mac OS XInstall withpip(Recommended)Installpipfirst, and then installobasyncwithpip:wget https://bootstrap.pypa.io/get-pip.py
sudo python get-pip.py
sudo pip install obasyncDownload and Install ManuallyDownloadobasyncfrom eitherPyPIorGitHub.  Then, runobasyncas:python obasyncOr, you can edit the script and change the first line (shebang) to:#! /usr/bin/pythonand save this script somewhere in your path, say,/usr/local/bin.
Then you can runobasync.LibreOffice on Mac OS XPython from LibreOffice on Mac OS X does not installpipproperly.
However, you can still download and installobasyncmanually.Download and Install ManuallyDownloadobasyncfrom eitherPyPIorGitHub.  Then, runobasyncas:/Applications/LibreOffice.app/Contents/Resources/python obasyncOr, you can edit the script and change the first line (shebang) to:#! /Applications/LibreOffice.app/Contents/Resources/pythonand save this script somewhere in your path, say,/usr/local/bin.
Then you can runobasync.OPTIONSobasync [options] [DIRECTORY [LIBRARY]]DIRECTORY       The project source directory.  Default to the currentworking directory.LIBRARY         The name of the Basic library.  Default to the samename as the project source directory.--getDownload (check out) the macros from the
OpenOffice/LibreOffice Basic storage to the source
files, instead of upload (check in).  By default it
uploads the source files onto the
OpenOffice/LibreOffice Basic storage.--set-passwdSets the password of the library after upload.  Supply
nothing when prompting the new password to remove the
password protection.  This does not work with –get.-p,--portNThe TCP port to communicate with
OpenOffice/LibreOffice.  The default is 2002.  You can
change it if port 2002 is already in use.-x, –ext .EXT  The file name extension of the source files.  Thedefault is.vb.  This may be used for your
convenience of editor syntax highlighting.-e,--encodingCSThe encoding of the source files.  The default is
system-dependent.  For example, on Traditional Chinese
MS-Windows, this will be CP950 (Big5).  You can change
this to UTF-8 for convenience if you
obtain/synchronize your source code from other
sources.-r, –run MODULE.MACRORun he specific macro after synchronization, for
convenience.--userStore the macros in the user macro storage.  (default)--docStore the macros in the document macro storage.–target TARGET The target storage document if there are more than oneopened documents.  You may specify a partial path, or
as “Untitied 1” (in your language) if it is a new
file.-h,--helpShow the help message and exit-v,--versionShow program’s version number and exitCOPYRIGHTCopyright (c) 2016-2017 imacat.Licensed under the Apache License, Version 2.0 (the “License”);
you may not use this file except in compliance with the License.
You may obtain a copy of the License athttp://www.apache.org/licenses/LICENSE-2.0Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an “AS IS” BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.SUPPORTContact imacat <imacat@mail.imacat.idv.tw> if you have any question.