# test_mailmap.py -- Tests for dulwich.mailmap # Copyright (C) 2018 Jelmer Vernooij # # SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later # Dulwich is dual-licensed under the Apache License, Version 2.0 and the GNU # General Public License as published by the Free Software Foundation; version 2.0 # or (at your option) any later version. You can redistribute it and/or # modify it under the terms of either of these two licenses. # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. # # You should have received a copy of the licenses; if not, see # for a copy of the GNU General Public License # and for a copy of the Apache # License, Version 2.0. # """Tests for dulwich.mailmap.""" from io import BytesIO from unittest import TestCase from dulwich.mailmap import Mailmap, read_mailmap class ReadMailmapTests(TestCase): def test_read(self) -> None: b = BytesIO( b"""\ Jane Doe Joe R. Developer # A comment # Comment Some Dude nick1 Other Author nick2 Other Author Santa Claus """ ) self.assertEqual( [ ((b"Jane Doe", b"jane@desktop.(none)"), None), ((b"Joe R. Developer", b"joe@example.com"), None), ((None, b"cto@company.xx"), (None, b"cto@coompany.xx")), ( (b"Some Dude", b"some@dude.xx"), (b"nick1", b"bugs@company.xx"), ), ( (b"Other Author", b"other@author.xx"), (b"nick2", b"bugs@company.xx"), ), ( (b"Other Author", b"other@author.xx"), (None, b"nick2@company.xx"), ), ( (b"Santa Claus", b"santa.claus@northpole.xx"), (None, b"me@company.xx"), ), ], list(read_mailmap(b)), ) class MailmapTests(TestCase): def test_lookup(self) -> None: m = Mailmap() m.add_entry((b"Jane Doe", b"jane@desktop.(none)"), (None, None)) m.add_entry((b"Joe R. Developer", b"joe@example.com"), None) m.add_entry((None, b"cto@company.xx"), (None, b"cto@coompany.xx")) m.add_entry((b"Some Dude", b"some@dude.xx"), (b"nick1", b"bugs@company.xx")) m.add_entry( (b"Other Author", b"other@author.xx"), (b"nick2", b"bugs@company.xx"), ) m.add_entry((b"Other Author", b"other@author.xx"), (None, b"nick2@company.xx")) m.add_entry( (b"Santa Claus", b"santa.claus@northpole.xx"), (None, b"me@company.xx"), ) self.assertEqual( b"Jane Doe ", m.lookup(b"Jane Doe "), ) self.assertEqual( b"Jane Doe ", m.lookup(b"Jane Doe "), ) self.assertEqual( b"Jane Doe ", m.lookup(b"Jane D. "), ) self.assertEqual( b"Some Dude ", m.lookup(b"nick1 ") ) self.assertEqual(b"CTO ", m.lookup(b"CTO ")) def test_lookup_with_identity_tuple(self) -> None: """Test lookup using an identity tuple instead of a string.""" m = Mailmap() m.add_entry( (b"Real Name", b"real@example.com"), (b"Alias", b"alias@example.com") ) # Test lookup with a tuple self.assertEqual( (b"Real Name", b"real@example.com"), m.lookup((b"Alias", b"alias@example.com")), ) # Test lookup with another tuple that doesn't match anything self.assertEqual( (b"Unknown", b"unknown@example.com"), m.lookup((b"Unknown", b"unknown@example.com")), ) def test_lookup_with_no_match(self) -> None: """Test lookup when no match is found.""" m = Mailmap() m.add_entry( (b"Real Name", b"real@example.com"), (b"Alias", b"alias@example.com") ) # No match should return the original identity original = b"Unknown " self.assertEqual(original, m.lookup(original)) def test_lookup_partial_matches(self) -> None: """Test lookup with partial matches (name or email only).""" m = Mailmap() # Add entry with only name m.add_entry((b"Real Name", None), (b"Any Name", None)) # Add entry with only email m.add_entry((None, b"real@example.com"), (None, b"other@example.com")) # Match by name self.assertEqual( b"Real Name ", m.lookup(b"Any Name ") ) # Match by email self.assertEqual( b"Any Name ", m.lookup(b"Any Name ") ) def test_add_entry_name_or_email_only(self) -> None: """Test adding entries with only name or only email.""" m = Mailmap() # Entry with only canonical name m.add_entry((b"Real Name", None), (b"Alias", b"alias@example.com")) # Entry with only canonical email m.add_entry((None, b"real@example.com"), (b"Other", b"other@example.com")) # Lookup should properly combine the identity parts self.assertEqual( b"Real Name ", m.lookup(b"Alias ") ) self.assertEqual( b"Other ", m.lookup(b"Other ") ) def test_init_with_iterator(self) -> None: """Test initializing Mailmap with an iterator of entries.""" entries = [ ((b"Real Name", b"real@example.com"), (b"Alias", b"alias@example.com")), ((b"Another", b"another@example.com"), None), ] m = Mailmap(iter(entries)) # Verify the entries were added self.assertEqual( b"Real Name ", m.lookup(b"Alias ") ) self.assertEqual( b"Another ", m.lookup(b"Another "), ) def test_lookup_with_none_name(self) -> None: """Test lookup when canonical name is None (only email is canonical).""" m = Mailmap() # Add entry with canonical email but no canonical name m.add_entry((None, b"real@example.com"), (b"Alias", b"alias@example.com")) # When canonical name is None, use original name result = m.lookup(b"Alias ") self.assertEqual(b"Alias ", result) # Test formatting when name becomes empty m2 = Mailmap() m2.add_entry((None, b"real@example.com"), (None, b"alias@example.com")) result2 = m2.lookup(b" ") # When both names are None/empty, result has empty name self.assertEqual(b" ", result2) def test_lookup_with_none_email(self) -> None: """Test lookup when canonical email is None (only name is canonical).""" m = Mailmap() # Add entry with canonical name but no canonical email m.add_entry((b"Real Name", None), (b"Alias", b"alias@example.com")) # When canonical email is None, use original email result = m.lookup(b"Alias ") self.assertEqual(b"Real Name ", result) # Test formatting when email becomes empty m2 = Mailmap() m2.add_entry((b"Real Name", None), (b"Alias", None)) result2 = m2.lookup(b"Alias <>") # When both emails are None/empty, result has empty email self.assertEqual(b"Real Name <>", result2) def test_from_path(self) -> None: """Test creating Mailmap from a file path.""" import os import tempfile # Create a temporary mailmap file with tempfile.NamedTemporaryFile( mode="wb", delete=False, suffix=".mailmap" ) as f: f.write(b"Real Name \n") f.write(b"Another Person \n") mailmap_path = f.name try: # Load from path m = Mailmap.from_path(mailmap_path) # Verify entries were loaded self.assertEqual( b"Real Name ", m.lookup(b"Alias ") ) finally: os.unlink(mailmap_path)