v2 roadmap

[renanbr]

General:

• Require PHP ^7.1 (2b69a51, 0bc19cf, f95f7e6) moved to support for PHP 5 #41
  • More readable code, less comments to explain intentions
  • 7.1 will be the oldest version with active support in one month
• Exceptions refactoring Replace ParseException with Exception (48c7048, facdf1f)
  • To be used for general purpose, not only for "parser" stuff
  • Create a namespace Exception, and put all needed exceptions inside it
  • Make exceptions implement a base ExceptionInterface
• Make Listener able to manage "entry processors" instead of "tag processors" (aed4c2e)
  • It'll make possible to inject tags, or to process multiple at the same time
• No longer use variable reference in processors (aed4c2e)
  • Processor must return the modified entry
  • The code will be more readable
  • There is no real need to use references in this case
• Translate v1 tag processors into entry processors (5f3efda, 22e8f1c)
  • To keep current features working as well
• Move "citation key" and "tag name case" processing from Listener to specialized entry processors (e05182d, 40a9709)
  • Listener becomes simpler
  • Listener becomes more extensible

Coming entry processors:

• DateProcessor implement DateProcessor #28
  • Appends _date tag with a DateTime instance
• DoiToUrlProcessor implement UrlFromDoiProcessor #37
  • Fills url tag if this one is missing using DOI
• TrimProcessor implement TrimProcessor #36
  • Strips whitespace from the beginning and end of all tags' values

Internals:

• Normalize "tag" term (ef89c9c and 703408d)
  • It will be always be referenced as "tag" (not as "tag" or "key")
  • Introduce "tag name" and "tag content" terms
• Review dev files setup (2b69a51, b74f28d, 7eeb848, 0bc19cf, ec0bd38, b4afc78, 2bbe936, 11871a7, d005198, bfb0089, f02af76)
  • .editorconfig, .php_cs, .travis.yml, composer.json, phpunit.xml ...

Thoughts:

• Handle entries as objects instead of arrays

[renanbr]

Done!

https://github.com/renanbr/bibtex-parser/releases/tag/2.0.0