v3.6.0

🚀 New Features

• Comments! 💬

  • A new Comment object is now used to store comments for submissions and journals
  • The comments are organised in a tree structure, and each one contains references to both its parent object (Submission or Journal) and, if the comment is a reply, to its parent comment too
  • The auxiliary functions faapi.comment.flatten_comments and faapi.comment.sort_comments allow to flatten the comment tree or reorganise it

• Separate JournalPartial and Journal objects

  • The new JournalPartial class takes the place of the previous Journal class, and it is now used only to parse journal from a user's journals folder
  • The new Journal class contains the same fields as JournalPartial with the addition of comments, and it is only used to parse journal pages

• Comparisons

  • All objects can now be used with the comparison (==) operator with other objects of the same type or the type of their key property (id: int for submissions and journals, and name_url: str for users)

⚙️ Changes

• The cookies argument of FAAPI is now mandatory, and an Unauthorized exception is raised if FAAPI is initialised with an empty cookies list
• The list of Submission/Journal objects returned by FAAPI.gallery, FAAPI.scraps, and FAAPI.journals now uses a shared UserPartial object in the author variable (i.e. changing a property of the author in one object of the list will change it for the others as well)

🔧 Fixes

• Fix path checking against robots.txt not working correctly with paths missing a leading forward slash

🔗 Links

• PyPi release: https://pypi.org/project/FAAPI/3.6.0
• Full changelog: v3.5.0...v3.6.0

v3.5.0

🚀 New Features

• New Submission.stats field for submission statistics stored in a named tuple (views, comments (count) , favorites)
  • Pull request #2, thanks to @warpKaiba!
• New Journal.stats field for journal statistics stored in a named tuple (comments (count))

⚙️ Changes

• Rename UserStats.favs to UserStats.favorites

🔧 Fixes

• Fix links in PyPi metadata pointing to previous hosting at GitLab

🔗 Links

• PyPi release: https://pypi.org/project/FAAPI/3.5.0
• Full changelog: v3.4.3...v3.5.0

v3.4.3

⚙️ Changes

• Better and more resilient robots.txt parsing

🔧 Fixes

• Fix spaces around slash (/) not being preserved for submission categories

🔗 Links

• PyPi release: https://pypi.org/project/faapi/v3.4.3
• Full changelog: v3.4.2...v3.4.3

v3.4.2

⚙️ Changes

• Raise DisabledAccount for users pending deletion
• Error messages from server are not lowercased

🔗 Links

• PyPi release: https://pypi.org/project/faapi/v3.4.2
• Full changelog: v3.4.1...v3.4.2

v3.4.1

🔧 Fixes

• Fix rare occurrence of error message not being parsed if inside a section.notice-message

🔗 Links

• PyPi release: https://pypi.org/project/faapi/v3.4.1
• Full changelog: v3.4.0...v3.4.1

v3.4.0 (was 3.3.8)

🚀 New Features

• New NotFound exception inheriting from ParsingError

⚙️ Changes

• Removed FAAPI.submission_exists, FAAPI.journal_exists, and FAAPI.user_exists methods
• Improved reliability of error pages' parser

🔧 Fixes

• Custom exceptions inherit from Exception instead of BaseException

🔗 Links

• PyPi release: https://pypi.org/project/faapi/v3.4.0
• Full changelog: v3.3.8...v3.4.0

v3.3.8 [YANKED]

🚀 New Features

• New NotFound exception inheriting from ParsingError

⚙️ Changes

• Removed FAAPI.submission_exists, FAAPI.journal_exists, and FAAPI.user_exists methods
• Improved reliability of error pages' parser

🔧 Fixes

• Custom exceptions inherit from Exception instead of BaseException

🔗 Links

• PyPi release: https://pypi.org/project/faapi/v3.3.8 [yanked]
• Full changelog: v3.3.7...v3.3.8

v3.3.7

⚙️ Changes

• No changes to code; migrated repository to GitHub and updated README and PyPi metadata

🔗 Links

• PyPi release: https://pypi.org/project/faapi/v3.3.7
• Full changelog: v3.3.6...v3.3.7

v3.3.6

⚙️ Changes

• Allow empty info/contacts when parsing user profiles

🔗 Links

• PyPi release: https://pypi.org/project/faapi/v3.3.6
• Full changelog: v3.3.5...v3.3.6

v3.3.5

⚙️ Changes

• Fix last page check when parsing galleries

🔗 Links

• PyPi release: https://pypi.org/project/faapi/v3.3.5
• Full changelog: v3.3.4...v3.3.5