gett-cli / README.md

mickael9 335df24 














mickael9 43a2408 






















mickael9 335df24 













mickael9 e892c56 



mickael9 335df24 
mickael9 e892c56 
mickael9 335df24 






































# 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*

Here is an example of what it looks like when uploading files :

    --------------------------------------------------------------------------------
    Share: Untitled (7 file(s)) [http://ge.tt/8ExGXpA]
    --------------------------------------------------------------------------------
    - distribute_setup.py             15.76 KB  http://ge.tt/8ExGXpA/v/1  remote
    - COPYING                          7.65 KB  http://ge.tt/8ExGXpA/v/0  remote
    - gett_uploader.py                 9.17 KB  http://ge.tt/8ExGXpA/v/3  remote
    - gett.py                          7.36 KB  http://ge.tt/8ExGXpA/v/2  remote
    - README.md                        2.02 KB  http://ge.tt/8ExGXpA/v/5  remote
    - MANIFEST.in                     13.00 B   http://ge.tt/8ExGXpA/v/4  remote
    - setup.py                       539.00 B   http://ge.tt/8ExGXpA/v/6  remote
    
    COPYING         (1/7) [##################################################] 100 %
    distribute...py (2/7) [##################################################] 100 %
    gett.py         (3/7) [##################################################] 100 %
    gett_uploa...py (4/7) [##################################################] 100 %
    MANIFEST.in     (5/7) [##################################################] 100 %
    README.md       (6/7) [##################################################] 100 %
    setup.py        (7/7) [##################################################] 100 %
    
    Storage used: 316.30 KB out of 3.00 GB (0 %)

# 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.2.win32.msi)
- on other systems, you can simply use *pip* if you have it :  
  `# pip install gett-cli`  
  alternatively, you can download the [source tarball](https://bitbucket.org/mickael9/gett-cli/get/v0.2.tar.bz2)
  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
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.