Giter VIP home page Giter VIP logo

Comments (6)

zimmi avatar zimmi commented on August 17, 2024

Please reconsider adding a dependency on a concrete slf4j implementation. In my opinion, libraries better depend only on the api alone (and all the ones I know do so, I can provide examples if you want).

The current approach only works without configuration when the user:

  • has no binding to an implementation (and is fine with the defaults of log4j2)
  • is already using the same version of log4j2, in which case it doesn't help

In all other scenarios it introduces version or binding conflicts and users have to hunt down the reason.

If there is no binding to an implementation, slf4j will print a warning. If users want logging output, they should know what concrete logging system they are using and how to configure it.

from simple-java-mail.

bbottema avatar bbottema commented on August 17, 2024

@zimmi I was thinking of providing documentation to exclude the log4j2 implementation from the maven dependencies so you can switch to another.

The API that is used in the code already is that of SLF4J.

However, if using the basic SLF4J implementation logging requires no further configuration from the user if they want to switch implementation, that would be preferable. I only included some implementation so that the demo and test classes produce output.

from simple-java-mail.

zimmi avatar zimmi commented on August 17, 2024

What do you think about instead providing documentation to add log4j2 as the recommended modern logging implementation?

Adding a link to the slf4j manual for the demo code for users that want logging output might be enough, maybe.

from simple-java-mail.

bbottema avatar bbottema commented on August 17, 2024

I added it as an optional dependency using the maven <scope>optional</scope>. This way it is included during development, but won't be used by depending projects.

from simple-java-mail.

bbottema avatar bbottema commented on August 17, 2024

I also moved the log4j config file to the test resources folder now so that won't be packaged either (see #45).

from simple-java-mail.

zimmi avatar zimmi commented on August 17, 2024

I agree with that decision. :)
From a user standpoint, I just want to send mail. The fewer dependencies and assumptions a library makes, the better. Opinions are for frameworks.
Thanks again for your work!

from simple-java-mail.

Related Issues (20)

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.