release v4.0

README.md

@@ -290,9 +290,14 @@ On the open source side, there are many related projects. [php-mf2-shim](https:/
 
 Changelog
 ---
-### 3.3 - unreleased
+### 4.0 - 2022-03-23
+
+_Breaking changes:_
 
 * Drop Python 3.5 support. Python 3.6 is now the minimum required version.
+
+_Non-breaking changes:_
+
 * RSS:
   * Add support for RSS input via new `rss.to_activities` function.
 * Add new `include_shares` kwarg to `get_activities`, implemented for Twitter and Mastodon. Defaults to `True`. If `False`, shares (retweets in Twitter, boosts in Mastodon) will be discarded and not returned. Also add a corresponding `shares` query param to the REST API.

docs/conf.py

@@ -87,9 +87,9 @@
 # built documents.
 #
 # The short X.Y version.
-version = '3.2'
+version = '4.0'
 # The full version, including alpha/beta/rc tags.
-release = '3.2'
+release = '4.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

docs/index.rst

@@ -459,11 +459,20 @@ Facebook and Twitter’s raw HTML.
 Changelog
 ---------
 
-3.3 - unreleased
+4.0 - 2022-03-24
 ~~~~~~~~~~~~~~~~
 
+*Breaking changes:*
+
 -  Drop Python 3.5 support. Python 3.6 is now the minimum required
    version.
+
+*Non-breaking changes:*
+
+-  RSS:
+
+   -  Add support for RSS input via new ``rss.to_activities`` function.
+
 -  Add new ``include_shares`` kwarg to ``get_activities``, implemented
    for Twitter and Mastodon. Defaults to ``True``. If ``False``, shares
    (retweets in Twitter, boosts in Mastodon) will be discarded and not
@@ -484,6 +493,18 @@ Changelog
    -  Implement ``get_activities()`` to fetch posts by the current user
       or a user specified with ``user_id``.
 
+-  Facebook scraping:
+
+   -  Skip “Suggested for you” posts.
+   -  Add ``log_html`` kwarg to ``get_activities``; defaults to False.
+   -  Miscellaneous bug fixes.
+
+-  JSONFeed:
+
+   -  Handle malformed ``items.author`` element.
+
+.. _section-1:
+
 3.2 - 2021-09-15
 ~~~~~~~~~~~~~~~~
 
@@ -540,7 +561,7 @@ Changelog
 -  REST API: ported web framework from webapp2 to Flask. No user-visible
    behavior change expected.
 
-.. _section-1:
+.. _section-2:
 
 3.1 - 2021-04-03
 ~~~~~~~~~~~~~~~~
@@ -645,7 +666,7 @@ Changelog
    -  ``from_as1()``: convert ``username`` to ``preferredUsername``.
    -  ``from_as1()``: bug fix, make ``context`` kwarg actually work.
 
-.. _section-2:
+.. _section-3:
 
 3.0 - 2020-04-08
 ~~~~~~~~~~~~~~~~
@@ -724,7 +745,7 @@ Non-breaking changes:
    caching now.
 -  Added Meetup.com support for publishing RSVPs.
 
-.. _section-3:
+.. _section-4:
 
 2.2 - 2019-11-02
 ~~~~~~~~~~~~~~~~
@@ -773,7 +794,7 @@ Non-breaking changes:
       supports one enclosure per item, so we now only include the first,
       and log a warning if the activity has more.)
 
-.. _section-4:
+.. _section-5:
 
 2.1 - 2019-09-04
 ~~~~~~~~~~~~~~~~
@@ -823,7 +844,7 @@ Non-breaking changes:
 
    -  Default title to ellipsized content.
 
-.. _section-5:
+.. _section-6:
 
 2.0 - 2019-03-01
 ~~~~~~~~~~~~~~~~
@@ -832,7 +853,7 @@ Non-breaking changes:
 March <https://developers.google.com/+/api-shutdown>`__. Notably, this
 removes the ``googleplus`` module.
 
-.. _section-6:
+.. _section-7:
 
 1.15 - 2019-02-28
 ~~~~~~~~~~~~~~~~~
@@ -883,7 +904,7 @@ removes the ``googleplus`` module.
 -  ``/url``: Return HTTP 400 when fetching the user’s URL results in an
    infinite redirect.
 
-.. _section-7:
+.. _section-8:
 
 1.14 - 2018-11-12
 ~~~~~~~~~~~~~~~~~
@@ -910,7 +931,7 @@ Encode ``&``\ s in author URL and email address too. (Thanks
 `sebsued <https://twitter.com/sebsued>`__!) \* AS2: \* Add ``Follow``
 support.
 
-.. _section-8:
+.. _section-9:
 
 1.13 - 2018-08-08
 ~~~~~~~~~~~~~~~~~
@@ -971,7 +992,7 @@ support.
    -  Support ``alt`` attribute in ``<img>`` tags
       (`snarfed/bridgy#756 <https://github.com/snarfed/bridgy/issues/756>`__).
 
-.. _section-9:
+.. _section-10:
 
 1.12 - 2018-03-24
 ~~~~~~~~~~~~~~~~~
@@ -1006,7 +1027,7 @@ impact of the Python 3 migration. It *should* be a noop for existing
 Python 2 users, and we’ve tested thoroughly, but I’m sure there are
 still bugs. Please file issues if you notice anything broken!
 
-.. _section-10:
+.. _section-11:
 
 1.11 - 2018-03-09
 ~~~~~~~~~~~~~~~~~
@@ -1079,7 +1100,7 @@ still bugs. Please file issues if you notice anything broken!
    -  Omit title from items if it’s the same as the content. (Often
       caused by microformats2’s implied ``p-name`` logic.)
 
-.. _section-11:
+.. _section-12:
 
 1.10 - 2017-12-10
 ~~~~~~~~~~~~~~~~~
@@ -1121,7 +1142,7 @@ still bugs. Please file issues if you notice anything broken!
    -  Fix bug that omitted title in some cases
       (`#122 <https://github.com/snarfed/granary/issues/122>`__).
 
-.. _section-12:
+.. _section-13:
 
 1.9 - 2017-10-24
 ~~~~~~~~~~~~~~~~
@@ -1149,7 +1170,7 @@ still bugs. Please file issues if you notice anything broken!
       ``json``, ``json-mf2``, and ``xml`` are still accepted, but
       deprecated.
 
-.. _section-13:
+.. _section-14:
 
 1.8 - 2017-08-29
 ~~~~~~~~~~~~~~~~
@@ -1229,7 +1250,7 @@ still bugs. Please file issues if you notice anything broken!
    `bug <https://github.com/kylewm/brevity/issues/5>`__
    `fixes <https://github.com/kylewm/brevity/issues/6>`__.
 
-.. _section-14:
+.. _section-15:
 
 1.7 - 2017-02-27
 ~~~~~~~~~~~~~~~~
@@ -1277,7 +1298,7 @@ still bugs. Please file issues if you notice anything broken!
    on “narrow” builds of Python 2 with ``--enable-unicode=ucs2``, which
    is the default on Mac OS X, Windows, and older \*nix.
 
-.. _section-15:
+.. _section-16:
 
 1.6 - 2016-11-26
 ~~~~~~~~~~~~~~~~
@@ -1311,7 +1332,7 @@ still bugs. Please file issues if you notice anything broken!
 -  Error handling: return HTTP 502 for non-JSON API responses, 504 for
    connection failures.
 
-.. _section-16:
+.. _section-17:
 
 1.5 - 2016-08-25
 ~~~~~~~~~~~~~~~~
@@ -1349,14 +1370,14 @@ still bugs. Please file issues if you notice anything broken!
    -  Switch creating comments and reactions from GraphQL to REST API
       (`bridgy#824 <https://github.com/snarfed/bridgy/issues/824>`__.
 
-.. _section-17:
+.. _section-18:
 
 1.4.1 - 2016-06-27
 ~~~~~~~~~~~~~~~~~~
 
 -  Bump oauth-dropins requirement to 1.4.
 
-.. _section-18:
+.. _section-19:
 
 1.4.0 - 2016-06-27
 ~~~~~~~~~~~~~~~~~~
@@ -1390,15 +1411,15 @@ still bugs. Please file issues if you notice anything broken!
 -  Upgrade to requests 2.10.0 and requests-toolbelt 0.60, which support
    App Engine.
 
-.. _section-19:
+.. _section-20:
 
 1.3.1 - 2016-04-07
 ~~~~~~~~~~~~~~~~~~
 
 -  Update `oauth-dropins <https://github.com/snarfed/oauth-dropins>`__
    dependency to >=1.3.
 
-.. _section-20:
+.. _section-21:
 
 1.3.0 - 2016-04-06
 ~~~~~~~~~~~~~~~~~~
@@ -1441,7 +1462,7 @@ still bugs. Please file issues if you notice anything broken!
 -  Misc bug fixes.
 -  Set up Coveralls.
 
-.. _section-21:
+.. _section-22:
 
 1.2.0 - 2016-01-11
 ~~~~~~~~~~~~~~~~~~
@@ -1497,7 +1518,7 @@ still bugs. Please file issues if you notice anything broken!
 -  Misc bug fixes.
 -  Set up CircleCI.
 
-.. _section-22:
+.. _section-23:
 
 1.1.0 - 2015-09-06
 ~~~~~~~~~~~~~~~~~~
@@ -1520,15 +1541,15 @@ still bugs. Please file issues if you notice anything broken!
 -  Improve original post discovery algorithm.
 -  New logo.
 
-.. _section-23:
+.. _section-24:
 
 1.0.1 - 2015-07-11
 ~~~~~~~~~~~~~~~~~~
 
 -  Bug fix for atom template rendering.
 -  Facebook, Instagram: support access_token parameter.
 
-.. _section-24:
+.. _section-25:
 
 1.0 - 2015-07-10
 ~~~~~~~~~~~~~~~~

setup.py

@@ -11,7 +11,7 @@
 
 
 setup(name='granary',
-      version='3.2',
+      version='4.0',
       description='The social web translator',
       long_description=open('README.md').read(),
       long_description_content_type='text/markdown',
@@ -45,7 +45,7 @@
           'humanfriendly>=4.18',
           'jinja2>=2.10',
           'mf2util>=0.5.0',
-          'oauth-dropins>=4.0',
+          'oauth-dropins>=5.0',
           'praw>=7.3.0',
           'python-dateutil>=2.8',
           'requests>=2.22',