Skip to content

Commit d33911c

Browse files
Docs: add a getting started for buildng and running on Mac
1 parent c6939fa commit d33911c

File tree

1 file changed

+101
-0
lines changed

1 file changed

+101
-0
lines changed

docs/developing-conda-mac.md

+101
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,101 @@
1+
# Running on Mac OS X - tested on 10.13.4
2+
3+
## Install XCode from the Mac App Store
4+
5+
## Install the Mac OS X headers
6+
7+
```
8+
xcode-select --install
9+
```
10+
11+
## Install conda - create env - install anaconda
12+
13+
https://conda.io/miniconda.html
14+
15+
```
16+
~/Downloads/Miniconda3-latest-MacOSX-x86_64-2.sh
17+
```
18+
19+
## Build and activate conda env
20+
21+
```
22+
conda create -n 201804 python
23+
source activate 201804
24+
```
25+
26+
## Install packages in the env
27+
28+
```
29+
conda install anaconda
30+
conda install pymongo
31+
```
32+
33+
## Build and install arctic
34+
35+
```
36+
git clone [email protected]:manahl/arctic.git
37+
cd arctic
38+
python setup.py develop
39+
```
40+
41+
## Run MongoD
42+
43+
```
44+
mongod --dbpath mongo_tmp/
45+
```
46+
47+
## Connect and test arctic
48+
49+
```
50+
ipython
51+
from arctic import Arctic
52+
a = Arctic('localhost')
53+
a.initialize_library('test')
54+
l = a['test']
55+
l.write('thing', object())
56+
```
57+
58+
## Issues
59+
60+
### Not using the correct compiler on Mac OS X
61+
62+
FIXME: setup.py needs patching to use anaconda cc / g++ directly
63+
64+
65+
### tzlocal issue with pytz == 1.5.1
66+
67+
```
68+
```File "<frozen importlib._bootstrap>", line 441, in spec_from_loader
69+
File "<frozen importlib._bootstrap_external>", line 544, in spec_from_file_location
70+
File "/Users/james/miniconda3/envs/201804/lib/python3.6/site-packages/tzlocal-1.5.1-py3.6.egg/tzlocal/unix.py", line 77
71+
SyntaxError: invalid escape sequence \s
72+
```
73+
74+
`pip install pytz==1.4`
75+
76+
### Mongo not finding mongod
77+
78+
```
79+
> raise child_exception_type(errno_num, err_msg, err_filename)
80+
E FileNotFoundError: [Errno 2] No such file or directory: '/usr/bin/mongod': '/usr/bin/mongod'
81+
```
82+
83+
Point at the directory that contains the `mongod` command
84+
85+
```
86+
export SERVER_FIXTURES_MONGO_BIN=/Users/james/bin/
87+
```
88+
89+
### Tests hanging
90+
91+
This is a pytest-server-fixtures issue compatibility with MongoDB 3.6.
92+
Use MongoDB 3.4...
93+
94+
### lz4 compression issue
95+
96+
```
97+
> [lz4.decompress(y) for y in [lz4.compressHC(x) for x in _strarr]]
98+
E AttributeError: module 'lz4' has no attribute 'compressHC'
99+
```
100+
101+
Fix the integration test to be compatible with new lz4 `lz4.compress` /

0 commit comments

Comments
 (0)