.bumpversion.cfg

@@ -1,13 +1,17 @@
 [bumpversion]
-current_version = 2.32.2
+current_version = 3.0.0
 commit = True
 tag = True
 tag_name = v{new_version}
+parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(?P<release>(\.dev|rc)[0-9]+)?
+serialize = 
+	{major}.{minor}.{patch}{release}
+	{major}.{minor}.{patch}
 
 [bumpversion:file:setup.cfg]
 search = version = {current_version}
 replace = version = {new_version}
 
-[bumpversion:file:jsonargparse.py]
+[bumpversion:file:jsonargparse/__init__.py]
 
-[bumpversion:file:sphinx/conf.py]
+[bumpversion:file:.sonarcloud.properties]

.circleci/config.yml

@@ -8,10 +8,29 @@ jobs:
       - checkout
       - run:
           name: Build wheel package
-          command: ./setup.py bdist_wheel
+          command: ./setup.py bdist_wheel sdist
       - persist_to_workspace:
           root: .
-          paths: ./dist/*.whl
+          paths:
+            - ./dist/*.whl
+            - ./dist/*.tar.gz
+  test-pypy3:
+    docker:
+      - image: pypy:3
+    steps:
+      - attach_workspace:
+          at: .
+      - run:
+          name: Run unit tests
+          command: |
+            pip3 install $(ls ./dist/*.whl)[test_no_urls]
+            pypy3 -m jsonargparse_tests coverage xml coverage_pypy3.xml
+            pip3 install $(ls ./dist/*.whl)[test,all]
+            pypy3 -m jsonargparse_tests coverage xml coverage_pypy3_all.xml
+      - persist_to_workspace:
+          root: .
+          paths:
+            - ./coverage_*.xml
   test-py38: &test-py38
     docker:
       - image: circleci/python:3.8
@@ -22,14 +41,20 @@ jobs:
           name: Run unit tests
           command: |
             py=$(python3 --version | sed -r 's|.* 3\.([0-9]+)\..*|3.\1|')
-            pip3 install --user $(ls ./dist/*.whl)[test]
-            python3 -m jsonargparse_tests
-            pip3 install --user $(ls ./dist/*.whl)[all,test]
+            virtualenv -p python3 venv$py
+            . venv$py/bin/activate
+            pip3 install $(ls ./dist/*.whl)[test_no_urls]
             python3 -m jsonargparse_tests coverage xml coverage_py$py.xml
+            pip3 install $(ls ./dist/*.whl)[test,all]
+            python3 -m jsonargparse_tests coverage xml coverage_py${py}_all.xml
       - persist_to_workspace:
           root: .
           paths:
             - ./coverage_*.xml
+  test-py39:
+    <<: *test-py38
+    docker:
+      - image: circleci/python:3.9
   test-py37:
     <<: *test-py38
     docker:
@@ -52,9 +77,16 @@ jobs:
       - run:
           name: Code coverage
           command: |
-            mv coverage_py3.8.xml coverage.xml
-            rm -f coverage_*.xml
-            bash <(curl -s https://codecov.io/bash) -t $CODECOV_TOKEN_JSONARGPARSE
+            for py in 3.5 3.6 3.7 3.8 3.9 py3; do
+              bash <(curl -s https://codecov.io/bash) \
+                -t $CODECOV_TOKEN_JSONARGPARSE \
+                -F py$py \
+                -f coverage_py$py.xml
+              bash <(curl -s https://codecov.io/bash) \
+                -t $CODECOV_TOKEN_JSONARGPARSE \
+                -F py${py}_all \
+                -f coverage_py${py}_all.xml
+            done
   publish-pypi:
     docker:
       - image: mauvilsa/docker-twine:1.11.0
@@ -63,7 +95,7 @@ jobs:
           at: .
       - run:
           name: Publish Release on PyPI
-          command: twine upload --username "${PYPI_USER}" --password "${PYPI_PASS}" ./dist/*.whl
+          command: twine upload --username "${PYPI_USER}" --password "${PYPI_PASS}" ./dist/*.whl ./dist/*.tar.gz
 
 workflows:
   version: 2
@@ -72,30 +104,35 @@ workflows:
       - build: &buildreq
           filters: &tagfilter
             tags:
-              only: /^v\d+\.\d+\.\d+$/
+              only: /^v\d+\.\d+\.\d+.*$/
       - test-py38: &testreq
           <<: *buildreq
           requires:
             - build
+      - test-py39:
+          <<: *testreq
       - test-py37:
           <<: *testreq
       - test-py36:
           <<: *testreq
       - test-py35:
           <<: *testreq
+      - test-pypy3:
+          <<: *testreq
       - codecov:
           <<: *testreq
           requires:
+            - test-pypy3
+            - test-py39
             - test-py38
+            - test-py37
+            - test-py36
+            - test-py35
       - publish-pypi:
           filters:
             branches:
               ignore: /.*/
             <<: *tagfilter
           context: pypi-upload-context
           requires:
-            - test-py38
-            - test-py37
-            - test-py36
-            - test-py35
             - codecov

.github/workflows/test.yml

@@ -0,0 +1,19 @@
+name: Python package
+on: [push]
+jobs:
+  build:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [macos-latest, windows-latest]
+        python: [3.8]
+    steps:
+      - uses: actions/checkout@v2
+      - name: Setup Python
+        uses: actions/setup-python@v2
+        with:
+          python-version: ${{ matrix.python }}
+      - name: Install Tox
+        run: pip install tox
+      - name: Run Tox
+        run: tox -e py

.gitignore

@@ -5,6 +5,8 @@ __pycache__
 .coverage
 coverage.xml
 .mypy_cache
+.tox
+venv*
 sphinx/_build
 build
 dist

.sonarcloud.properties

@@ -0,0 +1,2 @@
+sonar.sources=jsonargparse
+sonar.projectVersion=3.0.0

CHANGELOG.rst

@@ -0,0 +1,50 @@
+.. _changelog:
+
+Changelog
+=========
+
+All notable changes to this project will be documented in this file. Versions
+follow `Semantic Versioning <https://semver.org/>`_
+(``<major>.<minor>.<patch>``). Backward incompatible (breaking) changes will
+only be introduced in major versions with advance notice in the **Deprecated**
+section of releases.
+
+
+v3.0.0 (2020-12-01)
+-------------------
+
+Added
+^^^^^
+
+- Functions to add arguments from classes, methods and functions.
+- CLI function that allows creating a line command line interface with a single
+  line of code inspired by Fire.
+- Typing module that includes predefined types and type generator functions
+  for paths and restricted numbers/strings.
+- Extended support to add_argument type to allow complex type hints.
+- Parsers now include --print_config option to dump defaults.
+- Support argcomplete for tab completion of arguments.
+
+
+Changed
+^^^^^^^
+
+- ArgumentParsers by default now use as error_handler the
+  usage_and_exit_error_handler.
+- error_handler and formatter_class no longer accept as value a string.
+- Changed SimpleNamespace to Namespace to avoid unnecessary differences with
+  argparse.
+
+
+Deprecated
+^^^^^^^^^^
+
+- ActionOperators should no longer be used, the new alternative is
+  restricted number types.
+
+
+v2.X.X
+------
+
+The change log was introduced in v3.0.0. For details of the changes for previous
+versions take a look at the git log. It more or less reads like a change log.