php-http / message

HTTP Message related tools
http://php-http.org
MIT License
1.3k stars 42 forks source link

Inconsistent naming #4

Closed sagikazarmark closed 8 years ago

sagikazarmark commented 8 years ago

I started to work on the message package and already moved some stuff to it.

I found an inconsistency issue:

We have message factory interfaces in the message-factory package. This is a contract package, and I think it would be better to have it that way. The namespace is Http\Message.

The message factory implementations are moved here from the utils package. The namespace is Http\Message as well, so factories are in Http\Message*Factory namespaces. Eg. Http\Message\MessageFactory\GuzzleMessageFactory.

We also have decorators. Originally they were in the Http\Message namespace as well, but I moved them in this package one level down to Http\Message\Decorator.

So we have an inconsistency here: Http\Message\MessageFactory, but Http\Message\Decorator\RequestDecorator.

The extra thing is that the message factory package is already tagged as 1.0, which does not allow us to change it's namespace without major version change.

So, should we just leave the situation as is, or should we move Decorators back to the Http\Message namespace for consistency?

dbu commented 8 years ago

i don't feel this naming is very bad. its all about Http\Message and we have the two sub-packages MessageFactory and Decorator. seems fine to me.

sagikazarmark commented 8 years ago

Actually it is more than two: MessageFactory, StreamFactory and UriFactory.

(And Decorator)

But you might be right, it's no big deal.

dbu commented 8 years ago

right. but that still feels ok to me.

sagikazarmark commented 8 years ago

Ok, thanks for the feedback.