annotate README @ 19:7eb698246bec

README: first draft
author Goffi <goffi@goffi.org>
date Tue, 28 Sep 2010 17:15:55 +0800
parents
children 8603fcb8615a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
19
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
1 gcp v0.1
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
2 (c) Jérôme Poisson aka Goffi 2010
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
3
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
4 gcp (Goffi's cp) is a files copier.
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
5
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
6
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
7 ** LICENSE **
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
8
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
9 gcp is free software: you can redistribute it and/or modify
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
10 it under the terms of the GNU General Public License as published by
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
11 the Free Software Foundation, either version 3 of the License, or
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
12 (at your option) any later version.
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
13
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
14 gcp is distributed in the hope that it will be useful,
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
17 GNU General Public License for more details.
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
18
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
19 You should have received a copy of the GNU General Public License
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
20 along with gcp. If not, see <http://www.gnu.org/licenses/>.
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
21
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
22
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
23
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
24 ** WTF ? **
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
25 gcp is a file copier, loosely inspired from cp, but with high level functionnalities like:
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
26 - progression indicator
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
27 - gcp continue coping even when there is an issue: he just skip the file with problem, and go on
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
28 - journalization: gcp write what he is doing, this allow to now which files where effectively copied
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
29 - fixing names to be compatible with the target filesystem (e.g. removing incompatible chars like "?" or "*" on vfat)
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
30 - if you launch a copy when an other is already running, the files are added to the first queue, this avoir you hard drive to move its head all the time
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
31 - files saving: you can keep track of files you have copied, and re-copy them later (useful when, for example, you always copy some free music to all your friends).
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
32 - gcp will be approximately option-compatible with cp (approximately because the behaviour is not exactly the same, see below)
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
33
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
34 /!\ WARNING /!\
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
35 gcp is at an early stage of development, and really experimental: use at your own risks !
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
36
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
37 ** How to use it ? **
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
38 Pretty much like cp (see gcp --help).
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
39 Please note that the behaviour is not exactly the same as cp, even if gcp want to be option-compatible. Mainly, the destination filenames can be changed (by default, can be deactivated).
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
40 gcp doesn't implement yet all the options from cp, but it's planed.
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
41
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
42 ** What's next ? **
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
43
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
44 Several improvment are already planed:
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
45 - copy queue management (moving copy order)
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
46 - advanced console interface
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
47 - notification (xmpp and maybe mail) when a long copy is finished
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
48 - retry for files which where not correctly copied
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
49 - badly encoded unicode filenames fix
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
50
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
51 ... and other are with a "maybe"
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
52 - graphic interface
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
53 - desktop (Kde, Gnome, XFCE, ...) integration
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
54
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
55 ** Credits **
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
56
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
57 A big big thank to the authors/contributors of...
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
58
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
59 progressbar:
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
60 gcp use ProgressBar (http://pypi.python.org/pypi/progressbar/2.2), a class coded by Nilton Volpato which allow the textual representation of progression.
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
61
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
62 GLib:
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
63 This heavily used library is used here for the main loop and event catchins, and for DBus also
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
64
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
65 DBus:
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
66 This excellent IPC is in the heart of gcp
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
67
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
68 python and its amazing standard library:
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
69 gcp was coded quickly for my own need thanks to this excellent and efficient language and its really huge standard library.
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
70
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
71 If I forgot any credit, please contact me (mail below) to fix it.
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
72
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
73
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
74 ** Contact **
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
75
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
76 You can contact me at goffi@goffi.org .
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
77 You'll find the latest version on my website: http://www.goffi.org (it's mainly in french, I will probably make a little part in english in the future).
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
78 You can also have a look to my other main projects (and maybe to the smaller ones too ;) ):
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
79 - lm (list movie): a tool to list movies using IMdB data, loosely inspired from ls
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
80 - SàT: my main project, a jabber/XMPP client, which is a brick to many others things I have in mind
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
81
7eb698246bec README: first draft
Goffi <goffi@goffi.org>
parents:
diff changeset
82 Don't hesitate to give feedback :)