Modest support for vcard 4.0

.gitattributes

@@ -0,0 +1,4 @@
+# Auto detect text files and perform LF normalization
+* text eol=lf
+*.pdf binary
+*.bat eol=crlf

.github/workflows/pre-commit.yml

@@ -0,0 +1,25 @@
+name: Code Lint Check
+
+on:
+  pull_request:
+  push:
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5.1.1
+        with:
+          python-version: 3.9
+          cache: 'pip'
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          pip install pre-commit pylint
+
+      - name: Run pre-commit
+        env:
+          SKIP: mypy,no-commit-to-branch
+        run: pre-commit run --all-files

.github/workflows/test.yml

@@ -14,8 +14,8 @@ jobs:
           python-version: ${{ matrix.python-version }}
       - name: Install Requirements
         run: |
-          python -m pip install --upgrade flit pip wheel
+          python -m pip install --upgrade flit pip wheel pytest
           pip install -e .['dev']
       - name: Run Tests
         run: |
-          python tests.py
+          pytest

.gitignore

@@ -10,3 +10,4 @@ venv/**/*
 *.sublime-*
 .coverage
 venv*
+programmers-guide/build

.pre-commit-config.yaml

@@ -0,0 +1,38 @@
+repos:
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/psf/black
+    rev: 24.10.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-yaml
+      - id: check-toml
+      - id: end-of-file-fixer
+      - id: no-commit-to-branch
+        args: [ -b, main, -b, master ]
+
+  - repo: https://github.com/PyCQA/flake8
+    rev: 7.1.1
+    hooks:
+      - id: flake8
+        additional_dependencies: [ flake8-pyproject ]
+
+  - repo: local
+    hooks:
+      - id: pylint
+        name: pylint
+        entry: pylint
+        language: system
+        types: [ python ]
+        args:
+          [
+            "-rn", # Only display messages
+            "-sn", # Don't display the score
+          ]

.pylintrc

@@ -0,0 +1,39 @@
+[MASTER]
+jobs=2
+ignore-paths=(?!(vobject|tests))/*
+
+[FORMAT]
+max-line-length = 130
+
+[REFACTORING]
+max-args = 8
+max-attributes = 9
+max-bool-expr = 6
+max-branches = 32
+max-locals = 31
+max-module-lines = 1200
+max-nested-blocks = 6
+max-positional-arguments = 8
+max-statements = 95
+
+[MESSAGES CONTROL]
+disable=
+	I,
+	import-error,
+	# W
+	fixme,
+	keyword-arg-before-vararg,
+	logging-format-interpolation,
+	protected-access,
+	raise-missing-from,
+	unspecified-encoding,
+	unused-argument,
+	# C
+	import-outside-toplevel,
+	invalid-name,
+	missing-docstring,
+	unidiomatic-typecheck,
+	# R
+	duplicate-code,
+	no-else-return,
+	too-few-public-methods,

.readthedocs.yaml

@@ -0,0 +1,24 @@
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the OS, Python version, and other tools you might need
+build:
+  os: ubuntu-lts-latest
+  tools:
+    python: "3.13"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: programmers-guide/source/conf.py
+
+# declare the Python requirements required to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+  install:
+  - method: pip
+    path: .
+    extra_requirements:
+    - dev

ACKNOWLEDGEMENTS.txt

@@ -1,9 +1,9 @@
-Enormous thanks to:
-Jeffrey Harris, for his incredible work on the original package
-Tim Baxter, for all his work maintaining vobject over the past few years
-Adieu, for keeping things alive on github
-Kristian Glass, for his enormous help with testing and Python3 matters
-Gustavo Niemeyer, for all his work on dateutil
-Dave Cridland, for helping talk about vobject and working on vcard
-TJ Gabbour, for putting his heart into parsing
-Sameen Karim and Will Percival, for maintaining the package at Eventable.
+Enormous thanks to:
+Jeffrey Harris, for his incredible work on the original package
+Tim Baxter, for all his work maintaining vobject over the past few years
+Adieu, for keeping things alive on github
+Kristian Glass, for his enormous help with testing and Python3 matters
+Gustavo Niemeyer, for all his work on dateutil
+Dave Cridland, for helping talk about vobject and working on vcard
+TJ Gabbour, for putting his heart into parsing
+Sameen Karim and Will Percival, for maintaining the package at Eventable.