Hacking Python SDK » History » Version 8
Tom Clegg, 07/25/2014 06:49 PM
1 | 1 | Tom Clegg | h1. Hacking Python SDK |
---|---|---|---|
2 | |||
3 | {{toc}} |
||
4 | |||
5 | h2. Prerequisites |
||
6 | |||
7 | 6 | Brett Smith | The FUSE driver requires associated libraries to build: |
8 | 4 | Tom Clegg | |
9 | <pre> |
||
10 | 5 | Tom Clegg | sudo apt-get install libattr1-dev libfuse-dev pkg-config fuse |
11 | sudo adduser "$USER" fuse |
||
12 | sudo chmod g+rw /dev/fuse |
||
13 | sudo chown root:fuse /dev/fuse |
||
14 | 1 | Tom Clegg | </pre> |
15 | 5 | Tom Clegg | |
16 | After installing @fuse@ and adding yourself to the @fuse@ group, you need to start a new login session. Make sure the @groups@ command reports that you're in the @fuse@ group. |
||
17 | 4 | Tom Clegg | |
18 | 1 | Tom Clegg | h2. Get the source code |
19 | |||
20 | <pre> |
||
21 | cd |
||
22 | git clone https://github.com/curoverse/arvados.git |
||
23 | </pre> |
||
24 | |||
25 | 6 | Brett Smith | h2. virtualenv |
26 | |||
27 | virtualenv helps you isolate the dependencies for a specific package or environment, much like Bundler does for our Rails applications. The recommended way to deploy is to build a virtualenv for Arvados development. |
||
28 | |||
29 | To build the virtualenv, run: |
||
30 | |||
31 | <pre> |
||
32 | $ virtualenv --setuptools VENVDIR |
||
33 | </pre> |
||
34 | |||
35 | (@VENVDIR@ can be a directory anywhere you like, although best practice is to keep it outside your source directory.) |
||
36 | |||
37 | To set up the shell to use the isolated virtualenv environment, run: |
||
38 | |||
39 | <pre> |
||
40 | $ source VENVDIR/bin/activate |
||
41 | </pre> |
||
42 | |||
43 | To learn more about using and configuring virtualenv, read the "virtualenv usage documentation":https://virtualenv.pypa.io/en/latest/virtualenv.html#usage. |
||
44 | |||
45 | 1 | Tom Clegg | h2. Run tests |
46 | |||
47 | Strategy: |
||
48 | 6 | Brett Smith | # Set up the environment to use a dedicated virtualenv |
49 | 1 | Tom Clegg | # Run the client library test suite |
50 | # Build a client library package and install it to the virtualenv |
||
51 | # Run the FUSE driver test suite |
||
52 | # Build a FUSE driver package and install it to the virtualenv |
||
53 | |||
54 | Note: The test suite brings up a Keep server and an API server to run tests against. For best results: |
||
55 | * Try [[Hacking Keep]] and [[Hacking API Server]] to make sure you have all the right dependencies for running the Keep and API servers. |
||
56 | * Make sure you have a blob_signing_key in services/api/config/application.yml |
||
57 | 4 | Tom Clegg | |
58 | 6 | Brett Smith | Script (make sure to edit the first line to refer to your virtualenv): |
59 | 1 | Tom Clegg | |
60 | <pre> |
||
61 | 6 | Brett Smith | source VENVDIR/bin/activate |
62 | 1 | Tom Clegg | |
63 | cd ~/arvados/sdk/python |
||
64 | 8 | Tom Clegg | GOPATH="$HOME/go" python setup.py test |
65 | 7 | Brett Smith | python setup.py egg_info -b ".$(git log --format=format:%ct.%h -n1 .)" sdist rotate --keep=1 --match .tar.gz |
66 | 6 | Brett Smith | pip install dist/arvados-python-client-0.1.*.tar.gz |
67 | 1 | Tom Clegg | |
68 | cd ~/arvados/services/fuse |
||
69 | 8 | Tom Clegg | GOPATH="$HOME/go" python setup.py test |
70 | 7 | Brett Smith | python setup.py egg_info -b ".$(git log --format=format:%ct.%h -n1 .)" sdist rotate --keep=1 --match .tar.gz |
71 | 6 | Brett Smith | pip install dist/arvados_fuse-0.1.*.tar.gz |
72 | 1 | Tom Clegg | </pre> |