Release 1.0.alpha.6

.github/workflows/codeql.yml

@@ -9,9 +9,9 @@
 # the `language` matrix defined below to confirm you have the correct set of
 # supported CodeQL languages.
 #
 name: "CodeQL"
 
 on:
   push:
     branches: ["develop", "main"]
   pull_request:
@@ -40,7 +40,7 @@
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
       # Initializes the CodeQL tools for scanning.
       - name: Initialize CodeQL
@@ -51,7 +51,7 @@
           # By default, queries listed here will override any specified in a config file.
           # Prefix the list here with "+" to use these queries and those in the config file.
 
           # Details on CodeQL's query packs refer to : https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
           # queries: security-extended,security-and-quality
 
 
@@ -61,10 +61,10 @@
         uses: github/codeql-action/autobuild@v2
 
       # ℹ️ Command-line programs to run using the OS shell.
       # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
 
       #   If the Autobuild fails above, remove it and uncomment the following three lines.
       #   modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
 
       # - run: |
       #   echo "Run, Build Application using script"

.github/workflows/run-all-tests.yml

@@ -2,17 +2,17 @@
 # run tests and lint with a variety of Python versions
 ---
 name: Tests
 on: [push, pull_request]
 
 jobs:
   cpython:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12-dev']
+        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12']
 
     steps:
-      - uses: actions/checkout@v3.2.0
+      - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v4
         with:
@@ -29,10 +29,10 @@
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11']
+        python-version: ['3.7', '3.8', '3.9', '3.10', '3.11', '3.12']
 
     steps:
-      - uses: actions/checkout@v3.2.0
+      - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v4
         with:
@@ -46,9 +46,11 @@
         run: |
           pytest tests --cov=fastkml --cov=tests --cov-fail-under=88 --cov-report=xml
       - name: "Upload coverage to Codecov"
+        if: ${{ matrix.python-version==3.11 }}
         uses: codecov/codecov-action@v3
         with:
           fail_ci_if_error: true
+          verbose: true
 
   static-tests:
     runs-on: ubuntu-latest
@@ -57,7 +59,7 @@
         python-version: ['3.9']
 
     steps:
-      - uses: actions/checkout@v3.2.0
+      - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v4
         with:
@@ -73,7 +75,8 @@
         run: |
           flake8 fastkml examples docs
           black --check fastkml examples docs
-          yamllint .github/workflows/
+          yamllint .github/
+          yamllint .*.y*ml
       - name: Check complexity
         run: |
           radon cc --min B fastkml
@@ -84,9 +87,9 @@
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        pypy-version: ['pypy-3.7', 'pypy-3.8', 'pypy-3.9']
+        pypy-version: ['pypy-3.7', 'pypy-3.8', 'pypy-3.9', 'pypy-3.10']
     steps:
-      - uses: actions/checkout@v3.2.0
+      - uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.pypy-version }}
         uses: actions/setup-python@v4
         with:
@@ -104,7 +107,7 @@
     name: Build and publish to PyPI and TestPyPI
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v3.2.0
+      - uses: actions/checkout@v4
       - name: Set up Python 3.9
         uses: actions/setup-python@v4
         with:

.gitignore

@@ -23,10 +23,14 @@ setup.cfg
 # Installer logs
 pip-log.txt
 
-# Unit test / coverage reports
+# Unit/static test / coverage reports
 .coverage
+coverage.xml
 .tox
+.pytest_cache/
 nosetests.xml
+.ruff_cache/
+monkeytype.sqlite3
 
 # Translations
 *.mo
@@ -51,6 +55,8 @@ venv
 .mypy_cache/
 .pyre/
 .watchmanconfig
+.pytype/
+
 
 # misc
 .dccache

.pre-commit-config.yaml

@@ -1,7 +1,7 @@
 ---
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.4.0
+    rev: v4.5.0
     hooks:
       - id: check-added-large-files
       - id: check-docstring-first
@@ -20,40 +20,69 @@ repos:
       - id: pretty-format-json
       - id: requirements-txt-fixer
       - id: trailing-whitespace
+
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: "1.2.0"
+    hooks:
+      - id: pyproject-fmt
+  - repo: https://github.com/abravalheri/validate-pyproject
+    rev: v0.15
+    hooks:
+      - id: validate-pyproject
   - repo: https://github.com/ikamensh/flynt/
-    rev: "0.77"
+    rev: "1.0.1"
     hooks:
       - id: flynt
   - repo: https://github.com/MarcoGorelli/absolufy-imports
     rev: v0.3.1
     hooks:
       - id: absolufy-imports
   - repo: https://github.com/hakancelikdev/unimport
-    rev: 33ead41ee30f1d323a9c2fcfd0114297efbbc4d5
+    rev: 1.0.0
     hooks:
       - id: unimport
         args: [--remove, --include-star-import, --ignore-init, --gitignore]
   - repo: https://github.com/asottile/pyupgrade
-    rev: v3.3.1
+    rev: v3.15.0
     hooks:
       - id: pyupgrade
         args: ["--py3-plus", "--py37-plus"]
   - repo: https://github.com/psf/black
-    rev: 22.12.0
+    rev: 23.9.1
     hooks:
       - id: black
   - repo: https://github.com/PyCQA/flake8
-    rev: 6.0.0
+    rev: 6.1.0
     hooks:
       - id: flake8
   - repo: https://github.com/pycqa/isort
-    rev: 5.11.4
+    rev: 5.12.0
     hooks:
       - id: isort
-  - repo: https://github.com/mgedmin/check-manifest
-    rev: "0.49"
+  - repo: https://github.com/charliermarsh/ruff-pre-commit
+    rev: 'v0.0.292'
+    hooks:
+      - id: ruff
+  - repo: https://github.com/PyCQA/flake8
+    rev: 6.1.0
     hooks:
-    - id: check-manifest
+      - id: flake8
+  - repo: https://github.com/pre-commit/pygrep-hooks
+    rev: v1.10.0  # Use the ref you want to point at
+    hooks:
+      - id: python-use-type-annotations
+      - id: python-check-blanket-type-ignore
+      - id: python-check-mock-methods
+      - id: python-no-log-warn
+      - id: python-use-type-annotations
+      - id: rst-backticks
+      - id: rst-directive-colons
+      - id: rst-inline-touching-normal
+      - id: text-unicode-replacement-char
+  # - repo: https://github.com/mgedmin/check-manifest
+  #   rev: "0.49"
+  #   hooks:
+  #     - id: check-manifest
   # - repo: https://github.com/Lucas-C/pre-commit-hooks-markup
   #   rev: v1.0.1
   #   hooks:

MANIFEST.in

@@ -1,10 +1,10 @@
 include *.rst
 recursive-include docs *.txt
 recursive-exclude *.pyc *.pyo
-include docs/LICENSE.GPL
-exclude fastkml/.*
+include docs LICENSE.GPL
 include *.txt
 recursive-include docs *.py
 recursive-include docs *.rst
 recursive-include docs Makefile
 recursive-include tests *.py
+recursive-include schema *.xsd

README.rst

@@ -30,7 +30,7 @@ Fastkml is continually tested
     :target: http://codecov.io/github/cleder/fastkml?branch=main
     :alt: codecov.io
 
-.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
+.. image:: https://img.shields.io/badge/code+style-black-000000.svg
     :target: https://github.com/psf/black
     :alt: Black
 

docs/contributing.rst

@@ -15,7 +15,7 @@ especially in the following ways:
 Pull Requests
 -------------
 
-Start by submitting a pull request on GitHub against the `develop` branch of the
+Start by submitting a pull request on GitHub against the ``develop`` branch of the
 repository. Your pull request should provide a good description of the change
 you are making, and/or the bug that you are fixing.
 
@@ -64,6 +64,15 @@ available.
 
 .. _tox: https://pypi.python.org/pypi/tox
 
+coverage
+~~~~~~~~
+
+You can also run the tests with coverage_ to see which lines are covered by the
+tests. This is useful for writing new tests to cover any uncovered lines::
+
+    pytest tests --cov=fastkml --cov=tests --cov-report=xml
+
+
 pre-commit
 ~~~~~~~~~~~
 

docs/index.rst

@@ -63,7 +63,7 @@ requirements, namely:
 * You can parse any KML snippet, it does not need to be a complete KML
   document.
 * It is fully tested and actively maintained.
-* Geometries are handled in the `__geo_interface__` standard.
+* Geometries are handled in the ``__geo_interface__`` standard.
 * Minimal dependencies, pure Python.
 * If available, lxml_ will be used to increase its speed.
 

examples/UsageExamples.py

@@ -13,7 +13,6 @@ def print_child_features(element):
 
 
 if __name__ == "__main__":
-
     fname = "KML_Samples.kml"
 
     k = kml.KML()

fastkml/__init__.py

@@ -34,7 +34,6 @@
 from fastkml.data import ExtendedData
 from fastkml.data import Schema
 from fastkml.data import SchemaData
-from fastkml.gx import GxGeometry
 from fastkml.kml import KML
 from fastkml.kml import Document
 from fastkml.kml import Folder
@@ -66,7 +65,6 @@
     "TimeStamp",
     "ExtendedData",
     "Data",
-    "GxGeometry",
     "Schema",
     "SchemaData",
     "StyleUrl",

fastkml/atom.py

@@ -38,6 +38,7 @@
 
 from fastkml.base import _XMLObject
 from fastkml.config import ATOMNS as NS
+from fastkml.enums import Verbosity
 from fastkml.helpers import o_from_attr
 from fastkml.helpers import o_from_subelement_text
 from fastkml.helpers import o_int_from_attr
@@ -167,8 +168,12 @@ def __init__(
     def from_element(self, element: Element) -> None:
         super().from_element(element)
 
-    def etree_element(self) -> Element:
-        return super().etree_element()
+    def etree_element(
+        self,
+        precision: Optional[int] = None,
+        verbosity: Verbosity = Verbosity.normal,
+    ) -> Element:
+        return super().etree_element(precision=precision, verbosity=verbosity)
 
 
 class _Person(_XMLObject):
@@ -227,8 +232,12 @@ def __init__(
         self.uri = uri
         self.email = email
 
-    def etree_element(self) -> Element:
-        return super().etree_element()
+    def etree_element(
+        self,
+        precision: Optional[int] = None,
+        verbosity: Verbosity = Verbosity.normal,
+    ) -> Element:
+        return super().etree_element(precision=precision, verbosity=verbosity)
 
     def from_element(self, element: Element) -> None:
         super().from_element(element)