Feat automodule

[machow]

This PR addresses #158, by autogenerating site content, when no sections: are specified.

For example, this config...

quartodoc:
  package: quartodoc

Will cause quartodoc build to produce a basic website, based on the top-level quartodoc module, with this message:

Autogenerating contents (since no contents specified in config)
Use the following configuration to recreate the automatically generated site:


package: quartodoc
sections:
- contents:
  - name: get_function
  - name: get_object
  - name: Builder
  - name: MdRenderer
  - name: convert_inventory
  - name: create_inventory
  - name: preview
  - name: blueprint
  - name: collect
  - name: Auto
  desc: quartodoc is a package for building delightful python API documentation.
  title: quartodoc

edit:

It also addresses #197, by implementing class documentation inside modules.

[juliasilge]

This is looking great! It might be good to note that this configuration goes into your _quarto.yml, like maybe something like:

Use the following configuration in your _quarto.yml to recreate the automatically generated site:

[machow]

Wow, added snapshots tests with syrupy, and it behaves a lot like testthat snapshots! For example, snapshots for a test file are all contained in a single .ambr file (which seems to be a custom format, and somewhat like testthat)

https://github.com/machow/quartodoc/blob/d4b9456caad0d87047c30e8aa2ba724fea134f69/quartodoc/tests/__snapshots__/test_renderers.ambr

Would be cool to contribute a serializer to markdown, so we can use some of the github markdown affordances