Merge pull request #235 from Davi0kProgramsThings/fix/refactoring

Merge branch `Davi0kProgramsThings:fix/refactoring` into branch `bitfinexcom:master`.

Author: itsdeka

.flake8

@@ -0,0 +1,13 @@
+[flake8]
+max-line-length = 80
+extend-select = B950
+extend-ignore = E203,E501,E701
+
+exclude =
+    __pycache__
+    build
+    dist
+    venv
+
+per-file-ignores = 
+    */__init__.py:F401

.github/ISSUE_TEMPLATE.md

@@ -20,9 +20,9 @@ A possible solution could be...
 ## Steps to reproduce (for bugs)
 <!-- You can delete this section if you are not submitting a bug report -->
 
-1. &nbsp;
-2. &nbsp;
-3. &nbsp;
+1. 
+2. 
+3. 
 
 ### Python version
 <!-- Indicate your python version here -->

.github/PULL_REQUEST_TEMPLATE.md

@@ -20,10 +20,11 @@ PR fixes the following issue:
 
 # Checklist:
 
-- [ ] My code follows the style guidelines of this project;
-- [ ] I have performed a self-review of my code;
-- [ ] I have commented my code, particularly in hard-to-understand areas;
-- [ ] I have made corresponding changes to the documentation;
-- [ ] My changes generate no new warnings;
-- [ ] Mypy returns no errors or warnings when run on the root package;
-- [ ] Pylint returns a score of 10.00/10.00 when run on the root package;
+- [ ] I've done a self-review of my code;
+- [ ] I've made corresponding changes to the documentation;
+- [ ] I've made sure my changes generate no warnings;
+- [ ] mypy returns no errors when run on the root package;
+<!-- If you use pre-commit hooks you can always check off the following tasks -->
+- [ ] I've run black to format my code;
+- [ ] I've run isort to format my code's import statements;
+- [ ] flake8 reports no errors when run on the entire code base;

.github/workflows/bitfinex-api-py-ci.yml

@@ -8,9 +8,6 @@ on:
     branches:
       - master
 
-permissions:
-  contents: read
-
 jobs:
   build:
     runs-on: ubuntu-latest
@@ -23,7 +20,7 @@ jobs:
           python-version: '3.8'
       - name: Install bitfinex-api-py's dependencies
         run: python -m pip install -r dev-requirements.txt
-      - name: Lint the project with pylint (and fail if score is lower than 10.00/10.00)
-        run: python -m pylint bfxapi
-      - name: Run mypy to check the correctness of type hinting (and fail if any error or warning is found)
+      - name: Run pre-commit hooks (see .pre-commit-config.yaml)
+        uses: pre-commit/[email protected]
+      - name: Run mypy to ensure correct type hinting
         run: python -m mypy bfxapi

.gitignore

@@ -1,12 +1,16 @@
+.venv
+.DS_Store
 .vscode
-*.pyc
-*.log
+.python-version
+__pycache__
 
 bitfinex_api_py.egg-info
+bitfinex_api_py.dist-info
+build/
+dist/
+pip-wheel-metadata/
+.eggs
 
-__pycache__
+.idea
 
-dist
-venv
-!.gitkeep
-MANIFEST
+venv/

.isort.cfg

@@ -0,0 +1,2 @@
+[settings]
+profile = black

.pre-commit-config.yaml

@@ -0,0 +1,17 @@
+repos:
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+  - repo: https://github.com/psf/black-pre-commit-mirror
+    rev: 24.2.0
+    hooks:
+      - id: black
+  - repo: https://github.com/PyCQA/flake8
+    rev: 7.0.0
+    hooks:
+      - id: flake8
+
+        additional_dependencies: [
+          flake8-bugbear
+        ]

.pylintrc

@@ -312,7 +312,9 @@ Contributors must uphold the [Contributor Covenant code of conduct](https://gith
 1. [Installation and setup](#installation-and-setup)
     * [Cloning the repository](#cloning-the-repository)
     * [Installing the dependencies](#installing-the-dependencies)
+    * [Set up the pre-commit hooks (optional)](#set-up-the-pre-commit-hooks-optional)
 2. [Before opening a PR](#before-opening-a-pr)
+    * [Tip](#tip)
 3. [License](#license)
 
 ## Installation and setup
@@ -333,23 +335,48 @@ git clone --branch v3-beta --single-branch https://github.com/bitfinexcom/bitfin
 python3 -m pip install -r dev-requirements.txt
 ```
 
-Make sure to install `dev-requirements.txt` instead of `requirements.txt`. \
-`dev-requirements.txt` will install all dependencies in `requirements.txt` plus any development dependencies. \
-This will also install the versions in use of [`pylint`](https://github.com/pylint-dev/pylint) and [`mypy`](https://github.com/python/mypy), which you should both use before opening your PRs.
+Make sure to install `dev-requirements.txt` (and not `requirements.txt`!). \
+`dev-requirements.txt` will install all dependencies in `requirements.txt` plus any development dependency. \
+dev-requirements includes [mypy](https://github.com/python/mypy), [black](https://github.com/psf/black), [isort](https://github.com/PyCQA/isort), [flake8](https://github.com/PyCQA/flake8), and [pre-commit](https://github.com/pre-commit/pre-commit) (more on these tools in later chapters).
 
 All done, your Python 3.8+ environment should now be able to run `bitfinex-api-py`'s source code.
 
+### Set up the pre-commit hooks (optional)
+
+**Do not skip this paragraph if you intend to contribute to the project.**
+
+This repository includes a pre-commit configuration file that defines the following hooks:
+1. [isort](https://github.com/PyCQA/isort)
+2. [black](https://github.com/psf/black)
+3. [flake8](https://github.com/PyCQA/flake8)
+
+To set up pre-commit use:
+```console
+python3 -m pre-commit install
+```
+
+These will ensure that isort, black and flake8 are run on each git commit.
+
+[Visit this page to learn more about git hooks and pre-commit.](https://pre-commit.com/#introduction)
+
+#### Manually triggering the pre-commit hooks
+
+You can also manually trigger the execution of all hooks with:
+```console
+python3 -m pre-commit run --all-files
+```
+
 ## Before opening a PR
 
-**We won't accept your PR or we will request changes if the following requirements aren't met.**
+**We won't accept your PR or we'll request changes if the following requirements aren't met.**
 
 Wheter you're submitting a bug fix, a new feature or a documentation change, you should first discuss it in an issue.
 
-All PRs must follow this [PULL_REQUEST_TEMPLATE](https://github.com/bitfinexcom/bitfinex-api-py/blob/v3-beta/.github/PULL_REQUEST_TEMPLATE.md) and include an exhaustive description.
+You must be able to check off all tasks listed in [PULL_REQUEST_TEMPLATE](https://raw.githubusercontent.com/bitfinexcom/bitfinex-api-py/master/.github/PULL_REQUEST_TEMPLATE.md) before opening a pull request.
+
+### Tip
 
-Before opening a pull request, you should also make sure that:
-- [ ] [`pylint`](https://github.com/pylint-dev/pylint) returns a score of 10.00/10.00 when run against your code.
-- [ ] [`mypy`](https://github.com/python/mypy) doesn't throw any error code when run on the project (excluding notes).
+Setting up the project's pre-commit hooks will help automate this process ([more](#set-up-the-pre-commit-hooks-optional)).
 
 ## License
 

README.md

@@ -1,6 +1 @@
-from ._client import \
-    Client, \
-    REST_HOST, \
-    WSS_HOST, \
-    PUB_REST_HOST, \
-    PUB_WSS_HOST
+from ._client import PUB_REST_HOST, PUB_WSS_HOST, REST_HOST, WSS_HOST, Client