[BitPim-devel] Mac development how to?

[Allen Hancock]

Source code
The source is stored in Subversion at sourceforge.net/svn/?
group_id=75211
https://svn.sourceforge.net/svnroot/bitpim/trunk/bitpim.

ok, got the source using Subcommander, checked it out to a folder on
my computer...

Mailing list

ok, got that...

Cross Referenced

that sounds good

API Documentation

docs are a good thing...

Development log

logging is good too...

Getting Started
You will need to download and install the list of packages below.
For Python packages that don't come with a binary installer, there
is usually a setup.py file in the top level of what you downloaded.
Simply type python setup.py install and the package will be
installed. You will need to have administrative/root access.
Install Python
Linux already comes with Python. MacOS X 10.3 does as well

ok, so I am good here...

Install wxPython
wxPython is the graphics toolkit used. Grab it from
www.wxpython.org. Note that you must use version 2.6.3.3 and you
must use the Unicode version.

ok Mac users: skip that site & go here:
http://pythonmac.org/packages/py25-fat/index.html

install the 2.5 version of Python from there, then the 2.6.3.3 build
of wxpython shown below.

Install pySerial
pySerial is used to interface with the serial port. Grab it from
pyserial.sourceforge.net

ok, I think I got that...

Install APSW
APSW is the wrapper used for the SQLite database that stores some
BitPim data. You must use version 3.3.10-r1. Grab it from
www.rogerbinns.com/apsw.html.

ok, well, this didn't work well:

$ python setup.py install
running install
running build
running build_ext
building 'apsw' extension
creating build
creating build/temp.darwin-8.8.2-i386-2.3
gcc -fno-strict-aliasing -Wno-long-double -no-cpp-precomp -mno-fused-
madd -fno-common -dynamic -DNDEBUG -g -O3 -Wall -Wstrict-prototypes -
DNDEBUG=1 -DEXPERIMENTAL=1 -DSQLITE_OMIT_LOAD_EXTENSION=1 -I/System/
Library/Frameworks/Python.framework/Versions/2.3/include/python2.3 -c
apsw.c -o build/temp.darwin-8.8.2-i386-2.3/apsw.o
apsw.c:40:20: error: Python.h: No such file or directory

And a whole slew of error follow...

did I need to install w. sudo?

Get BitPim source code

got it (see above)

Get paramiko (optional)
You need paramiko if you want to use BitFling. You must use version
1.6.4 (yanma). You can get it from http://www.lag.net/paramiko/
Get pycrypto (optional)
You need pyCrypto if you want to use BitFling. You must use version
2.0.1. It can be downloaded from www.amk.ca/python/code/crypto.html

skipping these for the moment

Build native modules

ok, how, exactly is this step to be completed?

Build usb library (optional - Linux & Mac only)

ok, I am skipping this for now...

Compile string matcher (optional)
The string matcher code uses the Jaro Winkler algorithm. There is
both a C and Python implementation in the module. If you have a
large phonebook then you will want the C version as it is much faster.

do I download this from somewhere?

Mac/Linux# python setup.py build ; cp build/*/jarow.* .

Run it
python bp.py should run BitPim from a console.

and if I wanted to run it from the gui?

If you would like to work on other things, then have a look at the
todo list. Mail the bitpim-devel list if you intend to embark on
any of those, or mention what areas you want to work on and ask for
suggestions.

well, the point of all this is to be able to build a > 0.9.11
version, maybe even a universal binary, but baby steps for now...

ideally I could then get past this degree symbol in my sent box....

Thanks for any guidance!