Add pre-commit config to standardize files (#42)

* Add pre-commit config

* add formatted file

* Adapt pre-commit config

* Move PR template

* update ignore list for isort

* Ignore third_party for yapf

* Add yapfignore

* add yapf exclude rules

* update

* update pre commit

* Update pre commit config

* Standardize files with current pre-commit config

Author: stes

.github/ISSUE_TEMPLATE/pr_template.yml .github/pr_template.md.github/ISSUE_TEMPLATE/pr_template.yml renamed to .github/pr_template.md

@@ -3,10 +3,10 @@ name: Build docs
 on:
   push:
     branches:
-      - main 
+      - main
   pull_request:
     branches:
-      - main 
+      - main
       - public
       - dev
 
@@ -25,7 +25,7 @@ jobs:
       - name: Checkout code
         uses: actions/checkout@v3
 
-      - name: Checkout cebra figures 
+      - name: Checkout cebra figures
         uses: actions/checkout@v3
         with:
           repository: AdaptiveMotorControlLab/cebra-figures
@@ -44,7 +44,7 @@ jobs:
           cp -r assets/* .
           rm -r assets
 
-      - name: Checkout cebra demos 
+      - name: Checkout cebra demos
         uses: actions/checkout@v3
         with:
           repository: AdaptiveMotorControlLab/cebra-demos
@@ -70,12 +70,12 @@ jobs:
           export SPHINXOPTS="-W --keep-going -n"
           make docs
 
-      # NOTE(stes): To avoid issues as observed in 
+      # NOTE(stes): To avoid issues as observed in
       # https://github.com/AdaptiveMotorControlLab/CEBRA/pull/20, we modified
       # this workflow to not rely on PATs. All repos except for the website
       # repo are public and only read access is required, so we simply removed
       # the tokens from the checkout actions.
-      #  
+      #
       # For pushing the docs, I temporarily disabled the staging repo, which
       # does not add anything informative to the contributor anyways, as it just
       # tests whether or not docs can be pushed (the staging branch is not deployed).
@@ -108,5 +108,4 @@ jobs:
           destination-repository-name: 'cebra-ai'
           user-name: stes
           user-email: [email protected]
-          target-branch: main 
-
+          target-branch: main

.github/workflows/docs.yml

@@ -0,0 +1,22 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.4.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: check-yaml
+      - id: check-added-large-files
+      - id: check-executables-have-shebangs
+      - id: check-toml
+  - repo: https://github.com/google/yapf
+    rev: v0.33.0
+    hooks:
+      - id: yapf
+        additional_dependencies:
+          - pyproject.toml
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+        additional_dependencies:
+          - pyproject.toml

.pre-commit-config.yaml

@@ -0,0 +1 @@
+third_party/

.yapfignore

@@ -1,6 +1,6 @@
 # Changelog
 
-When contributing a PR, please add the title, link and a short 1-2 line description of the 
+When contributing a PR, please add the title, link and a short 1-2 line description of the
 PR to this document. If you are an external contributor, please also add your github handle.
 You can use markdown formatting in this document.
 
@@ -19,8 +19,8 @@ in this file to the released code version using the name of the github tag (e.g.
   Add ``ensemble_embeddings`` that aligns multiple embeddings and combine them into an averaged one.
 
 - **Move `max_validation_iterations` from `cebra.CEBRA` to `cebra.metrics.infonce_loss` [#527](https://github.com/AdaptiveMotorControlLab/CEBRA-dev/pull/527)**:
-  Move `max_validation_iterations` from `cebra.CEBRA` to `cebra.metrics.infonce_loss` and 
-  rename the variable to `num_batches`. 
+  Move `max_validation_iterations` from `cebra.CEBRA` to `cebra.metrics.infonce_loss` and
+  rename the variable to `num_batches`.
 
 - **Add `plot_consistency` and demo notebook [#502](https://github.com/AdaptiveMotorControlLab/CEBRA-dev/pull/502)**:
   Add `plot_consistency` helper function and complete the corresponding notebook.
@@ -50,7 +50,7 @@ It is the official first release distributed along with the publication of the C
   - **Add cebra.plot package [#385](https://github.com/stes/neural_cl/pull/385)**:
     Simplify post-hoc analysis of model performance and embeddings by collecting plotting functions for the most common usecases.
   - **Multisession API integration [#333](https://github.com/stes/neural_cl/pull/333)**:
-    Add multisession implementation compatibility to the sklearn API. 
+    Add multisession implementation compatibility to the sklearn API.
 - v0.0.2rc1
   - **Implementation for general dataloading [#305](https://github.com/stes/neural_cl/pull/305)**:
     Implement `load`, a general function to convert any supported data file types to ``numpy.array``.
@@ -59,7 +59,7 @@ It is the official first release distributed along with the publication of the C
   - **Add quick testing option [#318](https://github.com/stes/neural_cl/pull/318)**:
     Add slow marker for longer tests and a quick testing option for pytest and in github workflow.
   - **Add CITATION.cff file [#339](https://github.com/stes/neural_cl/pull/339)**:
-    Add CITATION.cff file for easy-to-use citation of the pre-print paper. 
+    Add CITATION.cff file for easy-to-use citation of the pre-print paper.
   - **Update sklearn dependency [#317](https://github.com/stes/neural_cl/pull/317)**:
     The sklearn dependency was updated to `scikit-learn` as discussed
     [in the scikit-learn docs](https://github.com/scikit-learn/sklearn-pypi-package)

CHANGELOG.md

@@ -37,4 +37,4 @@ preferred-citation:
   month: 05
   doi: 10.1038/s41586-023-06031-6
   issn: 1476-4687
-  url: https://doi.org/10.1038/s41586-023-06031-6
+  url: https://doi.org/10.1038/s41586-023-06031-6

CITATION.cff

@@ -9,7 +9,7 @@ For reference, or for printing and emailing or mailing the form it is reproduced
 
 CLA Version as of March 17th, 2023.
 
-Thank you for your interest in software from The Mathis Laboratory of 
+Thank you for your interest in software from The Mathis Laboratory of
 Adaptive Motor Control, UPMWMATHIS ("Lab").
 In order to clarify the intellectual property license
 granted with Contributions from any person or entity, the Lab

CLA.md

@@ -55,7 +55,7 @@ further defined and clarified by project maintainers.
 ## Enforcement
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported by contacting the project team at [email protected] or [email protected]. 
+reported by contacting the project team at [email protected] or [email protected].
 All complaints will be reviewed and investigated and will result in a response that
 is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.

CODE_OF_CONDUCT.md

@@ -7,60 +7,60 @@ Steffen Schneider, Jin H Lee, Mackenzie W Mathis. 2023.
 **Introduction**
 
 - This license agreement sets forth the terms and conditions under which ECOLE POLYTECHNIQUE FEDERALE DE LAUSANNE ( EPFL),
-CH-1015 Lausanne, Switzerland and Prof. Mackenzie W. Mathis and code authors (hereafter "LICENSOR") will grant you 
+CH-1015 Lausanne, Switzerland and Prof. Mackenzie W. Mathis and code authors (hereafter "LICENSOR") will grant you
 (hereafter "LICENSEE") a fully-paid, non-exclusive, and non-transferable license for academic, non-commercial purposes only
 (hereafter “LICENSE”) to use the "CEBRA" computer software program (hereafter "PROGRAM").
 
 - LICENSEE acknowledges that the PROGRAM is a research tool that is being supplied "as is", without any related services,
 improvements or warranties from LICENSOR and that this license is entered into in order to enable others to utilize the
-PROGRAM in their academic activities. 
+PROGRAM in their academic activities.
 
-- The ideas covered in this work is also patent pending (as of Jan 2023): US 63/302,670 “DIMENSIONALITY REDUCTION OF TIME-SERIES DATA, 
+- The ideas covered in this work is also patent pending (as of Jan 2023): US 63/302,670 “DIMENSIONALITY REDUCTION OF TIME-SERIES DATA,
 AND SYSTEMS AND DEVICES THAT USE THE RESULTANT EMBEDDINGS”
 
 - If this license is not appropriate for your application, please contact Prof. Mackenzie W. Mathis ([email protected])
 and/or the TTO office at EPFL ([email protected]) for a commercial use license.
 
 **Terms and Conditions of the LICENSE**
 1.	LICENSOR grants to LICENSEE a fully-paid up, non-exclusive, and non-transferable license to use the PROGRAM for academic,
-    non-commercial purposes, upon the terms and conditions hereinafter set out and until termination of this license as set 
+    non-commercial purposes, upon the terms and conditions hereinafter set out and until termination of this license as set
     forth below.
 
-2.	LICENSEE acknowledges the PROGRAM is provided "as is", without any related services or improvements from LICENSOR and 
+2.	LICENSEE acknowledges the PROGRAM is provided "as is", without any related services or improvements from LICENSOR and
     that the LICENSE is entered into in order to enable others to utilize the PROGRAM in their academic activities.
 
 3.	LICENSOR MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY REPRESENTATIONS OR
-    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR PARTICULAR PURPOSE OR THAT THE USE OF THE PROGRAM WILL NOT INFRINGE ANY 
+    WARRANTIES OF MERCHANTABILITY OR FITNESS FOR PARTICULAR PURPOSE OR THAT THE USE OF THE PROGRAM WILL NOT INFRINGE ANY
     PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS. LICENSOR shall not be liable for any direct, indirect or consequential
     damages with respect to any claim by LICENSEE or any third party arising from this Agreement or use of the PROGRAM.
-    
-4.	LICENSEE agrees that it will use the PROGRAM, and any modifications, improvements, or derivatives to PROGRAM that 
-    LICENSEE may create (collectively, "IMPROVEMENTS") solely for academic, non-commercial purposes and shall not 
+
+4.	LICENSEE agrees that it will use the PROGRAM, and any modifications, improvements, or derivatives to PROGRAM that
+    LICENSEE may create (collectively, "IMPROVEMENTS") solely for academic, non-commercial purposes and shall not
     distribute or transfer the PROGRAM or any IMPROVEMENTS to any person without prior written permission from LICENSOR.
     Any IMPROVEMENTS must remain open source with a copy of this license. The terms "academic, non-commercial", as used
-    in this Agreement, mean academic or other scholarly research which (a) is not undertaken for profit, or (b) is not 
+    in this Agreement, mean academic or other scholarly research which (a) is not undertaken for profit, or (b) is not
     intended to produce works, services, or data for commercial use, or (c) is neither conducted, nor funded, by a person
     or an entity engaged in the commercial use, application or exploitation of works similar to the PROGRAM.
 
-5.	LICENSEE agrees that they shall credit the use of CEBRA with an appropriate citation: 
-    Steffen Schneider, Jin H. Lee, Mackenzie Weygandt Mathis. Learnable latent embeddings for joint behavioral 
+5.	LICENSEE agrees that they shall credit the use of CEBRA with an appropriate citation:
+    Steffen Schneider, Jin H. Lee, Mackenzie Weygandt Mathis. Learnable latent embeddings for joint behavioral
     and neural analysis. Nature 2023 doi: https://doi.org/10.1038/s41586-023-06031-6.
 
 6.	Ownership of all rights, including copyright in the PROGRAM and in any material associated therewith, shall at all times
-   remain with LICENSOR and LICENSEE agrees to preserve the same. LICENSEE agrees not to use any portion of the PROGRAM or 
-   of any IMPROVEMENTS in any machine-readable form outside the PROGRAM, nor to make any copies except for its internal use, 
+   remain with LICENSOR and LICENSEE agrees to preserve the same. LICENSEE agrees not to use any portion of the PROGRAM or
+   of any IMPROVEMENTS in any machine-readable form outside the PROGRAM, nor to make any copies except for its internal use,
    without prior written consent of LICENSOR. LICENSEE agrees to maintain this license file with the source code and place the
-   following copyright notice on any such copies: 
+   following copyright notice on any such copies:
 
       © All rights reserved. ECOLE POLYTECHNIQUE FÉDÉRALE DE LAUSANNE, Switzerland, Laboratory of Prof. Mackenzie W. Mathis
       (UPMWMATHIS) and original authors: Steffen Schneider, Jin H Lee, Mackenzie W Mathis. 2023.
 
 7.	The LICENSE shall not be construed to confer any rights upon LICENSEE by implication or otherwise except as specifically
     set forth herein.
 
-8.	This Agreement shall be governed by the material laws of Switzerland and any dispute arising out of this Agreement or 
-    use of the PROGRAM shall be brought before the courts of Lausanne, Switzerland. 
+8.	This Agreement shall be governed by the material laws of Switzerland and any dispute arising out of this Agreement or
+    use of the PROGRAM shall be brought before the courts of Lausanne, Switzerland.
 
-9.	This Agreement and the LICENSE shall remain effective until expiration of the copyrights of the PROGRAM except that, 
+9.	This Agreement and the LICENSE shall remain effective until expiration of the copyrights of the PROGRAM except that,
     upon any breach of this Agreement by LICENSEE, LICENSOR shall have the right to terminate the LICENSE immediately upon
     notice to LICENSEE.

LICENSE.md

@@ -9,8 +9,8 @@ build: dist
 
 archlinux:
 	mkdir -p dist/arch
-	cp PKGBUILD dist/arch 
-	cp dist/cebra-0.2.0.tar.gz dist/arch 
+	cp PKGBUILD dist/arch
+	cp dist/cebra-0.2.0.tar.gz dist/arch
 	(cd dist/arch; makepkg --skipchecksums -f)
 
 # NOTE(stes): Ensure that no old tempfiles are present. Ideally, move this into
@@ -83,7 +83,7 @@ format:
 	# https://github.com/PyCQA/docformatter/issues/119
 	# is resolved.
 	# docformatter --config pyproject.toml -i cebra
-	# docformatter --config pyproject.toml -i tests 
+	# docformatter --config pyproject.toml -i tests
 	isort cebra/
 	isort tests/
 
@@ -99,4 +99,3 @@ report: check_docker format .coverage .pylint
 	coverage report
 
 .PHONY: dist build archlinux clean_test test doctest test_parallel test_parallel_debug test_all test_fast test_debug test_benchmark interrogate docs docs-touch docs-strict serve_docs serve_page format codespell check_for_binary
-