mickael9 avatar mickael9 committed 335df24

Release 0.1

Comments (0)

Files changed (4)

+include *.md
+# What is it?
+
+This tool is a basic command-line interface to the [ge.tt](http://ge.tt/)
+file sharing website.
+You can use it to upload files, list and create shares, and also delete those.
+
+One of the advantages of ge.tt over other sharing websites is that you don't
+need to wait for the uploading process to end to be able to share a file
+with others. Your file gets a link as soon as it starts uploading, and others
+will be able to download it while it's uploading.
+
+Every file is part of share, which can contain several of them.
+Shares can have a title, and are identified by an URL in the form of
+*http://ge.tt/share_name*
+
+# Installation
+
+To use this tool, you need to have Python 3 installed :
+
+- If you're using Windows you can download it from
+  [python.org](http://python.org/download/)  
+  Please make sure to pick Python 3.x and not Python 2.X !
+
+- For apt-get based Linux distributions (such as Debian or Ubuntu),
+  you can install it with :  
+  `# apt-get install python3`
+
+You then need to install gett-cli (this will provide the *gett* command):
+
+- on Windows, use this [MSI Installer](https://bitbucket.org/mickael9/gett-cli/downloads/gett-cli-0.1.win32.msi)
+- on other systems, download the [source tarball](https://bitbucket.org/mickael9/gett-cli/downloads/gett-cli-0.1.tar.gz)
+  and run  
+  `$ python3 setup.py install` (you might need to substitute *python3* to *python*
+   if python3 is the default interpreter)
+
+That's it!
+
+# Usage examples
+
+Uploading files to a new share:
+
+    $ gett hello.jpg image2.png
+
+
+Uploading files to an existing share:
+
+    $ gett -s http://ge.tt/share_name hello.jpg image2.png
+
+
+Listing your shares:
+
+    $ gett --list
+
+
+Deleting a share:
+
+    $ gett --delete http://ge.tt/share_name
+
+
+Deleting a file:
+
+    $ gett --delete http://ge.tt/share_name/v/0
+
+
+Note that whenever *http://ge.tt/<share_name>[/v/<fileid>]* is expected,
+you can omit the *http://ge.tt/* part: 
+
+    $ gett --delete share_name/v/0
+
+
+You can see all the available options with:
+
+    $ gett --help
                 ret.append(open(item, 'rb'))
 
     if not ret:
-        raise argparse.ArgumentTypeError("Invalid pattern")
-
+        print('warning: %s: no match' % string)
     return ret
 
 def main():
 
 from setuptools import setup, find_packages
 
-setup(name='Ge.tt uploader',
-      version='0.0',
+setup(name='gett-cli',
+      version='0.1',
       description='A command-line Ge.tt uploader and manager',
       author='Mickaël THOMAS',
       author_email='mickael9@gmail.com',
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.