File: gitg-ext-application.vala

package info (click to toggle)
gitg 41-2
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 18,876 kB
  • sloc: ansic: 1,636; ruby: 1,445; sh: 314; python: 261; xml: 57; makefile: 15
file content (106 lines) | stat: -rw-r--r-- 3,119 bytes parent folder | download | duplicates (5)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
/*
 * This file is part of gitg
 *
 * Copyright (C) 2012 - Jesse van den Kieboom
 *
 * gitg is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * gitg is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with gitg. If not, see <http://www.gnu.org/licenses/>.
 */

namespace GitgExt
{

/**
 * Application is an interface to access the main gitg application.
 *
 * The application interface is provided to plugins to access the main gitg
 * application instance. It contains properties to access the currently open
 * repository as well as methods to open or create repositories.
 *
 */
public interface Application : Object
{
	/**
	 * The currently open repository.
	 */
	public abstract Gitg.Repository? repository { owned get; set; }

	public signal void repository_changed_externally(ExternalChangeHint hint);
	public signal void repository_commits_changed();

	/**
	 * An application wide message bus over which plugins can communicate.
	 */
	public abstract GitgExt.MessageBus message_bus { owned get; }

	/**
	 * The current application main activity.
	 */
	public abstract GitgExt.Activity? current_activity { owned get; }

	/**
	 * The environment with which the application was opened.
	 */
	public abstract Gee.Map<string, string> environment { owned get; }

	/**
	 * Get the committer signature and verify that both its name and
	 * e-mail are set. If not, the application will show an approppriate
	 * error message and return null.
	 */
	public abstract Ggit.Signature? get_verified_committer();

	/**
	 * Get the notifications manager for the application.
	 */
	public abstract Notifications notifications { owned get; }

	/**
	 * Set the current application main activity.
	 *
	 * @param id the id of the activity {@link UIElement.id}.
	 *
	 * @return the created new main activity, or ``null`` if no activity with the
	 *         given id exists.
	 */
	public abstract GitgExt.Activity? get_activity_by_id(string id);
	public abstract GitgExt.Activity? set_activity_by_id(string id);

	public abstract void user_query(UserQuery query);
	public abstract async Gtk.ResponseType user_query_async(UserQuery query);

	public abstract void show_infobar(string          primary_msg,
	                                  string          secondary_msg,
	                                  Gtk.MessageType type);

	public abstract bool busy { get; set; }

	public abstract Application open_new(Ggit.Repository repository, string? hint = null);

	public abstract RemoteLookup remote_lookup { owned get; }

	public abstract void open_repository(File path);
}

[Flags]
public enum ExternalChangeHint
{
	NONE = 0,

	REFS  = 1 << 0,
	INDEX = 1 << 1
}

}

// ex:set ts=4 noet: