python-easyverein 2.1.2__tar.gz → 2.3.0__tar.gz

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/PKG-INFO

@@ -1,12 +1,24 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-easyverein
-Version: 2.1.2
+Version: 2.3.0
 Summary: Python library to interact with the EasyVerein API
+License: Copyright 2023 Daniel Herrmann
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+License-File: LICENSE
 Author: Daniel Herrmann
 Author-email: daniel.herrmann1@gmail.com
-Requires-Python: >=3.11,<4.0
+Requires-Python: >=3.11,<4
+Classifier: License :: Other/Proprietary License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: email-validator (>=2,<3)
 Requires-Dist: pydantic (>=2,<3)
 Requires-Dist: requests (>=2,<3)
@@ -44,11 +56,14 @@ Not all endpoints offered by the EasyVerein API are supported. For now, only the
 When saying CRUD, it means the library supports various methods to **C**reate, **R**ead, **U**pdate and
 **D**elete objects. See the API reference for details on supported CRUD operations.
 
-* `contact-details`: CRUD, Soft-Delete
+* `booking`: CRUD, Bulk Create and Update, Soft-Delete
+* `billing-account`: CRUD, Soft-Delete
+* `contact-details`: CRUD, Bulk Create and Update, Soft-Delete
 * `custom-fields`: CRUD, Soft-Delete
-* `invoice`: CRUD, Soft-Delete, plus some convenience methods
+* `custom-fields/<id>/select-options`: CRUD
+* `invoice`: CRUD, Bulk Create and Update, Soft-Delete, plus some convenience methods
 * `invoice-item`: CRUD
-* `member`: CRUD, Soft-Delete
+* `member`: CRUD, Bulk Create and Update, Soft-Delete
 * `member-groups`: CRUD, Soft-Delete
 * `member/<id>/custom-fields`: CRUD, plus some convenience methods
 * `member/<id>/member-groups`: CRUD, plus some convenience methods

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/README.md

@@ -30,11 +30,14 @@ Not all endpoints offered by the EasyVerein API are supported. For now, only the
 When saying CRUD, it means the library supports various methods to **C**reate, **R**ead, **U**pdate and
 **D**elete objects. See the API reference for details on supported CRUD operations.
 
-* `contact-details`: CRUD, Soft-Delete
+* `booking`: CRUD, Bulk Create and Update, Soft-Delete
+* `billing-account`: CRUD, Soft-Delete
+* `contact-details`: CRUD, Bulk Create and Update, Soft-Delete
 * `custom-fields`: CRUD, Soft-Delete
-* `invoice`: CRUD, Soft-Delete, plus some convenience methods
+* `custom-fields/<id>/select-options`: CRUD
+* `invoice`: CRUD, Bulk Create and Update, Soft-Delete, plus some convenience methods
 * `invoice-item`: CRUD
-* `member`: CRUD, Soft-Delete
+* `member`: CRUD, Bulk Create and Update, Soft-Delete
 * `member-groups`: CRUD, Soft-Delete
 * `member/<id>/custom-fields`: CRUD, plus some convenience methods
 * `member/<id>/member-groups`: CRUD, plus some convenience methods

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/__init__.py

@@ -2,7 +2,7 @@
 Middleware for FastAPI that supports authenticating users against Keycloak
 """
 
-__version__ = "2.1.2"
+__version__ = "2.3.0"
 
 # Export EasyVerein API directly
 from .api import EasyvereinAPI  # noqa: F401

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/api.py

@@ -7,6 +7,7 @@ from typing import Callable, cast
 
 from .core.client import EasyvereinClient
 from .core.responses import BearerToken
+from .modules.billing_account import BillingAccountMixin
 from .modules.booking import BookingMixin
 from .modules.contact_details import ContactDetailsMixin
 from .modules.custom_field import CustomFieldMixin
@@ -59,6 +60,7 @@ class EasyvereinAPI:
 
         # Add methods
         self.booking = BookingMixin(self.c, self.logger)
+        self.billing_account = BillingAccountMixin(self.c, self.logger)
         self.contact_details = ContactDetailsMixin(self.c, self.logger)
         self.custom_field = CustomFieldMixin(self.c, self.logger)
         self.invoice = InvoiceMixin(self.c, self.logger)

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/core/client.py

@@ -204,6 +204,38 @@ class EasyvereinClient:
             expected_status_code=status_code,
         )
 
+    def bulk_create(self, url, data: list[BaseModel], status_code: int = 201) -> ResponseSchema:
+        """
+        Method to create multiple objects in the API
+        """
+        return self._handle_response(
+            self._do_request(
+                "post",
+                url,
+                data={"entries": [d.model_dump(exclude_none=True, exclude_unset=True, by_alias=True) for d in data]},
+            ),
+            expected_status_code=status_code,
+        )
+
+    def bulk_update(
+        self, url, data: list[BaseModel], status_code: int = 200, exclude_none: bool = True
+    ) -> ResponseSchema:
+        """
+        Method to update multiple objects in the API
+        """
+        return self._handle_response(
+            self._do_request(
+                "patch",
+                url,
+                data={
+                    "entries": [
+                        d.model_dump(exclude_none=exclude_none, exclude_unset=True, by_alias=True) for d in data
+                    ]
+                },
+            ),
+            expected_status_code=status_code,
+        )
+
     def upload(
         self,
         url: str,

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/core/types.py

@@ -4,7 +4,7 @@ Custom types used for model validation
 
 import datetime
 import json
-from typing import Annotated
+from typing import Annotated, Literal
 
 from pydantic import Field, PlainSerializer, PlainValidator, UrlConstraints
 from pydantic_core import Url
@@ -40,3 +40,5 @@ FilterStrList = Annotated[
     list[str],
     PlainSerializer(lambda x: ",".join(x), return_type=str),
 ]
+
+Sphere = Literal[1, 2, 3, 4, 9]

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/__init__.py

@@ -12,6 +12,12 @@ from .custom_field import (
     CustomFieldFilter,
     CustomFieldUpdate,
 )
+from .custom_field_select_option import (
+    CustomFieldSelectOption,
+    CustomFieldSelectOptionCreate,
+    CustomFieldSelectOptionFilter,
+    CustomFieldSelectOptionUpdate,
+)
 from .invoice import Invoice, InvoiceCreate, InvoiceFilter, InvoiceUpdate
 from .invoice_item import (
     InvoiceItem,
@@ -19,7 +25,7 @@ from .invoice_item import (
     InvoiceItemFilter,
     InvoiceItemUpdate,
 )
-from .member import Member, MemberCreate, MemberFilter, MemberUpdate
+from .member import Member, MemberCreate, MemberFilter, MemberSetDosb, MemberSetLsb, MemberUpdate
 from .member_custom_field import (
     MemberCustomField,
     MemberCustomFieldCreate,
@@ -37,6 +43,7 @@ from .member_member_group import (
 Booking.model_rebuild()
 ContactDetails.model_rebuild()
 CustomField.model_rebuild()
+CustomFieldSelectOption.model_rebuild()
 Invoice.model_rebuild()
 InvoiceItem.model_rebuild()
 Member.model_rebuild()

python_easyverein-2.3.0/easyverein/models/billing_account.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+from pydantic import BaseModel, PositiveInt
+
+from ..core.types import EasyVereinReference, FilterIntList, FilterStrList, PositiveIntWithZero, Sphere
+from .base import EasyVereinBase
+from .mixins.empty_strings_mixin import EmptyStringsToNone
+from .mixins.required_attributes import required_mixin
+
+
+class BillingAccountBase(EasyVereinBase):
+    """
+    | Representative Model Class | Update Model Class | Create Model Class |
+    | --- | --- | --- |
+    | `BillingAccount` | `BillingAccountUpdate` | `BillingAccountCreate` |
+    """
+
+    name: str | None = None
+    excludeInEur: bool | None = None
+    number: PositiveInt | None = None
+    defaultSphere: Sphere | None = None
+
+
+class BillingAccount(BillingAccountBase, EmptyStringsToNone):
+    """
+    Pydantic model representing an BillingAccount
+    """
+
+    skr: str | None = None
+    accountingPlans: list[EasyVereinReference] | None = None
+    numberLength: PositiveIntWithZero
+    linkedBookings: PositiveIntWithZero
+
+
+class BillingAccountCreate(
+    BillingAccountBase,
+    required_mixin(["name", "number"]),  # type: ignore
+):
+    """
+    Pydantic model representing a BillingAccount
+    """
+
+
+class BillingAccountUpdate(BillingAccountBase):
+    """
+    Pydantic model used to patch an BillingAccount
+    """
+
+
+class BillingAccountFilter(BaseModel):
+    """
+    Pydantic model used to filter billing accounts
+    """
+
+    id__in: FilterIntList | None = None
+    name: str | None = None
+    skr: str | None = None
+    skr__in: FilterStrList | None = None
+    number__gte: PositiveInt | None = None
+    number__lte: PositiveInt | None = None
+    deleted: bool | None = None
+    accountingPlan__isnull: bool | None = None
+    showOwnBillingAccounts: bool | None = None
+    ordering: str | None = None
+    search: str | None = None

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/booking.py

@@ -6,7 +6,7 @@ from __future__ import annotations
 
 from pydantic import BaseModel
 
-from ..core.types import DateTime, EasyVereinReference, FilterIntList
+from ..core.types import DateTime, EasyVereinReference, FilterIntList, Sphere
 from .base import EasyVereinBase
 from .mixins.empty_strings_mixin import EmptyStringsToNone
 from .mixins.required_attributes import required_mixin
@@ -22,8 +22,7 @@ class BookingBase(EasyVereinBase):
     amount: float | None = None
     # TODO: Add reference to BankAccount once implemented
     bankAccount: EasyVereinReference | None = None
-    # TODO: Add reference to BillingAccount once implemented
-    billingAccount: EasyVereinReference | None = None
+    billingAccount: BillingAccount | EasyVereinReference | None = None
     description: str | None = None
     date: DateTime | None = None
     receiver: str | None = None
@@ -34,7 +33,7 @@ class BookingBase(EasyVereinBase):
     counterpartBic: str | None = None
     twingleDonation: bool | None = None
     bookingProject: str | None = None
-    sphere: int | None = None
+    sphere: Sphere | None = None
     relatedInvoice: list[EasyVereinReference] | None = None
 
 
@@ -98,3 +97,6 @@ class BookingFilter(BaseModel):
     relatedInvoice__isnull: bool | None = None
     relatedInvoice: int | None = None
     search: str | None = None
+
+
+from .billing_account import BillingAccount  # noqa: E402

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/contact_details.py

@@ -148,7 +148,7 @@ class ContactDetailsFilter(BaseModel):
 
     id__in: FilterIntList | None = None
     country: str | None = None
-    isCompany: bool = Field(default=None, serialization_alias="_isCompany")
+    isCompany: bool | None = Field(default=None, serialization_alias="_isCompany")
     preferredCommunicationWay: str | None = None
     contactDetailsGroups: str | None = None
     contactDetailsGroups__not: str | None = None

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/custom_field.py

@@ -1,20 +1,10 @@
-"""
-Member related models
-"""
-
 from __future__ import annotations
 
 from typing import Literal
 
 from pydantic import BaseModel, Field
 
-from ..core.types import (
-    EasyVereinReference,
-    FilterIntList,
-    HexColor,
-    OptionsField,
-    PositiveIntWithZero,
-)
+from ..core.types import EasyVereinReference, FilterIntList, HexColor, PositiveIntWithZero
 from .base import EasyVereinBase
 from .mixins.empty_strings_mixin import EmptyStringsToNone
 from .mixins.required_attributes import required_mixin
@@ -67,7 +57,7 @@ class CustomFieldBase(EasyVereinBase):
     It is not even possible to set other fields except the ones mentioned before in the portal,
     so not sure what the other values are meant for.
     """
-    selectOptions: OptionsField = None
+    selectOptions: list[CustomFieldSelectOption | EasyVereinReference] | None = None
     description: str | None = Field(default=None, max_length=500)
     member_show: bool | None = None
     member_edit: bool | None = None
@@ -111,6 +101,9 @@ class CustomFieldFilter(BaseModel):
     kind: str | None = None
     member_edit: bool | None = None
     member_show: bool | None = None
-    deletedBy__isnull: bool = Field(default=None, serialization_alias="_deletedBy__isnull")
+    deletedBy__isnull: bool | None = Field(default=None, serialization_alias="_deletedBy__isnull")
     deleted: bool | None = None
     ordering: str | None = None
+
+
+from .custom_field_select_option import CustomFieldSelectOption  # noqa: E402

python_easyverein-2.3.0/easyverein/models/custom_field_select_option.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+from pydantic import BaseModel
+
+from ..core.types import FilterIntList, FilterStrList, PositiveIntWithZero
+from .base import EasyVereinBase
+from .mixins.empty_strings_mixin import EmptyStringsToNone
+from .mixins.required_attributes import required_mixin
+
+
+class CustomFieldSelectOptionBase(EasyVereinBase):
+    """
+    | Representative Model Class | Update Model Class | Create Model Class |
+    | --- | --- | --- |
+    | `CustomFieldSelectOption` | `CustomFieldSelectOptionUpdate` | `CustomFieldSelectOptionCreate` |
+
+    Custom field select options are used to define the possible values for a custom field.
+    Those are only available for select (s) and multiselect (a) custom fields.
+    """
+
+    value: str
+    orderSequence: PositiveIntWithZero | None = None
+    availableForAssignment: bool | None = None
+
+
+class CustomFieldSelectOption(CustomFieldSelectOptionBase, EmptyStringsToNone):
+    """
+    Pydantic model used to represent a custom field select option
+    """
+
+    pass
+
+
+class CustomFieldSelectOptionCreate(CustomFieldSelectOptionBase, required_mixin(["value"])):  # type: ignore
+    """
+    Pydantic model for creating a new custom field select option
+    """
+
+
+class CustomFieldSelectOptionUpdate(CustomFieldSelectOptionBase):
+    """
+    Pydantic model used to update a custom field select option
+    """
+
+    pass
+
+
+class CustomFieldSelectOptionFilter(BaseModel):
+    """
+    Pydantic model used to filter custom field select options
+    """
+
+    id__in: FilterIntList | None = None
+    value: str | None = None
+    value__in: FilterStrList | None = None
+    maxSelections__isnull: bool | None = None
+    maxSelections: PositiveIntWithZero | None = None
+    orderSequence__isnull: bool | None = None
+    orderSequence: PositiveIntWithZero | None = None
+    actuallyRemoved: bool | None = None

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/invoice.py

@@ -55,8 +55,7 @@ class InvoiceBase(EasyVereinBase):
         ]
         | None
     ) = None
-    # TODO: Add reference to BillingAccount once implemented
-    selectionAcc: EasyVereinReference | None = None
+    selectionAcc: BillingAccount | EasyVereinReference | None = None
     refNumber: str | None = None
     paymentDifference: float | None = None
     isDraft: bool | None = None
@@ -148,6 +147,7 @@ class InvoiceFilter(BaseModel):
     search: str | None = None
 
 
+from .billing_account import BillingAccount  # noqa: E402
 from .contact_details import ContactDetails  # noqa: E402
 from .invoice_item import InvoiceItem  # noqa: E402
 from .member import Member  # noqa: E402

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/invoice_item.py

@@ -8,7 +8,7 @@ from typing import Annotated
 
 from pydantic import BaseModel, Field, PositiveInt
 
-from ..core.types import EasyVereinReference, FilterIntList
+from ..core.types import EasyVereinReference, FilterIntList, Sphere
 from .base import EasyVereinBase
 from .mixins.empty_strings_mixin import EmptyStringsToNone
 from .mixins.required_attributes import required_mixin
@@ -35,8 +35,8 @@ class InvoiceItemBase(EasyVereinBase):
     taxRate: float | None = None
     gross: bool | None = None
     taxName: str | None = None
-    # TODO: Add reference to BillingAccount once implemented
-    billingAccount: EasyVereinReference | None = None
+    sphere: Sphere | None = None
+    billingAccount: BillingAccount | EasyVereinReference | None = None
     costCentre: Annotated[str, Field(max_length=8)] | None = None
 
 
@@ -85,4 +85,5 @@ class InvoiceItemFilter(BaseModel):
     search: str | None = None
 
 
+from .billing_account import BillingAccount  # noqa: E402
 from .invoice import Invoice  # noqa: E402

python_easyverein-2.3.0/easyverein/models/lsb_dosb_sport.py

@@ -0,0 +1,12 @@
+from .base import EasyVereinBase
+from .mixins.empty_strings_mixin import EmptyStringsToNone
+
+
+class LsbDosbSport(EasyVereinBase, EmptyStringsToNone):
+    """
+    Pydantic Model for a LSB/DOSB Sport.
+    """
+
+    title: str | None = None
+    sportNumber: str | None = None
+    federationNumber: str | None = None

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/member.py

@@ -63,7 +63,6 @@ class MemberBase(EasyVereinBase):
     paymentIntervallMonths: PositiveInt | Literal[-1] = 1
     useBalanceForMembershipFee: bool | None = None
     bulletinBoardNewPostNotification: bool | None = None
-    integrationDosbGender: Literal["m", "w", "d"] | None = None
     isApplication: bool | None = Field(default=None, alias="_isApplication")
     """
     Alias for `_isApplication` field. See [Pydantic Models](../usage.md#pydantic-models) for details.
@@ -83,8 +82,10 @@ class MemberBase(EasyVereinBase):
     Alias for `_editableByRelatedMembers` field. See [Pydantic Models](../usage.md#pydantic-models) for details.
     """
     sepaMandateFile: AnyHttpURL | str | None = None
-    # TODO: exact type is not specified in API docs
-    integrationDosbSport: list | None = None
+    integrationLsbSport: list[EasyVereinReference] | list[LsbDosbSport] | None = None
+    integrationLsbGender: Literal["m", "w", "d"] | None = None
+    integrationDosbSport: list[EasyVereinReference] | list[LsbDosbSport] | None = None
+    integrationDosbGender: Literal["m", "w", "d"] | None = None
     customFields: list[EasyVereinReference] | list[MemberCustomField] | None = None
     memberGroups: list[EasyVereinReference] | list[MemberMemberGroup] | None = None
 
@@ -135,9 +136,9 @@ class MemberFilter(BaseModel):
     contactDetails__country: str | None = None
     membershipNumber: str | None = None
     membershipNumber__in: FilterStrList | None = None
-    deletedBy: int = Field(default=None, serialization_alias="_deletedBy")
-    deletedBy__ne: int = Field(default=None, serialization_alias="_deletedBy__ne")
-    deletedBy__isnull: bool = Field(default=None, serialization_alias="_deletedBy__isnull")
+    deletedBy: int | None = Field(default=None, serialization_alias="_deletedBy")
+    deletedBy__ne: int | None = Field(default=None, serialization_alias="_deletedBy__ne")
+    deletedBy__isnull: bool | None = Field(default=None, serialization_alias="_deletedBy__isnull")
     joinDate: DateTime | None = None
     joinDate__gte: DateTime | None = None
     joinDate__lte: DateTime | None = None
@@ -146,18 +147,22 @@ class MemberFilter(BaseModel):
     resignationDate__gte: DateTime | None = None
     resignationDate__lte: DateTime | None = None
     resignationDate__isnull: bool | None = None
-    isApplication: bool = Field(default=None, serialization_alias="_isApplication")
-    applicationDate: Date = Field(default=None, serialization_alias="_applicationDate")
-    applicationDate__gte: Date = Field(default=None, serialization_alias="_applicationDate__gte")
-    applicationDate__lte: Date = Field(default=None, serialization_alias="_applicationDate__lte")
-    applicationDate__isnull: bool = Field(default=None, serialization_alias="_applicationDate__isnull")
-    applicationWasAcceptedAt: Date = Field(default=None, serialization_alias="_applicationWasAcceptedAt")
-    applicationWasAcceptedAt__gte: Date = Field(default=None, serialization_alias="_applicationWasAcceptedAt__gte")
-    applicationWasAcceptedAt__lte: Date = Field(default=None, serialization_alias="_applicationWasAcceptedAt__lte")
-    applicationWasAcceptedAt__isnull: bool = Field(
+    isApplication: bool | None = Field(default=None, serialization_alias="_isApplication")
+    applicationDate: Date | None = Field(default=None, serialization_alias="_applicationDate")
+    applicationDate__gte: Date | None = Field(default=None, serialization_alias="_applicationDate__gte")
+    applicationDate__lte: Date | None = Field(default=None, serialization_alias="_applicationDate__lte")
+    applicationDate__isnull: bool | None = Field(default=None, serialization_alias="_applicationDate__isnull")
+    applicationWasAcceptedAt: Date | None = Field(default=None, serialization_alias="_applicationWasAcceptedAt")
+    applicationWasAcceptedAt__gte: Date | None = Field(
+        default=None, serialization_alias="_applicationWasAcceptedAt__gte"
+    )
+    applicationWasAcceptedAt__lte: Date | None = Field(
+        default=None, serialization_alias="_applicationWasAcceptedAt__lte"
+    )
+    applicationWasAcceptedAt__isnull: bool | None = Field(
         default=None, serialization_alias="_applicationWasAcceptedAt__isnull"
     )
-    isChairman: bool = Field(default=None, serialization_alias="_isChairman")
+    isChairman: bool | None = Field(default=None, serialization_alias="_isChairman")
     memberGroups: FilterIntList | None = None
     """
     Filter for members that are member of the given group(s)
@@ -185,6 +190,28 @@ class MemberFilter(BaseModel):
     search: str | None = None
 
 
+class MemberSetLsb(BaseModel):
+    """
+    Pydantic model used to set LSB sports for a member
+
+    Does not match the documentation, but works (with v2.0 in january 2026 at least)
+    """
+
+    lsbSport: list[str]
+
+
+class MemberSetDosb(BaseModel):
+    """
+    Pydantic model used to set DOSB sports for a member
+
+    Does not match the documentation, but works (with v2.0 in january 2026 at least)
+    And for some reason, has another format than the set-lsb endpoint
+    """
+
+    dosb_sport: list[str]
+
+
 from .contact_details import ContactDetails  # noqa: E402
+from .lsb_dosb_sport import LsbDosbSport  # noqa: E402
 from .member_custom_field import MemberCustomField  # noqa: E402
 from .member_member_group import MemberMemberGroup  # noqa: E402

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/member_custom_field.py

@@ -32,6 +32,7 @@ class MemberCustomFieldBase(EasyVereinBase):
     customField: EasyVereinReference | CustomField | None = None
     value: str | None = None
     requestedValue: str | None = None  # Purpose of this field is not documented
+    selectedOptions: list[CustomFieldSelectOption | EasyVereinReference] | None = None
 
 
 class MemberCustomField(MemberCustomFieldBase, EmptyStringsToNone):
@@ -42,7 +43,7 @@ class MemberCustomField(MemberCustomFieldBase, EmptyStringsToNone):
     pass
 
 
-class MemberCustomFieldCreate(MemberCustomFieldBase, required_mixin(["customField", "value"])):  # type: ignore
+class MemberCustomFieldCreate(MemberCustomFieldBase, required_mixin(["customField"])):  # type: ignore
     """
     Pydantic model for creating a new member
     """
@@ -76,4 +77,5 @@ class MemberCustomFieldFilter(BaseModel):
 
 
 from .custom_field import CustomField  # noqa: E402
+from .custom_field_select_option import CustomFieldSelectOption  # noqa: E402
 from .member import Member  # noqa: E402

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/models/member_group.py

@@ -13,6 +13,7 @@ from ..core.types import (
     FilterIntList,
     HexColor,
     PositiveIntWithZero,
+    Sphere,
 )
 from .base import EasyVereinBase
 from .mixins.empty_strings_mixin import EmptyStringsToNone
@@ -48,7 +49,7 @@ class MemberGroupBase(EasyVereinBase):
     agePermission: PositiveIntWithZero | None = None
     nextGroup: EasyVereinReference | None = None
     taxRate: float | None = None
-    billingAccount: EasyVereinReference | None = None
+    billingAccount: BillingAccount | EasyVereinReference | None = None
     costCentre: str | None = Field(default=None, max_length=8)
     isOnlyVisibleToAdmins: bool | None = None
     user_shares: Literal["n", "a", "d"] | None = None
@@ -130,6 +131,7 @@ class MemberGroupBase(EasyVereinBase):
     - a: allowed
     - d: forbidden
     """
+    sphere: Sphere | None = None
 
 
 class MemberGroup(MemberGroupBase, EmptyStringsToNone):
@@ -153,3 +155,6 @@ class MemberGroupFilter(BaseModel):
     kind: str | None = None
     deleted: bool | None = None
     ordering: str | None = None
+
+
+from .billing_account import BillingAccount  # noqa: E402

python_easyverein-2.3.0/easyverein/modules/billing_account.py

@@ -0,0 +1,27 @@
+"""
+All methods related to billing accounts
+"""
+
+import logging
+
+from ..core.client import EasyvereinClient
+from ..models.billing_account import (
+    BillingAccount,
+    BillingAccountCreate,
+    BillingAccountFilter,
+    BillingAccountUpdate,
+)
+from .mixins.crud import CRUDMixin
+from .mixins.recycle_bin import RecycleBinMixin
+
+
+class BillingAccountMixin(
+    CRUDMixin[BillingAccount, BillingAccountCreate, BillingAccountUpdate, BillingAccountFilter],
+    RecycleBinMixin[BillingAccount],
+):
+    def __init__(self, client: EasyvereinClient, logger: logging.Logger):
+        super().__init__()
+        self.endpoint_name = "billing-account"
+        self.return_type = BillingAccount
+        self.c = client
+        self.logger = logger

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/modules/booking.py

@@ -11,12 +11,13 @@ from ..models.booking import (
     BookingFilter,
     BookingUpdate,
 )
-from .mixins.crud import CRUDMixin
+from .mixins.crud import BulkUpdateCreateMixin, CRUDMixin
 from .mixins.recycle_bin import RecycleBinMixin
 
 
 class BookingMixin(
     CRUDMixin[Booking, BookingCreate, BookingUpdate, BookingFilter],
+    BulkUpdateCreateMixin[Booking, BookingCreate, BookingUpdate],
     RecycleBinMixin[Booking],
 ):
     def __init__(self, client: EasyvereinClient, logger: logging.Logger):

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/modules/contact_details.py

@@ -7,12 +7,13 @@ import logging
 from ..core.client import EasyvereinClient
 from ..models import ContactDetails, ContactDetailsCreate, ContactDetailsUpdate
 from ..models.contact_details import ContactDetailsFilter
-from .mixins.crud import CRUDMixin
+from .mixins.crud import BulkUpdateCreateMixin, CRUDMixin
 from .mixins.recycle_bin import RecycleBinMixin
 
 
 class ContactDetailsMixin(
     CRUDMixin[ContactDetails, ContactDetailsCreate, ContactDetailsUpdate, ContactDetailsFilter],
+    BulkUpdateCreateMixin[ContactDetails, ContactDetailsCreate, ContactDetailsUpdate],
     RecycleBinMixin[ContactDetails],
 ):
     def __init__(self, client: EasyvereinClient, logger: logging.Logger):

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/modules/custom_field.py

@@ -11,6 +11,7 @@ from ..models.custom_field import (
     CustomFieldFilter,
     CustomFieldUpdate,
 )
+from .custom_field_select_option import CustomFieldSelectOptionMixin
 from .mixins.crud import CRUDMixin
 from .mixins.recycle_bin import RecycleBinMixin
 
@@ -25,3 +26,6 @@ class CustomFieldMixin(
         self.return_type = CustomField
         self.c = client
         self.logger = logger
+
+    def select_option(self, custom_field_id: int) -> CustomFieldSelectOptionMixin:
+        return CustomFieldSelectOptionMixin(self.c, self.logger, custom_field_id)

python_easyverein-2.3.0/easyverein/modules/custom_field_select_option.py

@@ -0,0 +1,31 @@
+import logging
+
+from ..core.client import EasyvereinClient
+from ..models import (
+    CustomField,
+    CustomFieldSelectOption,
+    CustomFieldSelectOptionCreate,
+    CustomFieldSelectOptionFilter,
+    CustomFieldSelectOptionUpdate,
+)
+from .mixins.crud import CRUDMixin
+from .mixins.helper import get_id
+
+
+class CustomFieldSelectOptionMixin(
+    CRUDMixin[
+        CustomFieldSelectOption,
+        CustomFieldSelectOptionCreate,
+        CustomFieldSelectOptionUpdate,
+        CustomFieldSelectOptionFilter,
+    ]
+):
+    def __init__(self, client: EasyvereinClient, logger: logging.Logger, custom_field: CustomField | int):
+        self.return_type = CustomFieldSelectOption
+        self.c = client
+        self.logger = logger
+        self.custom_field_id = get_id(custom_field)
+
+    @property
+    def endpoint_name(self) -> str:
+        return f"custom-field/{self.custom_field_id}/select-options"

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/modules/invoice.py

@@ -11,12 +11,13 @@ from ..core.client import EasyvereinClient
 from ..core.exceptions import EasyvereinAPIException
 from ..models.invoice import Invoice, InvoiceCreate, InvoiceFilter, InvoiceUpdate
 from ..models.invoice_item import InvoiceItemCreate
-from .mixins.crud import CRUDMixin
+from .mixins.crud import BulkUpdateCreateMixin, CRUDMixin
 from .mixins.recycle_bin import RecycleBinMixin
 
 
 class InvoiceMixin(
     CRUDMixin[Invoice, InvoiceCreate, InvoiceUpdate, InvoiceFilter],
+    BulkUpdateCreateMixin[Invoice, InvoiceCreate, InvoiceUpdate],
     RecycleBinMixin[Invoice],
 ):
     def __init__(self, client: EasyvereinClient, logger: logging.Logger):

python_easyverein-2.3.0/easyverein/modules/member.py

@@ -0,0 +1,49 @@
+"""
+All methods related to invoices
+"""
+
+import logging
+
+from easyverein.modules.member_custom_field import MemberCustomFieldMixin
+from easyverein.modules.member_member_group import MemberMemberGroupMixin
+
+from ..core.client import EasyvereinClient
+from ..models import Member, MemberCreate, MemberFilter, MemberSetLsb, MemberUpdate
+from ..models.member import MemberSetDosb
+from .mixins.crud import BulkUpdateCreateMixin, CRUDMixin
+from .mixins.helper import get_id
+from .mixins.recycle_bin import RecycleBinMixin
+
+
+class MemberMixin(
+    CRUDMixin[Member, MemberCreate, MemberUpdate, MemberFilter],
+    BulkUpdateCreateMixin[Member, MemberCreate, MemberUpdate],
+    RecycleBinMixin[Member],
+):
+    def __init__(self, client: EasyvereinClient, logger: logging.Logger):
+        self.endpoint_name = "member"
+        self.c = client
+        self.logger = logger
+        self.return_type = Member
+
+    def custom_field(self, member_id: int) -> MemberCustomFieldMixin:
+        return MemberCustomFieldMixin(self.c, self.logger, member_id)
+
+    def member_group(self, member_id: int) -> MemberMemberGroupMixin:
+        return MemberMemberGroupMixin(self.c, self.logger, member_id)
+
+    def set_lsb(self, target: Member | int, data: MemberSetLsb) -> None:
+        obj_id = get_id(target)
+
+        self.logger.info(f"Setting LSB sports for member {obj_id}")
+
+        url = self.c.get_url(f"/{self.endpoint_name}/{obj_id}/set-lsb")
+        self.c.update(url, data, status_code=204)
+
+    def set_dosb(self, target: Member | int, data: MemberSetDosb) -> None:
+        obj_id = get_id(target)
+
+        self.logger.info(f"Setting DOSB sports for member {obj_id}")
+
+        url = self.c.get_url(f"/{self.endpoint_name}/{obj_id}/set-dosb")
+        self.c.update(url, data, status_code=204)

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/modules/member_custom_field.py

@@ -7,6 +7,7 @@ import logging
 from ..core.client import EasyvereinClient
 from ..models import (
     CustomField,
+    CustomFieldSelectOption,
     Member,
     MemberCustomField,
     MemberCustomFieldCreate,
@@ -30,17 +31,41 @@ class MemberCustomFieldMixin(
     def endpoint_name(self) -> str:
         return f"member/{self.member_id}/custom-fields"
 
-    def ensure_set(self, custom_field_id: int, value: str) -> MemberCustomField:
+    def ensure_set(self, custom_field_id: int, value: str | list[str]) -> MemberCustomField:
         """
         Convenience method to set the custom field value on a member, no matter if it was
         set before already (PATCH) or not.
 
+        For select (s) and multiselect (a) custom fields, you can provide a list of values.
+        Instead of using the value, the method will automatically fetch and select the
+        options from selectOptions that have been introduced in January 2026.
+
         Regarding rate limiting, be aware that this method requires at least two API calls.
 
         Args:
             custom_field_id (int): Custom field ID that should be set or changed
-            value (str): New value the specified custom field should be set to
+            value (str | list[str]): New value the specified custom field should be set to
         """
+        custom_field_query = "{id,settings_type,selectOptions{id,value}}"
+        custom_field = self.c.api_instance.custom_field.get_by_id(custom_field_id, query=custom_field_query)
+        use_selected_options = custom_field.settings_type in ("s", "a")
+
+        if use_selected_options:
+            values_list = [value] if isinstance(value, str) else list(value)
+            value_to_id: dict[str, int] = {}
+            for opt in custom_field.selectOptions or []:
+                if isinstance(opt, CustomFieldSelectOption) and opt.id is not None and opt.value:
+                    value_to_id[opt.value] = opt.id
+            option_ids = [value_to_id[v] for v in values_list if v in value_to_id]
+            missing = [v for v in values_list if v not in value_to_id]
+            if missing:
+                raise ValueError(f"No select option(s) with value(s) {missing!r} for custom field {custom_field_id}")
+            payload_value = None
+            payload_selected_options: list[int] | None = option_ids
+        else:
+            assert isinstance(value, str), "Value must be a string for non-select custom fields"
+            payload_value = value
+            payload_selected_options = None
 
         # Get all custom fields this member has already set, use max limit available
         query = "{id,value,customField{id}}"
@@ -58,10 +83,12 @@ class MemberCustomFieldMixin(
 
         if existing_custom_field:
             # It's already there, we need to patch the existing field
-            patch = MemberCustomFieldUpdate(value=value)
+            patch = MemberCustomFieldUpdate(value=payload_value, selectedOptions=payload_selected_options)
             assert existing_custom_field.id
             return self.update(existing_custom_field.id, patch)
         else:
             # It's not there, we need to create it
-            create = MemberCustomFieldCreate(value=value, customField=custom_field_id)
+            create = MemberCustomFieldCreate(
+                customField=custom_field_id, value=payload_value, selectedOptions=payload_selected_options
+            )
             return self.create(create)

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/easyverein/modules/mixins/crud.py

@@ -194,3 +194,71 @@ class CRUDMixin(Generic[ModelType, CreateModelType, UpdateModelType, FilterType]
             self.logger.info(f"Deleting object of type {self.endpoint_name} with id {obj_id} from wastebasket")
             purge: Callable = getattr(self, "purge")
             purge(obj_id)
+
+
+class BulkUpdateCreateMixin(Generic[ModelType, CreateModelType, UpdateModelType]):
+    """
+    Mixin providing bulk create and update functionality for endpoints that support it.
+    Currently only supported for the following endpoints:
+    - booking
+    - contact-details
+    - member
+    - invoice
+    """
+
+    def bulk_create(self: EVClientProtocol[ModelType], data: list[CreateModelType]) -> list[bool]:
+        """
+        Creates multiple objects in a single API request and returns the created objects.
+
+        **Example**:
+
+        ```py
+        from easyverein import EasyvereinAPI
+
+        ev_client = EasyvereinAPI("your_api_key")
+
+        contact_details = ev_client.contact_details.bulk_create([
+            ContactDetailsCreate(fistName="example1", lastName="Example1", isCompany=False),
+            ContactDetailsCreate(fistName="example2", lastName="Example2", isCompany=False),
+        ])
+        ```
+
+        Args:
+            data: List of Pydantic models containing the data for the objects to be created.
+        """
+        self.logger.info(f"Creating object of type {self.endpoint_name}")
+
+        url = self.c.get_url(f"/{self.endpoint_name}/bulk-create")
+        response = self.c.bulk_create(url, data)
+        return [r["data"]["success"] for r in response.result]  # type: ignore
+
+    def bulk_update(
+        self: EVClientProtocol[ModelType], data: list[UpdateModelType], exclude_none: bool = True
+    ) -> list[bool]:
+        """
+        Updates multiple objects in a single API request and returns the updated objects.
+
+        Note that the update models must include the `id` of the objects to be updated.
+
+        **Example**:
+
+        ```py
+        from easyverein import EasyvereinAPI
+
+        ev_client = EasyvereinAPI("your_api_key")
+
+        updated_members = ev_client.member.bulk_update([
+            MemberUpdate(id=1, membershipNumber="M1"),
+            MemberUpdate(id=2, membershipNumber="M2"),
+        ])
+        ```
+
+        Args:
+            data: List of Pydantic models containing the data to update.
+            exclude_none: If True, fields with None values will be excluded from the update.
+        """
+        self.logger.info(f"Bulk updating objects of type {self.endpoint_name}")
+
+        url = self.c.get_url(f"/{self.endpoint_name}/bulk-update")
+        response = self.c.bulk_update(url, data, exclude_none=exclude_none)
+        return [r["data"]["success"] for r in response.result]  # type: ignore

{python_easyverein-2.1.2 → python_easyverein-2.3.0}/pyproject.toml

@@ -1,26 +1,28 @@
-[tool.poetry]
+[project]
 name = "python-easyverein"
-version = "2.1.2"
+version = "2.3.0"
 description = "Python library to interact with the EasyVerein API"
-authors = ["Daniel Herrmann <daniel.herrmann1@gmail.com>"]
+authors = [{ name = "Daniel Herrmann", email = "daniel.herrmann1@gmail.com" }]
 readme = "README.md"
-packages = [{ include = "easyverein" }]
+requires-python = ">=3.11,<4"
+license = { file = "LICENSE" }
+dependencies = ["pydantic>=2,<3", "requests>=2,<3", "email-validator>=2,<3"]
 
-[tool.poetry.dependencies]
-python = "^3.11"
-pydantic = "^2"
-requests = "^2"
-email-validator = "^2"
+[tool.poetry]
+packages = [{ include = "easyverein" }]
 
 
 [tool.poetry.group.dev.dependencies]
-sphinx = "^9"
+sphinx = [
+    { version = "^9,<9.1", markers = "python_version < '3.12'" },
+    { version = "^9", markers = "python_version >= '3.12'" },
+]
 sphinx-rtd-theme = "^3"
 ruff = "*"
 pytest = "^9"
 pytest-dotenv = "^0"
 mkdocs-material = "^9"
-mkdocstrings = {extras = ["python"], version = "^1"}
+mkdocstrings = { extras = ["python"], version = "^1" }
 pymdown-extensions = "^10.7"
 pre-commit = "^4"
 pytest-cov = "^7"
@@ -60,7 +62,7 @@ ignore = [
     "UP007", # use-pep604-annotation
     "E741",  # Ambiguous variable name
     # "UP035", # deprecated-assertion
-    "PLE1205"  # PLE1205 due to custom logger implementation
+    "PLE1205", # PLE1205 due to custom logger implementation
 ]
 
 [tool.ruff.lint.mccabe]

python_easyverein-2.1.2/easyverein/modules/member.py

@@ -1,27 +0,0 @@
-"""
-All methods related to invoices
-"""
-
-import logging
-
-from easyverein.modules.member_custom_field import MemberCustomFieldMixin
-from easyverein.modules.member_member_group import MemberMemberGroupMixin
-
-from ..core.client import EasyvereinClient
-from ..models import Member, MemberCreate, MemberFilter, MemberUpdate
-from .mixins.crud import CRUDMixin
-from .mixins.recycle_bin import RecycleBinMixin
-
-
-class MemberMixin(CRUDMixin[Member, MemberCreate, MemberUpdate, MemberFilter], RecycleBinMixin[Member]):
-    def __init__(self, client: EasyvereinClient, logger: logging.Logger):
-        self.endpoint_name = "member"
-        self.c = client
-        self.logger = logger
-        self.return_type = Member
-
-    def custom_field(self, member_id: int) -> MemberCustomFieldMixin:
-        return MemberCustomFieldMixin(self.c, self.logger, member_id)
-
-    def member_group(self, member_id: int) -> MemberMemberGroupMixin:
-        return MemberMemberGroupMixin(self.c, self.logger, member_id)