Merge pull request #30 from bdowning/update

Docstrings, various other updates

Author: bdowning

.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.4.0-alpha-12
+current_version = 0.4.0-alpha-13
 parse = (?P<major>\d+)\.(?P<minor>\d+)\.(?P<patch>\d+)(-(?P<release>.*)-(?P<build>\d+))?
 serialize = 
 	{major}.{minor}.{patch}-{release}-{build}

README.md

@@ -4,6 +4,9 @@ Python tool for slicing and dicing SQL.  Its intended target is
 Postgres with _asyncpg_, though it also includes support for rendering
 to a SQLAlchemy `TextClause`.
 
+_Note that current docstrings are autogenerated and have not been
+carefully reviewed; take them with a grain of salt!_
+
 ## Base query builder
 
 ### Example
@@ -319,9 +322,9 @@ Requires SQLAlchemy to be installed, otherwise raises `ImportError`.
 from dataclasses import dataclass, field
 from datetime import date
 from uuid import UUID, uuid4
-from typing import Optional
+from typing import Annotated, Optional
 
-from sql_athame import ModelBase, model_field_metadata as MD, sql
+from sql_athame import ModelBase, ColumnInfo, sql
 
 
 @dataclass
@@ -330,7 +333,7 @@ class Person(ModelBase, table_name="people", primary_key="id"):
     name: str
     birthday: date
     title: Optional[str] = None
-    extra: Optional[dict] = field(default=None, metadata=MD(type="JSONB"))
+    extra: Optional[Annotated[dict, ColumnInfo(type="JSONB")]] = None
 
 
 >>> list(Person.create_table_sql())

pyproject.toml

@@ -8,7 +8,7 @@ dependencies = [
     "typing-extensions",
 ]
 name = "sql-athame"
-version = "0.4.0-alpha-12"
+version = "0.4.0-alpha-13"
 description = "Python tool for slicing and dicing SQL"
 readme = "README.md"