Office Basic macro source synchronizer.
Go to file
2016-12-25 02:30:24 +08:00
bin Added README.rst. 2016-12-25 02:30:01 +08:00
README.rst Added README.rst. 2016-12-25 02:30:01 +08:00
setup.py Advanced to version 0.2. 2016-12-24 08:10:26 +08:00
TODO Removed the TODO item for README.rst. 2016-12-25 02:30:24 +08:00

<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> </head>

obasync - Office Basic Macro Source Synchronizer

DESCRIPTION

obasync is an OpenOffice/LibreOffice Basic macro source synchronizer. It synchronizes your Basic macros with your local project files.

Given the following source files:

  • Directory: MyApp
  • Files: MyMacros.vb Utils.vb Registry.vb Data.vb

Running obasync will synchronze them with the followin macros:

  • Library: MyApp
  • Modules: MyMacros Utils Registry Data

If the Basic library MyApp does not exist, it will be created. Missing modules will be added, and excess modules will be removed.

And vice versa. Given the following macros:

  • Library: MyApp
  • Modules: MyMacros Utils Registry Data

Running obasync --get will synchronze them with the following source files:

  • Directory: MyApp
  • Files: MyMacros.vb Utils.vb Registry.vb Data.vb

Missing source files will be added, and excess source files will be deleted.

INSTALL

You can install obasync with pip. Uses the python executable that comes with your OpenOffice/LibreOffice installation when possible.

  • OpenOffice 4 on Linux:

    /opt/openoffice4/program/python `which pip` install obasync
    
  • LibreOffice 5.x on Linux:

    /opt/libreoffice5.*/program/python `which pip` install obasync
    
  • Linux vender OpenOffice/LibreOffice installation:

    pip install obasync
    
  • OpenOffice on MacOSX relies on the system python installation:

    sudo pip install obasync
    
  • LibreOffice on MacOSX: There is no simple pip way to install obasync. However, you can still download the script and run it with the python executable that comes with your LibreOffice installation. See below.

  • OpenOffice/LibreOffice on MS-Windows: You can still install obasync with pip from your OpenOffice/LibreOffice installation. However, it would be much asir to just download the script and run it with the python executable that comes with your OpenOffice/LibreOffice installation. See below.

To download the package or the source script:

OPTIONS

obasync [options] [directory [library]]
directory
The project source directory. Default to the current working directory.
library
The name of the Basic library. Default to the same name as the project source directory.
-g,--get
Download (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.
-p,--port N
The 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. The default is .vb. This may be used for your convenience of editor syntax highlighting.
-e,--encoding CS
The 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/sychronize your source code from other sources.
-r,--run Module.Macro
Run he specific macro after sychronization, for convenience.
-h,--help
Show the help message and exit
-v,--version
Show program's version number and exit

SUPPORT

Contact imacat <imacat@mail.imacat.idv.tw> if you have any question.
</html>