use default host/port when serving

[cs01]

Make CLI API more friendly such that it defaults to using localhost:8000 if no host/port is specified.

[kernc]

When only colon is provided (--http :), the defaults are used.

There's no way to make the parameter to --http optional. I.e. how can Python (argparse) know "foo" is not a host/port specification?

pdoc --http foo bar

[cs01]

The cli would have to either add commands such as pdoc build PACKAGE, pdoc serve PACKAGE or change the meaning of --http to be action=store_true and add another optional parameter --url.

Personally I like pdoc build and pdoc serve.

[kernc]

But you certainly don't like --http : that you only really type out once? 🙂

[cs01]

I am sure I am getting a little annoying by now 😄 but it's only because I really like pdoc!

A default should be something one doesn't have to type. Otherwise it's not really a default, even if it is only one character. For that matter why not type the whole url out just once?

Separating into different commands makes sense because the build/serve operations are completely different, and would work nicely if something else is ever added such as pdoc publish.