Skip to content

Commit

Permalink
docs: format section on building Bestand objecten as tip
Browse files Browse the repository at this point in the history
  • Loading branch information
rien333 authored Dec 13, 2024
1 parent 82826c3 commit 5c66c64
Showing 1 changed file with 22 additions and 22 deletions.
44 changes: 22 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Naast gebruiksvriendelijkheid, streeft `mdto.py` ook een 100% correcte implement
> [!TIP]
> `mdto.py` kan ook PRONOM-informatie genereren via `sf` ([siegfried](https://github.com/richardlehane/siegfried)). `sf` is sneller en meer up-to-date dan `fido`, maar op dit moment lastiger te installeren. Als `sf` geïnstalleerd is, gebruikt `mdto.py` dit programma automatisch voor PRONOM-informatie.
>
> Als beide programma's aanwezig zijn, kun je je voorkeur aangeven door de _environment variable_ `PRONOM_BACKEND` aan te passen naar `sf`/`fido`.
> Als beide programma's aanwezig zijn, kun je je voorkeur aangeven door de environment variable `PRONOM_BACKEND` aan te passen naar `sf`/`fido`.
## Systeem-brede installatie

Expand Down Expand Up @@ -139,27 +139,27 @@ Informatieobject(naam='Verlenen kapvergunning Hooigracht 21 Den Haag', identifi
'VERLENEN KAPVERGUNNING HOOIGRACHT 21 DEN HAAG'
```

Je kan op een vergelijkbare manier Bestand objecten bouwen via de `Bestand()` class. Het is vaak echter simpeler om hiervoor de _convience_ functie `bestand_from_file()` te gebruiken, omdat deze veel gegevens, zoals PRONOM informatie en checksums, automatisch voor je aanmaakt:


```python
import mdto
from mdto.gegevensgroepen import *

# verwijzing naar bijbehorend informatieobject
obj_verwijzing = VerwijzingGegevens("Verlenen kapvergunning Hooigracht")

bestand = mdto.bestand_from_file(
file="vergunning.pdf", # bestand waarvoor technische metagegevens moeten worden aangemaakt
identificatie=Identificatiegegevens("34c5-4379-9f1a-5c378", "Proza (DMS)"),
isrepresentatievan=obj_verwijzing
)

# Sla op als XML bestand
bestand.save("vergunning.bestand.mdto.xml")
```

Het resulterende XML bestand bevat vervolgens de correcte `<omvang>`, `<bestandsformaat>`, `<checksum>` , en `<isRepresentatieVan>` tags. `<URLBestand>` tags kunnen ook worden aangemaakt worden via de optionele `url=` parameter van `bestand_from_file()`. URLs worden automatisch gevalideerd via de [validators python library](https://pypi.org/project/validators/).
> [!TIP]
> Je kan op een vergelijkbare manier Bestand objecten bouwen via de `Bestand()` class. Het is vaak echter simpeler om hiervoor de _convience_ functie `bestand_from_file()` te gebruiken, omdat deze veel gegevens, zoals PRONOM informatie en checksums, automatisch voor je aanmaakt:
>
> ```python
> import mdto
> from mdto.gegevensgroepen import *
>
> # verwijzing naar bijbehorend informatieobject
> obj_verwijzing = VerwijzingGegevens("Verlenen kapvergunning Hooigracht")
>
> bestand = mdto.bestand_from_file(
> file="vergunning.pdf", # bestand waarvoor technische metagegevens moeten worden aangemaakt
> identificatie=Identificatiegegevens("34c5-4379-9f1a-5c378", "Proza (DMS)"),
> isrepresentatievan=obj_verwijzing
> )
>
> # Sla op als XML bestand
> bestand.save("vergunning.bestand.mdto.xml")
> ```
>
> Het resulterende XML bestand bevat vervolgens de correcte `<omvang>`, `<bestandsformaat>`, `<checksum>` , en `<isRepresentatieVan>` tags. `<URLBestand>` tags kunnen ook worden aangemaakt worden via de optionele `url=` parameter van `bestand_from_file()`.
## XML bestanden inlezen
Expand Down

0 comments on commit 5c66c64

Please sign in to comment.