1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
Setting up dev environment
==========================
We highly recommend to use `Julius Haertl docker setup <https://github.com/juliushaertl/nextcloud-docker-dev>`_ for Nextcloud dev setup.
Development of `nc-py-api` can be done on any OS as it is a **pure** Python package.
.. note:: We suggest to use **PyCharm**, but of course you can use any IDE you like for this like **VS Code** or **Vim**.
Steps to setup up the development environment:
#. Setup Nextcloud locally or remotely.
#. Install `AppAPI <https://github.com/cloud-py-api/app_api>`_, follow it's steps to register ``deploy daemon`` if needed.
#. Clone the `nc_py_api <https://github.com/cloud-py-api/nc_py_api>`_ with :command:`shell`::
git clone https://github.com/cloud-py-api/nc_py_api.git
#. Set current working dir to the root folder of cloned **nc_py_api** with :command:`shell`::
cd nc_py_api
#. Create and activate Virtual Environment with :command:`shell`::
python3 -m venv env
#. Activate Python Virtual Environment with :command:`shell`::
source ./env/bin/activate
#. Update ``pip`` to the last version with :command:`pip`::
python3 -m pip install --upgrade pip
#. Install dev-dependencies with :command:`pip`::
pip install ".[dev]"
#. Install `pre-commit` hooks with :command:`shell`::
pre-commit install
#. Run `nc_py_api` with appropriate PyCharm configuration(``register_nc_py_api(xx)``) or if you are not using PyCharm execute this command in the :command:`shell`::
APP_ID=nc_py_api APP_PORT=9009 APP_SECRET=12345 APP_VERSION=1.0.0 NEXTCLOUD_URL=http://nextcloud.local APP_HOST=0.0.0.0 python3 tests/_install.py
#. In a separate terminal while the ``nc_py_api`` **_install.py** script is running execute this command in the :command:`shell`::
make register28
#. In ``tests/gfixture.py`` edit ``NC_AUTH_USER`` and ``NC_AUTH_PASS``, if they are different in your setup.
#. Run tests to check that everything works with :command:`shell`::
python3 -m pytest
#. Install documentation dependencies if needed with :command:`pip`::
pip install ".[docs]"
#. You can easy build documentation with :command:`shell`::
make docs
#. **Your setup is ready for the developing nc_py_api and Applications based on it. Best of Luck!**
|
