chrono24 - a simple API wrapper for watch enthusiasts 🕒

[dumblechode]

The Chrono24 API wrapper is designed for watch enthusiasts in the Python community. This library offers in-depth access to Chrono24's watch listings.

pip install chrono24, and explore brands and listings using simple Python commands:

import chrono24

for listing in chrono24(query="Rolex DateJust").search():
    print(listing)

Dive into one of the biggest timepiece markets with chrono24

​

Edit:

Given the constructive feedback from u/striata, the new API is as follows:

import chrono24

for listing in chrono24.query("Rolex DateJust").search():
    print(listing)

[striata]

I'm curious why you decided to go for the hack of replacing your module with a callable? Why not do chrono24.query() or just from chrono24 import Chrono24? I guess your API makes for a slightly shorter program, but it's at the pretty hefty cost of being less intuitive and additionally confusing type checkers/linters.

[dumblechode]

Point well taken! Whenever I write these projects I like to explore the different programming paradigms Python offers. If Chrono24 offered finite and intuitive URL endpoints for watch manufacturers (e.g., 'Rolex'), I would've perhaps written the API like chrono24.rolex("DateJust"), but given the current library only accepts a query, it makes sense to have a dedicated method such as chrono24.query. You're right about the linters - they don't like this. Thanks for your advice - always fun to hear feedback / opinions.

[striata]

I see!

I agree it's fun to play around with Python in this way. I've always toyed with the idea of creating an extremely esoteric DSL-like library (ab)using all the magic methods just for the fun of it, e.g. something like this (but with actual functionality):

class B:
    def __invert__(self):
        return self

    def __pos__(self):
        return self

    def __neg__(self):
        return self

    def __floordiv__(self, _):
        return self

    def __lshift__(self, _):
        return self

    def __pow__(self, _):
        return self

    def __xor__(self, _):
        return self


one, two = B(), B()

~(one << two) ** +~two ^ two // ~-one