Add ability to sync from a git repository

fixes: #4708
Generated by: claude-opus-4.6-thinking

Author: gerrod3

CHANGES/pulp_file/4708.feature

@@ -0,0 +1 @@
+Added ability to sync a git repository with the new FileGitRemote.

pulp_file/app/migrations/0019_add_filegitremote.py

@@ -0,0 +1,28 @@
+# Generated by Django 5.2.10 on 2026-02-05 19:22
+
+import django.db.models.deletion
+import pulpcore.app.models.access_policy
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('core', '0145_domainize_import_export'),
+        ('file', '0018_alter_filecontent_options'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='FileGitRemote',
+            fields=[
+                ('remote_ptr', models.OneToOneField(auto_created=True, on_delete=django.db.models.deletion.CASCADE, parent_link=True, primary_key=True, serialize=False, to='core.remote')),
+                ('git_ref', models.TextField(default='HEAD')),
+            ],
+            options={
+                'permissions': [('manage_roles_filegitremote', 'Can manage roles on file git remotes')],
+                'default_related_name': '%(app_label)s_%(model_name)s',
+            },
+            bases=('core.remote', pulpcore.app.models.access_policy.AutoAddObjPermsMixin),
+        ),
+    ]

pulp_file/app/models.py

@@ -62,14 +62,33 @@ class Meta:
         ]
 
 
+class FileGitRemote(Remote, AutoAddObjPermsMixin):
+    """
+    Remote for syncing files from a Git repository (without PULP_MANIFEST).
+
+    The URL should point to a Git repository. The ``git_ref`` field can be used to specify a
+    branch, tag, or commit to sync from (defaults to ``HEAD``).
+    """
+
+    TYPE = "git"
+
+    git_ref = models.TextField(default="HEAD")
+
+    class Meta:
+        default_related_name = "%(app_label)s_%(model_name)s"
+        permissions = [
+            ("manage_roles_filegitremote", "Can manage roles on file git remotes"),
+        ]
+
+
 class FileRepository(Repository, AutoAddObjPermsMixin):
     """
     The "file" repository type.
     """
 
     TYPE = "file"
     CONTENT_TYPES = [FileContent]
-    REMOTE_TYPES = [FileRemote]
+    REMOTE_TYPES = [FileRemote, FileGitRemote]
 
     manifest = models.TextField(default="PULP_MANIFEST", null=True)
     autopublish = models.BooleanField(default=False)

pulp_file/app/serializers.py

@@ -24,6 +24,7 @@
     FileAlternateContentSource,
     FileContent,
     FileDistribution,
+    FileGitRemote,
     FileRemote,
     FileRepository,
     FilePublication,
@@ -160,6 +161,26 @@ class Meta:
         model = FileRemote
 
 
+class FileGitRemoteSerializer(RemoteSerializer):
+    """
+    Serializer for File Git Remotes.
+    """
+
+    git_ref = serializers.CharField(
+        help_text=_(
+            "The git ref (branch, tag, or commit hash) to sync from. Defaults to HEAD."
+        ),
+        default="HEAD",
+        required=False,
+    )
+
+    policy = serializers.HiddenField(default=models.Remote.IMMEDIATE)
+
+    class Meta:
+        fields = RemoteSerializer.Meta.fields + ("git_ref",)
+        model = FileGitRemote
+
+
 class FilePublicationSerializer(PublicationSerializer):
     """
     Serializer for File Publications.