first public version

Author: hatemosphere

.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -11,3 +11,4 @@ build/
 .ruff_cache/
 .pytest_cache/
 .DS_Store
+reference/

CATEGORIES.md

@@ -0,0 +1,253 @@
+# Tweakers Pricewatch Categories
+
+All categories available for browsing via `client.browse_category()`.
+
+This file is auto-generated by `python scripts/update_categories.py`.
+
+| Slug | ID | Name |
+|---|---|---|
+| `3d-printers` | 945 | 3D-printers |
+| `aanvullende-componenten` | 837 | Aanvullende componenten |
+| `accesspoints` | 314 | Accesspoints |
+| `actioncams` | 947 | Actioncams |
+| `afstandsbedieningen` | 565 | Afstandsbedieningen |
+| `afzuigkappen` | 1060 | Afzuigkappen |
+| `aircos` | 1092 | Airco's |
+| `airfryers` | 1030 | Airfryers |
+| `alarmsystemen` | 942 | Alarmsystemen |
+| `audiosets` | 654 | Audiosets |
+| `autoradios` | 680 | Autoradio's |
+| `av-accessoires` | 657 | Av-accessoires |
+| `babyfoons` | 1068 | Babyfoons |
+| `backup-drives-en-removable-storage` | 65 | Backup drives en removable storage |
+| `barbecues` | 1168 | Barbecues |
+| `barebones` | 326 | Barebones |
+| `basiscomponenten` | 14 | Basiscomponenten |
+| `basisstations` | 934 | Basisstations |
+| `beamers` | 216 | Beamers |
+| `bediening` | 937 | Bediening |
+| `behuizingen` | 61 | Behuizingen |
+| `benchmarks` | 238 | Benchmarks |
+| `besturingssystemen` | 404 | Besturingssystemen |
+| `beugels-en-standaarden` | 803 | Beugels en standaarden |
+| `beveiliging-en-antivirus` | 409 | Beveiliging en antivirus |
+| `bewakingscameras` | 943 | Bewakingscamera's |
+| `bladblazers` | 1034 | Bladblazers |
+| `blenders` | 824 | Blenders |
+| `bloeddrukmeters` | 1058 | Bloeddrukmeters |
+| `blu-ray-dvd-en-cd` | 781 | Blu-ray, dvd en cd |
+| `boormachines` | 971 | Boormachines |
+| `broodbakmachines` | 1070 | Broodbakmachines |
+| `broodroosters` | 1048 | Broodroosters |
+| `browsers` | 840 | Browsers |
+| `business-software` | 718 | Business software |
+| `camera-accessoires` | 290 | Camera-accessoires |
+| `cameralenzen` | 925 | Cameralenzen |
+| `cameratassen` | 953 | Cameratassen |
+| `capturecards` | 66 | Capturecards |
+| `case-fans` | 492 | Case fans |
+| `casemodding` | 483 | Casemodding |
+| `cirkelzagen` | 973 | Cirkelzagen |
+| `citruspersen` | 1078 | Citruspersen |
+| `compactcameras` | 436 | Compactcamera's |
+| `computer-accessoires` | 455 | Computer-accessoires |
+| `consoles` | 539 | Consoles |
+| `dashcams` | 998 | Dashcams |
+| `database-management` | 720 | Database management |
+| `dataprocessing-en-transmission` | 721 | Dataprocessing en transmission |
+| `decoders` | 651 | Decoders |
+| `decoupeerzagen` | 995 | Decoupeerzagen |
+| `design-en-graphics` | 719 | Design en graphics |
+| `design-en-multimedia` | 406 | Design en multimedia |
+| `desktop-applications` | 722 | Desktop applications |
+| `desktop-publishing` | 723 | Desktop publishing |
+| `deurbellen` | 1022 | Deurbellen |
+| `deursloten` | 1024 | Deursloten |
+| `development-tools` | 848 | Development tools |
+| `digitale-fotolijsten` | 708 | Digitale fotolijsten |
+| `dockingstations` | 495 | Dockingstations |
+| `drone-accessoires` | 961 | Drone-accessoires |
+| `drones` | 959 | Drones |
+| `e-readers` | 804 | E-readers |
+| `elektrisch-gereedschap-accessoires` | 1000 | Elektrisch gereedschap accessoires |
+| `elektrische-dekens` | 1098 | Elektrische dekens |
+| `elektrische-grasmaaiers` | 983 | Elektrische grasmaaiers |
+| `elektrische-heggenscharen` | 981 | Elektrische heggenscharen |
+| `elektrische-kachels` | 1074 | Elektrische kachels |
+| `externe-harde-schijven` | 334 | Externe harde schijven |
+| `externe-ssds` | 948 | Externe ssd's |
+| `fan-controllers-en-lcds` | 490 | Fan-controllers en lcd's |
+| `filters` | 677 | Filters |
+| `flitsers` | 610 | Flitsers |
+| `gadgets` | 798 | Gadgets |
+| `game-accessoires` | 542 | Game-accessoires |
+| `gamecontrollers` | 541 | Gamecontrollers |
+| `games` | 638 | Games |
+| `games-en-strategy-guides` | 724 | Games en strategy guides |
+| `gaming-headsets` | 563 | Gaming headsets |
+| `garantie-en-servicepacks` | 762 | Garantie en servicepacks |
+| `geheugen-intern` | 545 | Geheugen intern |
+| `geheugenkaarten` | 48 | Geheugenkaarten |
+| `geheugenkaartlezers` | 681 | Geheugenkaartlezers |
+| `geluidskaarten` | 53 | Geluidskaarten |
+| `gourmetstellen` | 1084 | Gourmetstellen |
+| `haakse-slijpers` | 985 | Haakse slijpers |
+| `hardware-boeken` | 725 | Hardware boeken |
+| `hardware-modding` | 828 | Hardware modding |
+| `hdd-ssd-behuizingen` | 949 | Hdd/ssd behuizingen |
+| `hogedrukreinigers` | 979 | Hogedrukreinigers |
+| `hoofdtelefoons` | 1020 | Hoofdtelefoons |
+| `huishouden` | 916 | Huishouden |
+| `ict-boeken` | 691 | Ict-boeken |
+| `information` | 726 | Information |
+| `instant-cameras` | 1038 | Instant camera's |
+| `interactive-en-multimedia` | 728 | Interactive en multimedia |
+| `interfaces` | 938 | Interfaces |
+| `interne-harde-schijven` | 50 | Interne harde schijven |
+| `interne-ssds` | 674 | Interne ssd's |
+| `internet-boeken` | 727 | Internet boeken |
+| `kabels` | 72 | Kabels |
+| `keukenapparatuur` | 915 | Keukenapparatuur |
+| `keukenmachines` | 908 | Keukenmachines |
+| `klimaatbeheersing` | 1094 | Klimaatbeheersing |
+| `koelkasten` | 903 | Koelkasten |
+| `koffiezetapparaten` | 817 | Koffiezetapparaten |
+| `kvm-switches` | 567 | Kvm-switches |
+| `laptops` | 496 | Laptops |
+| `laptoptassen` | 672 | Laptoptassen |
+| `luchtbevochtigers` | 1036 | Luchtbevochtigers |
+| `luchtontvochtigers` | 1028 | Luchtontvochtigers |
+| `luchtreinigers` | 1032 | Luchtreinigers |
+| `magnetrons` | 901 | Magnetrons |
+| `massageapparaten` | 1062 | Massageapparaten |
+| `mediaspelers` | 655 | Mediaspelers |
+| `melkopschuimers` | 1040 | Melkopschuimers |
+| `memorecorders` | 763 | Memorecorders |
+| `microfoons` | 1002 | Microfoons |
+| `mobiele-abonnementen` | 760 | Mobiele abonnementen |
+| `mobiele-besturingssystemen` | 869 | Mobiele besturingssystemen |
+| `modems-en-routers` | 560 | Modems en routers |
+| `moederborden` | 47 | Moederborden |
+| `monitors` | 344 | Monitors |
+| `mp3-accessoires` | 608 | Mp3-accessoires |
+| `mp3-spelers` | 605 | Mp3-spelers |
+| `muismatten` | 534 | Muismatten |
+| `muizen` | 531 | Muizen |
+| `multitools` | 977 | Multitools |
+| `nas` | 685 | Nas |
+| `navigatie` | 478 | Navigatie |
+| `netwerk` | 838 | Netwerk |
+| `netwerk-en-systeembeheer` | 825 | Netwerk en systeembeheer |
+| `netwerk-switches` | 311 | Netwerk switches |
+| `netwerkaccessoires` | 561 | Netwerkaccessoires |
+| `netwerkadapters` | 310 | Netwerkadapters |
+| `netwerkkabels` | 1026 | Netwerkkabels |
+| `networking-en-security` | 729 | Networking en security |
+| `officesoftware-en-suites` | 405 | Officesoftware en suites |
+| `oordopjes` | 453 | Oordopjes |
+| `operating-systems` | 730 | Operating systems |
+| `opladers` | 1010 | Opladers |
+| `opslag` | 839 | Opslag |
+| `optische-drives` | 634 | Optische drives |
+| `ovens` | 1072 | Ovens |
+| `overclocking` | 843 | Overclocking |
+| `overige-audio` | 887 | Overige audio |
+| `overige-av-accessoires` | 879 | Overige av-accessoires |
+| `overige-boeken` | 733 | Overige boeken |
+| `overige-componenten` | 881 | Overige componenten |
+| `overige-keukenapparatuur` | 1086 | Overige keukenapparatuur |
+| `overige-randapparatuur` | 775 | Overige randapparatuur |
+| `overige-software` | 237 | Overige software |
+| `overige-zaagmachines` | 993 | Overige zaagmachines |
+| `pcs` | 713 | Pc's |
+| `persoonlijke-verzorging` | 927 | Persoonlijke verzorging |
+| `pizza-ovens` | 1064 | Pizza ovens |
+| `platenspelers` | 1046 | Platenspelers |
+| `power-stations` | 1050 | Power stations |
+| `powerbanks` | 997 | Powerbanks |
+| `powerline` | 791 | Powerline |
+| `prepaid-telefoons` | 816 | Prepaid telefoons |
+| `printer-cartridges` | 391 | Printer cartridges |
+| `printeraccessoires` | 323 | Printeraccessoires |
+| `printers` | 922 | Printers |
+| `printers-en-scanners` | 57 | Printers en scanners |
+| `processorkoeling` | 488 | Processorkoeling |
+| `processors` | 46 | Processors |
+| `programming` | 731 | Programming |
+| `randapparatuur` | 774 | Randapparatuur |
+| `reference` | 732 | Reference |
+| `rewritable-media` | 69 | (Re)Writable media |
+| `rijstkokers` | 1066 | Rijstkokers |
+| `robotstofzuigers` | 1018 | Robotstofzuigers |
+| `sapcentrifuges` | 1080 | Sapcentrifuges |
+| `scanners` | 58 | Scanners |
+| `schakelaars` | 936 | Schakelaars |
+| `scheerapparaten` | 792 | Scheerapparaten |
+| `schuurmachines` | 975 | Schuurmachines |
+| `sensors` | 935 | Sensors |
+| `servers` | 714 | Servers |
+| `serversoftware` | 841 | Serversoftware |
+| `singleboardcomputers` | 1004 | Singleboardcomputers |
+| `slowcookers` | 1044 | Slowcookers |
+| `smarthome-accessoires` | 944 | Smarthome-accessoires |
+| `smartphone-accessoires` | 377 | Smartphone-accessoires |
+| `smartphonehoesjes` | 957 | Smartphonehoesjes |
+| `smartphones` | 215 | Smartphones |
+| `smartwatches` | 930 | Smartwatches |
+| `software` | 211 | Software |
+| `software-boeken` | 735 | Software boeken |
+| `software-development` | 829 | Software development |
+| `software-en-netwerken` | 920 | Software en netwerken |
+| `soundbars` | 1008 | Soundbars |
+| `speakers` | 786 | Speakers |
+| `specialisaties` | 771 | Specialisaties |
+| `spiegelreflexcameras` | 288 | Spiegelreflexcamera's |
+| `statieven` | 951 | Statieven |
+| `stofzuigers` | 907 | Stofzuigers |
+| `stoomreinigers` | 1056 | Stoomreinigers |
+| `strijkijzers` | 928 | Strijkijzers |
+| `systeem-en-netwerkutilitys` | 410 | Systeem- en netwerkutility's |
+| `systeemcameras` | 931 | Systeemcamera's |
+| `tablet-accessoires` | 923 | Tablet-accessoires |
+| `tablets` | 822 | Tablets |
+| `tablets-en-e-readers` | 913 | Tablets en e-readers |
+| `tandenborstels` | 929 | Tandenborstels |
+| `tapijtreinigers` | 1076 | Tapijtreinigers |
+| `tekentablets` | 533 | Tekentablets |
+| `telefoonabonnementen` | 919 | Telefoonabonnementen |
+| `telefoons` | 921 | Telefoons |
+| `televisies` | 621 | Televisies |
+| `terrasverwarmers` | 1088 | Terrasverwarmers |
+| `thermometers` | 1054 | Thermometers |
+| `thermostaten` | 939 | Thermostaten |
+| `toetsenborden` | 530 | Toetsenborden |
+| `tosti-ijzers` | 1052 | Tosti-ijzers |
+| `upgradesets` | 568 | Upgradesets |
+| `ups-en-stekkerdozen` | 773 | Ups en stekkerdozen |
+| `usb-audio-en-video-hubs` | 307 | USB, audio en video-hubs |
+| `usb-opslag-controllers` | 60 | USB/Opslag-controllers |
+| `usb-sticks` | 306 | USB-sticks |
+| `vaatwassers` | 900 | Vaatwassers |
+| `vaste-telefonie` | 878 | Vaste telefonie |
+| `ventilators` | 1016 | Ventilators |
+| `verbruiksmeters` | 940 | Verbruiksmeters |
+| `verlichting` | 941 | Verlichting |
+| `versterkers-en-receivers` | 656 | Versterkers en receivers |
+| `videocameras` | 318 | Videocamera's |
+| `videokaarten` | 49 | Videokaarten |
+| `virtualisatie` | 864 | Virtualisatie |
+| `voedingen` | 664 | Voedingen |
+| `vr-brillen` | 955 | VR-brillen |
+| `vriezers` | 904 | Vriezers |
+| `wafelijzers` | 1082 | Wafelijzers |
+| `wasdrogers` | 899 | Wasdrogers |
+| `wasmachines` | 898 | Wasmachines |
+| `waterkoeling` | 491 | Waterkoeling |
+| `waterkoeling-accessoires` | 1006 | Waterkoeling accessoires |
+| `waterkokers` | 965 | Waterkokers |
+| `wearable-accessoires` | 1014 | Wearable-accessoires |
+| `webcams` | 289 | Webcams |
+| `weegschalen` | 1042 | Weegschalen |
+| `witgoed` | 914 | Witgoed |
+
+**243 categories total.**

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 hatemosphere
+
+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.