[libgit2-glib] Add ggit_remote_new.

[Ignacio Casal Quinteiro <icq src gnome org>]

commit d8c2e935acfc9cafc40110e931d4287fc03bab0d
Author: Ignacio Casal Quinteiro <icq gnome org>
Date:   Sun Nov 4 16:29:01 2012 +0100

    Add ggit_remote_new.

 libgit2-glib/ggit-remote.c |   49 ++++++++++++++++++++++++++++++++++++++++---
 libgit2-glib/ggit-remote.h |    6 +++++
 2 files changed, 51 insertions(+), 4 deletions(-)
---
diff --git a/libgit2-glib/ggit-remote.c b/libgit2-glib/ggit-remote.c
index 1c5fa71..e8b4e45 100644
--- a/libgit2-glib/ggit-remote.c
+++ b/libgit2-glib/ggit-remote.c
@@ -24,6 +24,7 @@
 #include "ggit-error.h"
 #include "ggit-oid.h"
 #include "ggit-ref-spec.h"
+#include "ggit-repository.h"
 
 
 struct _GgitRemote
@@ -47,6 +48,46 @@ _ggit_remote_wrap (const git_remote *remote)
 }
 
 /**
+ * ggit_remote_new:
+ * @repository: a #GgitRepository.
+ * @name: the remote's name.
+ * @url: the remote repository's URL.
+ * @fetch_spec: the fetch refspec to use for this remote.
+ * @error: a #GError for error reporting, or %NULL.
+ *
+ * Creates a remote with the default refspecs in memory. You can use
+ * this when you have a URL instead of a remote's name.
+ *
+ * Returns: (transfer full): a newly allocated #GgitRemote.
+ */
+GgitRemote *
+ggit_remote_new (GgitRepository   *repository,
+                 const gchar      *name,
+                 const gchar      *url,
+                 const gchar      *fetch_spec,
+                 GError          **error)
+{
+	gint ret;
+	git_remote *remote;
+
+	g_return_val_if_fail (GGIT_IS_REPOSITORY (repository), NULL);
+	g_return_val_if_fail (name != NULL, NULL);
+	g_return_val_if_fail (url != NULL, NULL);
+	g_return_val_if_fail (fetch_spec != NULL, NULL);
+
+	ret = git_remote_new (&remote, _ggit_native_get (repository),
+	                      name, url, fetch_spec);
+
+	if (ret != GIT_OK)
+	{
+		_ggit_error_set (error, ret);
+		return NULL;
+	}
+
+	return _ggit_remote_wrap (remote);
+}
+
+/**
  * ggit_remote_ref:
  * @remote: a #GgitRemote.
  *
@@ -144,7 +185,7 @@ ggit_remote_get_url (GgitRemote *remote)
  * ggit_remote_connect:
  * @remote: a #GgitRemote.
  * @direction: whether you want to receive or send data.
- * @error: a #GError or %NULL.
+ * @error: a #GError for error reporting, or %NULL.
  *
  * Opens a connection to a remote.
  * The transport is selected based on the URL. The direction argument
@@ -204,7 +245,7 @@ ggit_remote_disconnect (GgitRemote *remote)
  * ggit_remote_set_fetch_spec:
  * @remote: a #GgitRemote.
  * @fetch_spec: the fetch refspec.
- * @error: a #GError or %NULL.
+ * @error: a #GError for error reporting, or %NULL.
  *
  * Sets @remote's fetch spec to @fetch_spec.
  */
@@ -256,7 +297,7 @@ ggit_remote_get_fetch_spec (GgitRemote *remote)
  * ggit_remote_set_push_spec:
  * @remote: a #GgitRemote.
  * @push_spec: the push refspec.
- * @error: a #GError or %NULL.
+ * @error: a #GError for error reporting, or %NULL.
  *
  * Sets @remote's push spec to @fetch_spec.
  */
@@ -335,7 +376,7 @@ remote_list_callback_wrapper (git_remote_head *head,
  * @remote: a #GgitRemote.
  * @callback: (scope call) (closure user_data): a #GgitRemoteListCallback.
  * @user_data: callback user data.
- * @error: a #GError or %NULL.
+ * @error: a #GError for error reporting, or %NULL.
  *
  * Calls @callback for each ref at @remote.
  */
diff --git a/libgit2-glib/ggit-remote.h b/libgit2-glib/ggit-remote.h
index 6006107..69cd547 100644
--- a/libgit2-glib/ggit-remote.h
+++ b/libgit2-glib/ggit-remote.h
@@ -35,6 +35,12 @@ GType              ggit_remote_get_type                 (void) G_GNUC_CONST;
 
 GgitRemote       *_ggit_remote_wrap                     (const git_remote *remote);
 
+GgitRemote        *ggit_remote_new                      (GgitRepository   *repository,
+                                                         const gchar      *name,
+                                                         const gchar      *url,
+                                                         const gchar      *fetch_spec,
+                                                         GError          **error);
+
 GgitRemote        *ggit_remote_ref                      (GgitRemote       *remote);
 void               ggit_remote_unref                    (GgitRemote       *remote);