You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CONTRIBUTING.md
+29Lines changed: 29 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,15 @@ Welcome, and thanks for your interest in contributing to the Synapse Python clie
4
4
5
5
By contributing, you are agreeing that we may redistribute your work under this [license](LICENSE.md).
6
6
7
+
-[How to contribute](#how-to-contribute)
8
+
-[Reporting bugs or feature requests](#reporting-bugs-or-feature-requests)
9
+
-[The development life cycle](#the-development-life-cycle)
10
+
-[Fork and clone this repository](#fork-and-clone-this-repository)
11
+
-[Installing the Python Client in a virtual environment with pipenv](#installing-the-python-client-in-a-virtual-environment-with-pipenv)
12
+
-[Development](#development)
13
+
-[Testing](#testing)
14
+
-[Repository Admins](#repository-admins)
15
+
7
16
## I don't want to read this whole thing I just have a question!
8
17
9
18
> **Note:** Please don't file an issue to ask a question. You'll get faster results by using the resources below.
@@ -44,6 +53,25 @@ Developing on the Python client starts with picking a issue to work on in JIRA!
44
53
git pull upstream develop
45
54
```
46
55
56
+
#### Installing the Python Client in a virtual environment with pipenv
57
+
Perform the following one-time steps to set up your local environment.
58
+
59
+
1. This package uses Python, if you have not already, please install [pyenv](https://github.com/pyenv/pyenv#installation) to manage your Python versions. Versions supported by this package are all versions >=3.8 and <=3.11. If you do not install `pyenv` make sure that Python and `pip` are installed correctly and have been added to your PATH by running `python3 --version` and `pip3 --version`. If your installation was successful, your terminal will return the versions of Python and `pip` that you installed. **Note**: If you have `pyenv` it will install a specific version of Python for you.
60
+
61
+
2. Install `pipenv` by running `pip install pipenv`.
62
+
63
+
3. Install `synapseclient` locally using pipenv:
64
+
65
+
* pipenv
66
+
```bash
67
+
# Verify you are at the root directory for the cloned repository (ie: `cd synapsePythonClient`)
68
+
pipenv install
69
+
# To develop locally you want to add --dev
70
+
# pipenv install --dev
71
+
pipenv shell
72
+
```
73
+
74
+
4. Once completed you are ready to start developing. Commands run through the CLI, or through an IDE like visual studio code within the virtual environment will have all required dependencies automatically installed. Try running `synapse -h` in your shell to read over the available CLI commands. Or view the `Usage as a library` section in the README.md to get started using the library to write more python.
47
75
#### Development
48
76
49
77
Now that you have chosen a JIRA ticket and have your own fork of this repository. It's time to start development!
@@ -129,6 +157,7 @@ You can verify your code matches these expectations by running the **flake8** co
129
157
130
158
```
131
159
# ensure that you have the flake8 package installed
160
+
# Note: This is not required if using the pipenv virtual environment
0 commit comments