twistofreality / dilmun

     * Existing values for the specified header will be maintained. The new

     * value(s) will be appended to the existing list.

     */

    function it_returns_a_new_request_with_a_header_added_with_a_single_value()

    {

        $header = "foo";

        $value = "qux";

        $request = $this->withAddedHeader($header, $value);

        $request->getHeaderLine($header)->shouldBe("bar,baz,qux");

    }

    /**

     * While header names are case-insensitive, the casing of the header will

     * While header names are case-insensitive, the casing of the header will

     * be preserved by this function, and returned from getHeaders().

     */

    function it_returns_a_new_request_with_a_header_added_in_a_case_insensitive_way()

    {

        $header = "FOO";

        $value = "qux";

        $request = $this->withAddedHeader($header, $value);

        $request->getHeaderLine("foo")->shouldBe("bar,baz,qux");

    }

    /**

     * Existing values for the specified header will be maintained. The new

     * immutability of the message, and MUST return an instance that has the

     * new and/or updated header and value.

     */

    function it_retains_its_original_header_when_adding_a_header()

    {

        $header = "foo";

        $value = "qux";

        $request = $this->withAddedHeader($header, $value);

        $request->getHeaderLine($header)->shouldReturn("bar,baz,qux");

        $this->getHeaderLine($header)->shouldReturn("bar,baz");

    }

    /**

     * Throws \InvalidArgumentException for invalid header names or values.