Harmonize with new version of econ-project-templates. (#8)

Co-authored-by: Tobias Raabe <[email protected]>

Author: hmgaudecker

.github/pull_request_template.md

@@ -6,4 +6,4 @@ Provide a description and/or bullet points to describe the changes in this PR.
 
 - [ ] Reference issues which can be closed due to this PR with "Closes #x".
 - [ ] Review whether the documentation needs to be updated.
-- [ ] Document PR in CHANGES.rst.
+- [ ] Document PR in docs/changes.rst.

.pre-commit-config.yaml

@@ -94,6 +94,7 @@ repos:
     rev: v1.0.1
     hooks:
     -   id: tryceratops
+        exclude: "{{cookiecutter.project_slug}}/pyproject.toml"
 -   repo: https://github.com/pre-commit/mirrors-mypy
     rev: 'v0.931'
     hooks:

README.rst

@@ -3,7 +3,7 @@ cookiecutter-pytask-project
 
 .. image:: https://img.shields.io/github/license/pytask-dev/cookiecutter-pytask-project
     :alt: MIT license
-    :target: https://pypi.org/project/pytask
+    :target: https://github.com/pytask-dev/cookiecutter-pytask-project
 
 .. image:: https://readthedocs.org/projects/cookiecutter-pytask-project/badge/?version=latest
     :target: https://cookiecutter-pytask-project.readthedocs.io/en/latest
@@ -53,4 +53,7 @@ A: This is called the src layout and the advantages are discussed in this `artic
 Hynek Schlawack <https://hynek.me/articles/testing-packaging/>`_.
 
 Although the article discusses the src layout in terms of Python packages, it is also
-beneficial to structure a project the same way.
+beneficial to structure a project the same way. Next to the reasons discussed there, it
+is possible to use a single Python environment for multiple projects without messing
+with your PYTHONPATH (via ``pip install -e .`` or ``conda develop .``) each time and
+still import modules.

cookiecutter.json

@@ -1,27 +1,27 @@
 {
   "author": "Arianna W. Rosenbluth",
-  "email": "{{ cookiecutter.author.lower().replace(' ', '') }}@mail.edu",
+  "email": "{{ cookiecutter.author.lower().replace(' ', '') }}@nowhere.edu",
   "project_name": "Reproducible Research Template",
   "project_slug": "{{ cookiecutter.project_name.lower().replace(' ', '_').replace('-', '_') }}",
   "project_description": "A project for ...",
   "github_username": "{{ cookiecutter.author.lower().replace(' ', '') }}",
   "github_email": "{{ cookiecutter.email }}",
-  "version": "0.0.1",
   "python_version": "3.8",
   "add_tox": ["yes", "no"],
   "add_github_actions": ["yes", "no"],
   "add_mypy": ["yes", "no"],
   "add_readthedocs": ["yes", "no"],
   "add_codecov": ["yes", "no"],
-  "create_changelog": ["yes", "no"],
   "open_source_license": [
-    "MIT", "BSD", "ISC", "Apache Software License 2.0",
-    "GNU General Public License v3", "Not open source"
+    "MIT",
+    "BSD",
+    "ISC",
+    "Apache Software License 2.0",
+    "GNU General Public License v3",
+    "Not open source"
   ],
   "make_initial_commit": ["no", "yes"],
   "conda_environment_name": "{{ cookiecutter.project_slug }}",
   "create_conda_environment_at_finish": ["no", "yes"],
-  "_copy_without_render": [
-    ".github/workflows/main.yml"
-  ]
+  "_copy_without_render": [".github/workflows/main.yml"]
 }

docs/rtd_environment.yml

@@ -4,7 +4,7 @@ channels:
 
 dependencies:
   - python >= 3.7
-  - pip
+  - pip >=21.1
   - setuptools_scm
   - toml
 
@@ -14,6 +14,8 @@ dependencies:
   - nbsphinx
   - sphinx
   - sphinx-autoapi
-  - sphinx-click
   - sphinx-copybutton
   - sphinx-panels
+
+  - pip:
+    - -e ../

docs/source/api.rst

@@ -0,0 +1,11 @@
+API Reference
+=============
+
+The following documents are auto-generated and not carefully edited. They provide direct
+access to the source code and the docstrings.
+
+.. toctree::
+   :titlesonly:
+
+   /autoapi/pre_gen_project/index
+   /autoapi/post_gen_project/index

CHANGES.rst renamed to docs/source/changes.rst

@@ -4,6 +4,13 @@ Changes
 This is a record of all past cookiecutter-pytask-project releases and what went into
 them in reverse chronological order.
 
+1.2.0 - 2022-xx-xx
+------------------
+
+- :gh:`7` skips concurrent CI builds.
+- :gh:`8` harmonizes cookiecutter-pytask-project with econ-project-templates.
+- :gh:`9` deprecates Python 3.6, add support for Python 3.10 and add mypy optionally.
+
 
 1.1.0 - 2022-01-16
 ------------------
@@ -13,7 +20,7 @@ them in reverse chronological order.
   remove unnecessary packaging stuff.
 
 
-1.0.0 - 2021-01-05
+1.0.0 - 2022-01-05
 ------------------
 
 - :gh:`1` creates first release of a minimal cookiecutter template for a pytask project.

docs/source/conf.py

@@ -4,6 +4,9 @@
 documentation: https://www.sphinx-doc.org/en/master/usage/configuration.html
 
 """
+from importlib.metadata import version
+
+
 # -- Project information -----------------------------------------------------
 
 
@@ -12,24 +15,58 @@
 copyright = f"2021, {author}"  # noqa: A001
 
 # The version, including alpha/beta/rc tags, but not commit hash and datestamps
-release = "1.1.0"
+release = version("cookiecutter-pytask-project")
 # The short X.Y version.
-version = "1.1"
+version = ".".join(release.split(".")[:2])
 
 
 # -- General configuration ---------------------------------------------------
 
 # Add any Sphinx extension module names here, as strings. They can be extensions coming
 # with Sphinx (named 'sphinx.ext.*') or your custom ones.
-extensions = []
+extensions = [
+    "IPython.sphinxext.ipython_console_highlighting",
+    "IPython.sphinxext.ipython_directive",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.extlinks",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.viewcode",
+    "sphinx_copybutton",
+    "sphinx_panels",
+    "autoapi.extension",
+]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 
 # List of patterns, relative to source directory, that match files and directories to
 # ignore when looking for source files. This pattern also affects html_static_path and
 # html_extra_path.
-exclude_patterns = []
+exclude_patterns = ["build", "Thumbs.db", ".DS_Store", "**.ipynb_checkpoints"]
+
+# Configuration for autoapi to generate and API page.
+autoapi_type = "python"
+autoapi_dirs = ["../../hooks"]
+autoapi_keep_files = False
+autoapi_add_toctree_entry = False
+
+# Remove prefixed $ for bash, >>> for Python prompts, and In [1]: for IPython prompts.
+copybutton_prompt_text = r"\$ |>>> |In \[\d\]: "
+copybutton_prompt_is_regexp = True
+
+# Use these roles to create links to github users and pull requests.
+extlinks = {
+    "ghuser": ("https://github.com/%s", "@"),
+    "gh": ("https://github.com/pytask-dev/cookiecutter-pytask-project/pull/%s", "#"),
+}
+
+# Link objects to other documentations.
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3.9", None),
+    "pytask": ("https://pytask-dev.readthedocs.io/en/stable/", None),
+}
 
 
 # -- Options for HTML output -------------------------------------------------
@@ -38,6 +75,9 @@
 # builtin themes.
 html_theme = "furo"
 
+pygments_style = "sphinx"
+pygments_dark_style = "monokai"
+
 # Add any paths that contain custom static files (such as style sheets) here, relative
 # to this directory. They are copied after the builtin static files, so a file named
 # "default.css" will overwrite the builtin "default.css".

docs/source/index.rst

@@ -2,3 +2,11 @@ Welcome to cookiecutter-pytask-project's documentation!
 =======================================================
 
 .. include:: ../../README.rst
+
+
+.. toctree::
+    :caption: Contents:
+    :maxdepth: 1
+
+    changes
+    api

environment.yml

@@ -6,7 +6,7 @@ channels:
 
 dependencies:
   - python >=3.7
-  - pip
+  - pip >=21.1
   - setuptools_scm
   - toml
 
@@ -16,6 +16,7 @@ dependencies:
 
   # Misc
   - black
+  - ipython
   - mypy
   - pre-commit
   - pytest