0.3.2

Signed-off-by: R4SAS <r4sas@i2pmail.org>

.gitattributes

@@ -0,0 +1,4 @@
+.github/** export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+README.md export-ignore

.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+- package-ecosystem: pip
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "17:00"
+  open-pull-requests-limit: 10

.gitignore

@@ -131,3 +131,6 @@ venv.bak/
 
 # PyCharm project settings
 .idea
+
+# PBinCLI downloaded paste text
+paste-*.txt

MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.rst
+include requirements.txt

README.md

@@ -1,6 +1,6 @@
 [![GitHub license](https://img.shields.io/github/license/r4sas/PBinCLI.svg)](https://github.com/r4sas/PBinCLI/blob/master/LICENSE)
 [![GitHub tag](https://img.shields.io/github/tag/r4sas/PBinCLI.svg)](https://github.com/r4sas/PBinCLI/tags/)
-[![Codacy Badge](https://api.codacy.com/project/badge/Grade/4f24f43356a84621bbd9078c4b3f1b70)](https://www.codacy.com/app/r4sas/PBinCLI?utm_source=github.com&utm_medium=referral&utm_content=r4sas/PBinCLI&utm_campaign=Badge_Grade)
+[![Codacy Badge](https://app.codacy.com/project/badge/Grade/4f24f43356a84621bbd9078c4b3f1b70)](https://www.codacy.com/gh/r4sas/PBinCLI/dashboard?utm_source=github.com&utm_medium=referral&utm_content=r4sas/PBinCLI&utm_campaign=Badge_Grade)
 
 PBinCLI
 =====
@@ -8,66 +8,137 @@ PBinCLI
 PBinCLI is command line client for [PrivateBin](https://github.com/PrivateBin/PrivateBin/) written on Python 3.
 
 Installing
------
+=====
+
+Installation inside `virtualenv`:
 ```bash
-virtualenv --python=python3 venv
+python3 -m virtualenv --python=python3 venv
 . venv/bin/activate
 pip install pbincli
 ```
 
-Usage
+Installation to system with pip3:
------
+```bash
+pip3 install pbincli
+```
+
+*Note: if you used installation with `virtualenv`, don't forget to activate it before usage: call `. /path/to/venv/bin/activate` in terminal*
+
+Configuration
+=====
+
 By default pbincli configured to use `https://paste.i2pd.xyz/` for sending and receiving pastes. No proxy used by default.
 
-You can create config file with variables `server` and `proxy` in `~/.config/pbincli/pbincli.conf` to use different settings.
+You can create config file to use different settings.
 
-Example contents:
+Configuration file is searched in `~/.config/pbincli/pbincli.conf`, `%APPDATA%/pbincli/pbincli.conf` (Windows) and `~/Library/Application Support/pbincli/pbincli.conf` (MacOS)
+
+Example contents
+-----
 
 ```ini
 server=https://paste.i2pd.xyz/
 proxy=http://127.0.0.1:3128
 ```
 
-Run inside `venv` command:
+All possible options for configuration file
+-----
 
+| Option               | Default                 | Possible value |
+|----------------------|-------------------------|----------------|
+| server               | https://paste.i2pd.xyz/ | Domain ending with slash |
+| mirrors              | None                    | Domains separated with comma, like `http://privatebin.ygg/,http://privatebin.i2p/` |
+| proxy                | None                    | Proxy address starting with scheme `http://` or `socks5://` |
+| short                | False                   | True / False |
+| short_api            | None                    | `tinyurl`, `clckru`, `isgd`, `vgd`, `cuttly`, `yourls`, `custom` |
+| short_url            | None                    | Domain name of shortener service for `yourls`, or sortener URL (with required parameters) for `custom` |
+| short_user           | None                    | Used only in `yourls` |
+| short_pass           | None                    | Used only in `yourls` |
+| short_token          | None                    | Used only in `yourls` |
+| no_check_certificate | False                   | True / False |
+| no_insecure_warning  | False                   | True / False |
+
+Usage
+=====
+
+Tool available by command `pbincli`, help for every command can be called with `-h` option:
 ```bash
-pbincli send --text "Hello!"
+pbincli {send|get|delete} -h
 ```
 
-Or use stdin input to read text for paste:
+Sending
+-----
 
+* Sending text:
+```bash
+pbincli send -t "Hello! This is test paste!"
+```
+
+* Use stdin input to read text for paste:
 ```bash
 pbincli send - <<EOF
 Hello! This is test paste!
 EOF
 ```
 
-It will send string `Hello! This is test paste!` to PrivateBin.
+* Sending file with text in paste:
-
-To send file use `--file` or `-f` with filename. Example:
-
 ```bash
-pbincli send -c "My document" -f info.pdf
+pbincli send -f info.pdf -t "I'm sending my document."
 ```
 
+* Sending only file without any text:
+```bash
+pbincli send -q -f info.pdf
+```
+
+*Note*: It is possible to set-up paste parameters such as burning after reading, expiritaion time, formatting, enabling discussions, and changing compression algorithm. Please refer to `pbincli send -h` output for more information.
+
+Receiving
+-----
+
 To retrieve paste from server, use `get` command with paste info.
 
-It must be formated like `pasteID#passphrase`. Example:
+It must be formated like `pasteID#Passphrase` or use full URL to paste. Example:
-
 ```bash
-pbincli get 49eeb1326cfa9491#vfeortoVWaYeJlviDdhxQBtj5e0I2kArpynrtu/tnGs=
+pbincli get xxx#yyy                        ### receive paste xxx from https://paste.i2pd.xyz/ by default
-```
+pbincli get https://example.com/?xxx#yyy   ### receive paste xxx from https://example.com/
-More info you can find by typing
-
-```bash
-pbincli [-h] {send, get, delete}
 ```
 
-TODO
+Deletion
-----
+-----
-Write a more complete usage documentation.
+
+To delete paste from server, use `delete` command with required `-p` and `-t` options:
+```bash
+pbincli delete -p xxx -t deletetoken
+```
+
+If you need to delete paste on different server that configured, use `-s` option with instance URL.
+
+Additional examples
+=====
+
+Here you can find additional examples.
+
+Usage with service available inside I2P
+-----
+
+Change settings to use server `http://privatebin.i2p/` and proxy `http://127.0.0.1:4444`. Here's example for configuration file:
+```ini
+server=http://privatebin.i2p/
+proxy=http://127.0.0.1:4444
+```
+
+Using tool with aliases
+-----
+
+Example of alias to send paste from `stdin` direclty to I2P service:
+```bash
+alias pastei2p="echo 'paste the text to stdin' && pbincli send -s http://privatebin.i2p/ -x http://127.0.0.1:4444 -"
+```
+
+Call it by running `pastei2p` in terminal.
 
 License
--------
+=====
-This project is licensed under the MIT license, which can be found in the file
+
-[LICENSE](https://github.com/r4sas/PBinCLI/blob/master/LICENSE) in the root of the project source code.
+This project is licensed under the MIT license, which can be found in the file [LICENSE](https://github.com/r4sas/PBinCLI/blob/master/LICENSE) in the root of the project source code.

README.rst

@@ -1,91 +1,200 @@
-
+
-
+
-.. image:: https://img.shields.io/github/license/r4sas/PBinCLI.svg
+.. image:: https://img.shields.io/github/license/r4sas/PBinCLI.svg
-   :target: https://github.com/r4sas/PBinCLI/blob/master/LICENSE
+   :target: https://github.com/r4sas/PBinCLI/blob/master/LICENSE
-   :alt: GitHub license
+   :alt: GitHub license
-
+
-
+
-.. image:: https://img.shields.io/github/tag/r4sas/PBinCLI.svg
+.. image:: https://img.shields.io/github/tag/r4sas/PBinCLI.svg
-   :target: https://github.com/r4sas/PBinCLI/tags/
+   :target: https://github.com/r4sas/PBinCLI/tags/
-   :alt: GitHub tag
+   :alt: GitHub tag
-
+
-
+
-.. image:: https://api.codacy.com/project/badge/Grade/4f24f43356a84621bbd9078c4b3f1b70
+.. image:: https://app.codacy.com/project/badge/Grade/4f24f43356a84621bbd9078c4b3f1b70
-   :target: https://www.codacy.com/app/r4sas/PBinCLI?utm_source=github.com&utm_medium=referral&utm_content=r4sas/PBinCLI&utm_campaign=Badge_Grade
+   :target: https://www.codacy.com/gh/r4sas/PBinCLI/dashboard?utm_source=github.com&utm_medium=referral&utm_content=r4sas/PBinCLI&utm_campaign=Badge_Grade
-   :alt: Codacy Badge
+   :alt: Codacy Badge
-
+
-
+
-PBinCLI
+PBinCLI
-=======
+=======
-
+
-PBinCLI is command line client for `PrivateBin <https://github.com/PrivateBin/PrivateBin/>`_ written on Python 3.
+PBinCLI is command line client for `PrivateBin <https://github.com/PrivateBin/PrivateBin/>`_ written on Python 3.
-
+
-Installing
+Installing
-----------
+==========
-
+
-.. code-block:: bash
+Installation inside ``virtualenv``\ :
-
+
-   virtualenv --python=python3 venv
+.. code-block:: bash
-   . venv/bin/activate
+
-   pip install pbincli
+   python3 -m virtualenv --python=python3 venv
-
+   . venv/bin/activate
-Usage
+   pip install pbincli
------
+
-
+Installation to system with pip3:
-By default pbincli configured to use ``https://paste.i2pd.xyz/`` for sending and receiving pastes. No proxy used by default.
+
-
+.. code-block:: bash
-You can create config file with variables ``server`` and ``proxy`` in ``~/.config/pbincli/pbincli.conf`` to use different settings.
+
-
+   pip3 install pbincli
-Example contents:
+
-
+*Note: if you used installation with ``virtualenv``\ , don't forget to activate it before usage: call ``. /path/to/venv/bin/activate`` in terminal*
-.. code-block:: ini
+
-
+Configuration
-   server=https://paste.i2pd.xyz/
+=============
-   proxy=http://127.0.0.1:3128
+
-
+By default pbincli configured to use ``https://paste.i2pd.xyz/`` for sending and receiving pastes. No proxy used by default.
-Run inside ``venv`` command:
+
-
+You can create config file to use different settings.
-.. code-block:: bash
+
-
+Configuration file is searched in ``~/.config/pbincli/pbincli.conf``\ , ``%APPDATA%/pbincli/pbincli.conf`` (Windows) and ``~/Library/Application Support/pbincli/pbincli.conf`` (MacOS)
-   pbincli send --text "Hello!"
+
-
+Example contents
-Or use stdin input to read text for paste:
+----------------
-
+
-.. code-block:: bash
+.. code-block:: ini
-
+
-   pbincli send - <<EOF
+   server=https://paste.i2pd.xyz/
-   Hello! This is test paste!
+   proxy=http://127.0.0.1:3128
-   EOF
+
-
+All possible options for configuration file
-It will send string ``Hello! This is test paste!`` to PrivateBin.
+-------------------------------------------
-
+
-To send file use ``--file`` or ``-f`` with filename. Example:
+.. list-table::
-
+   :header-rows: 1
-.. code-block:: bash
+
-
+   * - Option
-   pbincli send -c "My document" -f info.pdf
+     - Default
-
+     - Possible value
-To retrieve paste from server, use ``get`` command with paste info.
+   * - server
-
+     - https://paste.i2pd.xyz/
-It must be formated like ``pasteID#passphrase``. Example:
+     - Domain ending with slash
-
+   * - mirrors
-.. code-block:: bash
+     - None
-
+     - Domains separated with comma, like ``http://privatebin.ygg/,http://privatebin.i2p/``
-   pbincli get 49eeb1326cfa9491#vfeortoVWaYeJlviDdhxQBtj5e0I2kArpynrtu/tnGs=
+   * - proxy
-
+     - None
-More info you can find by typing
+     - Proxy address starting with scheme ``http://`` or ``socks5://``
-
+   * - short
-.. code-block:: bash
+     - False
-
+     - True / False
-   pbincli [-h] {send, get, delete}
+   * - short_api
-
+     - None
-TODO
+     - ``tinyurl``\ , ``clckru``\ , ``isgd``\ , ``vgd``\ , ``cuttly``\ , ``yourls``\ , ``custom``
-----
+   * - short_url
-
+     - None
-Write a more complete usage documentation.
+     - Domain name of shortener service for ``yourls``\ , or sortener URL (with required parameters) for ``custom``
-
+   * - short_user
-License
+     - None
--------
+     - Used only in ``yourls``
-
+   * - short_pass
-This project is licensed under the MIT license, which can be found in the file
+     - None
-`LICENSE <https://github.com/r4sas/PBinCLI/blob/master/LICENSE>`_ in the root of the project source code.
+     - Used only in ``yourls``
+   * - short_token
+     - None
+     - Used only in ``yourls``
+   * - no_check_certificate
+     - False
+     - True / False
+   * - no_insecure_warning
+     - False
+     - True / False
+
+
+Usage
+=====
+
+Tool available by command ``pbincli``\ , help for every command can be called with ``-h`` option:
+
+.. code-block:: bash
+
+   pbincli {send|get|delete} -h
+
+Sending
+-------
+
+
+* 
+  Sending text:
+
+  .. code-block:: bash
+
+     pbincli send -t "Hello! This is test paste!"
+
+* 
+  Use stdin input to read text for paste:
+
+  .. code-block:: bash
+
+     pbincli send - <<EOF
+     Hello! This is test paste!
+     EOF
+
+* 
+  Sending file with text in paste:
+
+  .. code-block:: bash
+
+     pbincli send -f info.pdf -t "I'm sending my document."
+
+* 
+  Sending only file without any text:
+
+  .. code-block:: bash
+
+     pbincli send -q -f info.pdf
+
+*Note*\ : It is possible to set-up paste parameters such as burning after reading, expiritaion time, formatting, enabling discussions, and changing compression algorithm. Please refer to ``pbincli send -h`` output for more information.
+
+Receiving
+---------
+
+To retrieve paste from server, use ``get`` command with paste info.
+
+It must be formated like ``pasteID#Passphrase`` or use full URL to paste. Example:
+
+.. code-block:: bash
+
+   pbincli get xxx#yyy                        ### receive paste xxx from https://paste.i2pd.xyz/ by default
+   pbincli get https://example.com/?xxx#yyy   ### receive paste xxx from https://example.com/
+
+Deletion
+--------
+
+To delete paste from server, use ``delete`` command with required ``-p`` and ``-t`` options:
+
+.. code-block:: bash
+
+   pbincli delete -p xxx -t deletetoken
+
+If you need to delete paste on different server that configured, use ``-s`` option with instance URL.
+
+Additional examples
+===================
+
+Here you can find additional examples.
+
+Usage with service available inside I2P
+---------------------------------------
+
+Change settings to use server ``http://privatebin.i2p/`` and proxy ``http://127.0.0.1:4444``. Here's example for configuration file:
+
+.. code-block:: ini
+
+   server=http://privatebin.i2p/
+   proxy=http://127.0.0.1:4444
+
+Using tool with aliases
+-----------------------
+
+Example of alias to send paste from ``stdin`` direclty to I2P service:
+
+.. code-block:: bash
+
+   alias pastei2p="echo 'paste the text to stdin' && pbincli send -s http://privatebin.i2p/ -x http://127.0.0.1:4444 -"
+
+Call it by running ``pastei2p`` in terminal.
+
+License
+=======
+
+This project is licensed under the MIT license, which can be found in the file `LICENSE <https://github.com/r4sas/PBinCLI/blob/master/LICENSE>`_ in the root of the project source code.

pbincli/__init__.py

@@ -2,6 +2,6 @@
 # -*- coding: utf-8 -*-
 
 __author__ = "R4SAS <r4sas@i2pmail.org>"
-__version__ = "0.2"
+__version__ = "0.3.2"
 __copyright__ = "Copyright (c) R4SAS"
 __license__ = "MIT"

pbincli/actions.py

@@ -1,23 +1,41 @@
 from pbincli.format import Paste
+from pbincli.utils import PBinCLIError, validate_url_ending
+import signal
+
+def signal_handler(sig, frame):
+    print('Keyboard interrupt received, terminating…')
+    exit(0)
+
+signal.signal(signal.SIGINT, signal_handler)
+
+
+def send(args, api_client, settings=None):
+    from pbincli.api import Shortener
+    if args.short:
+        shortener = Shortener(settings)
 
-def send(args, api_client):
     if not args.notext:
         if args.text:
             text = args.text
         elif args.stdin:
+            print("Reading text from stdin…")
             text = args.stdin.read()
     elif not args.file:
-        print("Nothing to send!")
+        PBinCLIError("Nothing to send!")
-        exit(1)
     else:
         text = ""
 
+    print("Preparing paste…")
     paste = Paste(args.debug)
 
+    if args.verbose: print("Used server: {}".format(api_client.getServer()))
+
     # get from server supported paste format version and update object
+    if args.verbose: print("Getting supported paste format version from server…")
     version = api_client.getVersion()
     paste.setVersion(version)
 
+    if args.verbose: print("Filling paste with data…")
     # set compression type, works only on v2 pastes
     if version == 2:
         paste.setCompression(args.compression)
@@ -33,21 +51,22 @@ def send(args, api_client):
     if args.file:
         paste.setAttachment(args.file)
 
+    if args.verbose: print("Encrypting paste…")
     paste.encrypt(
         formatter = args.format,
         burnafterreading = args.burn,
         discussion = args.discus,
         expiration = args.expire)
 
+    if args.verbose: print("Sending request to server…")
     request = paste.getJSON()
 
-    if args.debug:
+    if args.debug: print("Passphrase:\t{}\nRequest:\t{}".format(paste.getHash(), request))
-        print("Passphrase:\t{}".format(paste.getHash()))
-        print("Request:\t{}".format(request))
 
     # If we use dry option, exit now
     if args.dry: exit(0)
 
+    print("Uploading paste…")
     result = api_client.post(request)
 
     if args.debug: print("Response:\t{}\n".format(result))
@@ -56,34 +75,63 @@ def send(args, api_client):
     if not result['status']: # return code is zero
         passphrase = paste.getHash()
 
-        print("Paste uploaded!\nPasteID:\t{}\nPassword:\t{}\nDelete token:\t{}\n\nLink:\t\t{}?{}#{}".format(
+        # Paste information
+        print("Paste uploaded!\nPasteID:\t{}\nPassword:\t{}\nDelete token:\t{}".format(
             result['id'],
             passphrase,
-            result['deletetoken'],
+            result['deletetoken']))
-            api_client.server,
+
+        # Paste link
+        print("\nLink:\t\t{}?{}#{}".format(
+            settings['server'],
             result['id'],
             passphrase))
+
+        # Paste deletion link
+        print("Delete Link:\t{}?pasteid={}&deletetoken={}".format(
+            settings['server'],
+            result['id'],
+            result['deletetoken']))
+
+        # Print links to mirrors if present
+        if settings['mirrors']:
+            print("\nMirrors:")
+            urls = settings['mirrors'].split(',')
+            for x in urls:
+                print("\t\t{}?{}#{}".format(
+                    validate_url_ending(x),
+                    result['id'],
+                    passphrase))
+
     elif result['status']: # return code is other then zero
-        print("Something went wrong...\nError:\t\t{}".format(result['message']))
+        PBinCLIError("Something went wrong…\nError:\t\t{}".format(result['message']))
-        exit(1)
     else: # or here no status field in response or it is empty
-        print("Something went wrong...\nError: Empty response.")
+        PBinCLIError("Something went wrong…\nError: Empty response.")
-        exit(1)
+
+    if args.short:
+        print("\nQuerying URL shortening service…")
+        shortener.getlink("{}?{}#{}".format(
+            settings['server'],
+            result['id'],
+            passphrase))
 
 
-def get(args, api_client):
+def get(args, api_client, settings=None):
-    from pbincli.utils import check_writable, json_encode
+    from pbincli.utils import check_writable, json_encode, uri_validator
 
     try:
-        pasteid, passphrase = args.pasteinfo.split("#")
+        if uri_validator(args.pasteinfo):
+            api_client.server, pasteinfo = args.pasteinfo.split("?")
+            pasteid, passphrase = pasteinfo.split("#")
+        else:
+            pasteid, passphrase = args.pasteinfo.split("#")
     except ValueError:
-        print("PBinCLI error: provided info hasn't contain valid PasteID#Passphrase string")
+        PBinCLIError("Provided info hasn't contain valid PasteID#Passphrase string")
-        exit(1)
 
     if not (pasteid and passphrase):
-        print("PBinCLI error: Incorrect request")
+        PBinCLIError("Incorrect request")
-        exit(1)
 
+    if args.verbose: print("Used server: {}".format(api_client.getServer()))
     if args.debug: print("PasteID:\t{}\nPassphrase:\t{}".format(pasteid, passphrase))
 
     paste = Paste(args.debug)
@@ -92,13 +140,14 @@ def get(args, api_client):
         paste.setPassword(args.password)
         if args.debug: print("Password:\t{}".format(args.password))
 
+    if args.verbose: print("Requesting paste from server…")
     result = api_client.get(pasteid)
 
     if args.debug: print("Response:\t{}\n".format(result))
 
     # Paste was received. Checking received status code
     if not result['status']: # return code is zero
-        print("Paste received!")
+        print("Paste received! Decoding…")
 
         version = result['v'] if 'v' in result else 1
         paste.setVersion(version)
@@ -135,23 +184,23 @@ def get(args, api_client):
                 f.close()
 
         if version == 1 and 'meta' in result and 'burnafterreading' in result['meta'] and result['meta']['burnafterreading']:
-            print("Burn afrer reading flag found. Deleting paste...")
+            print("Burn afrer reading flag found. Deleting paste…")
             api_client.delete(json_encode({'pasteid':pasteid,'deletetoken':'burnafterreading'}))
 
     elif result['status']: # return code is other then zero
-        print("Something went wrong...\nError:\t\t{}".format(result['message']))
+        PBinCLIError("Something went wrong…\nError:\t\t{}".format(result['message']))
-        exit(1)
     else: # or here no status field in response or it is empty
-        print("Something went wrong...\nError: Empty response.")
+        PBinCLIError("Something went wrong…\nError: Empty response.")
-        exit(1)
 
 
-def delete(args, api_client):
+def delete(args, api_client, settings=None):
     from pbincli.utils import json_encode
 
     pasteid = args.paste
     token = args.token
 
+    if args.verbose: print("Used server: {}".format(api_client.getServer()))
     if args.debug: print("PasteID:\t{}\nToken:\t\t{}".format(pasteid, token))
 
+    print("Requesting paste deletion…")
     api_client.delete(json_encode({'pasteid':pasteid,'deletetoken':token}))

pbincli/api.py

@@ -1,21 +1,29 @@
 import requests
+from requests import HTTPError
+from pbincli.utils import PBinCLIError
+
+def _config_requests(settings=None):
+    if settings['proxy']:
+        proxy = {settings['proxy'].split('://')[0]: settings['proxy']}
+    else:
+        proxy = {}
+
+    if settings['no_insecure_warning']:
+        from requests.packages.urllib3.exceptions import InsecureRequestWarning
+        requests.packages.urllib3.disable_warnings(InsecureRequestWarning)
+
+    session = requests.Session()
+    session.verify = not settings['no_check_certificate']
+
+    return session, proxy
+
 
 class PrivateBin:
-    def __init__(self, server, settings=None):
+    def __init__(self, settings=None):
-        self.server = server
+        self.server = settings['server']
         self.headers = {'X-Requested-With': 'JSONHttpRequest'}
 
-        if settings['proxy']:
+        self.session, self.proxy = _config_requests(settings)
-            self.proxy = {settings['proxy'].split('://')[0]: settings['proxy']}
-        else:
-            self.proxy = {}
-
-        if settings['noinsecurewarn']:
-            from requests.packages.urllib3.exceptions import InsecureRequestWarning
-            requests.packages.urllib3.disable_warnings(InsecureRequestWarning)
-
-        self.session = requests.Session()
-        self.session.verify = settings['nocheckcert']
 
     def post(self, request):
         result = self.session.post(
@@ -27,8 +35,7 @@ class PrivateBin:
         try:
             return result.json()
         except ValueError:
-            print("ERROR: Unable parse response as json. Received (size = {}):\n{}".format(len(result.text), result.text))
+            PBinCLIError("Unable parse response as json. Received (size = {}):\n{}".format(len(result.text), result.text))
-            exit(1)
 
 
     def get(self, request):
@@ -56,11 +63,9 @@ class PrivateBin:
         if not result['status']:
             print("Paste successfully deleted!")
         elif result['status']:
-            print("Something went wrong...\nError:\t\t{}".format(result['message']))
+            PBinCLIError("Something went wrong...\nError:\t\t{}".format(result['message']))
-            exit(1)
         else:
-            print("Something went wrong...\nError: Empty response.")
+            PBinCLIError("Something went wrong...\nError: Empty response.")
-            exit(1)
 
 
     def getVersion(self):
@@ -72,3 +77,199 @@ class PrivateBin:
                 'v' in jsonldSchema['@context'] and
                 '@value' in jsonldSchema['@context']['v']) \
             else 1
+
+    def getServer(self):
+        return self.server
+
+
+class Shortener:
+    """Some parts of this class was taken from
+    python-yourls (https://github.com/tflink/python-yourls/) library
+    """
+    def __init__(self, settings=None):
+        self.api = settings['short_api']
+
+        if self.api is None:
+            PBinCLIError("Unable to activate link shortener without short_api.")
+
+        # we checking which service is used, because some services doesn't require
+        # any authentication, or have only one domain on which it working
+        if self.api == 'yourls':
+            self._yourls_init(settings)
+        elif self.api == 'isgd' or self.api == 'vgd':
+            self._gd_init()
+        elif self.api == 'custom':
+            self.apiurl = settings['short_url']
+
+        self.session, self.proxy = _config_requests(settings)
+
+
+    def _yourls_init(self, settings):
+        if not settings['short_url']:
+            PBinCLIError("YOURLS: An API URL is required")
+
+        # setting API URL
+        apiurl = settings['short_url']
+        if apiurl.endswith('/yourls-api.php'):
+            self.apiurl = apiurl
+        elif apiurl.endswith('/'):
+            self.apiurl = apiurl + 'yourls-api.php'
+        else:
+            PBinCLIError("YOURLS: Incorrect URL is provided.\n" +
+                "It must contain full address to 'yourls-api.php' script (like https://example.com/yourls-api.php)\n" +
+                "or just contain instance URL with '/' at the end (like https://example.com/)")
+
+        # validating for required credentials
+        if settings['short_user'] and settings['short_pass'] and settings['short_token'] is None:
+            self.auth_args = {'username': settings['short_user'], 'password': settings['short_pass']}
+        elif settings['short_user'] is None and settings['short_pass'] is None and settings['short_token']:
+            self.auth_args = {'signature': settings['short_token']}
+        elif settings['short_user'] is None and settings['short_pass'] is None and settings['short_token'] is None:
+            self.auth_args = {}
+        else:
+            PBinCLIError("YOURLS: either username and password or token are required. Otherwise set to default (None)")
+
+
+    def _gd_init(self):
+        if self.api == 'isgd':
+            self.apiurl = 'https://is.gd/'
+        else:
+            self.apiurl = 'https://v.gd/'
+        self.useragent = 'Mozilla/5.0 (compatible; pbincli - https://github.com/r4sas/pbincli/)'
+
+
+    def getlink(self, url):
+        # that is api -> function mapper for running service-related function when getlink() used
+        servicesList = {
+            'yourls': self._yourls,
+            'clckru': self._clckru,
+            'tinyurl': self._tinyurl,
+            'isgd': self._gd,
+            'vgd': self._gd,
+            'cuttly': self._cuttly,
+            'custom': self._custom
+        }
+        # run function selected by choosen API
+        servicesList[self.api](url)
+
+
+    def _yourls(self,url):
+        request = {'action': 'shorturl', 'format': 'json', 'url': url}
+        request.update(self.auth_args)
+
+        result = self.session.post(
+            url = self.apiurl,
+            proxies = self.proxy,
+            data = request)
+
+        try:
+            result.raise_for_status()
+        except HTTPError:
+            try:
+                response = result.json()
+            except ValueError:
+                PBinCLIError("YOURLS: Unable parse response. Received (size = {}):\n{}".format(len(result.text), result.text))
+            else:
+                PBinCLIError("YOURLS: Received error from API: {} with JSON {}".format(result, response))
+        else:
+            response = result.json()
+
+            if {'status', 'statusCode', 'message'} <= set(response.keys()):
+                if response['status'] == 'fail':
+                    PBinCLIError("YOURLS: Received error from API: {}".format(response['message']))
+                if not 'shorturl' in response:
+                    PBinCLIError("YOURLS: Unknown error: {}".format(response['message']))
+                else:
+                    print("Short Link:\t{}".format(response['shorturl']))
+            else:
+                PBinCLIError("YOURLS: No status, statusCode or message fields in response! Received:\n{}".format(response))
+
+
+    def _clckru(self, url):
+        request = {'url': url}
+
+        try:
+            result = self.session.post(
+                url = "https://clck.ru/--",
+                proxies = self.proxy,
+                data = request)
+            print("Short Link:\t{}".format(result.text))
+        except Exception as ex:
+            PBinCLIError("clck.ru: unexcepted behavior: {}".format(ex))
+
+
+    def _tinyurl(self, url):
+        request = {'url': url}
+
+        try:
+            result = self.session.post(
+                url = "https://tinyurl.com/api-create.php",
+                proxies = self.proxy,
+                data = request)
+            print("Short Link:\t{}".format(result.text))
+        except Exception as ex:
+            PBinCLIError("TinyURL: unexcepted behavior: {}".format(ex))
+
+
+    def _gd(self, url):
+        request = {
+            'format': 'json',
+            'url': url,
+            'logstats': 0 # we don't want use any statistics
+        }
+        headers = { 'User-Agent': self.useragent}
+
+        try:
+            result = self.session.post(
+                url = self.apiurl + "create.php",
+                headers = headers,
+                proxies = self.proxy,
+                data = request)
+
+            response = result.json()
+
+            if 'shorturl' in response:
+                print("Short Link:\t{}".format(response['shorturl']))
+            else:
+                PBinCLIError("{}: got error {} from API: {}".format(
+                    "is.gd" if self.api == 'isgd' else 'v.gd',
+                    response['errorcode'],
+                    response['errormessage']))
+
+        except Exception as ex:
+            PBinCLIError("{}: unexcepted behavior: {}".format(
+                "is.gd" if self.api == 'isgd' else 'v.gd',
+                ex))
+
+
+    def _cuttly(self, url):
+        request = {
+            'url': url,
+            'domain': 0
+        }
+
+        try:
+            result = self.session.post(
+                url = "https://cutt.ly/scripts/shortenUrl.php",
+                proxies = self.proxy,
+                data = request)
+            print("Short Link:\t{}".format(result.text))
+        except Exception as ex:
+            PBinCLIError("cutt.ly: unexcepted behavior: {}".format(ex))
+
+
+    def _custom(self, url):
+        if self.apiurl is None:
+            PBinCLIError("No short_url specified - link will not be shortened.")
+
+        from urllib.parse import quote
+        qUrl = quote(url, safe="") # urlencoded paste url
+        rUrl = self.apiurl.replace("{{url}}", qUrl)
+
+        try:
+            result = self.session.get(
+                url = rUrl,
+                proxies = self.proxy)
+            print("Short Link:\t{}".format(result.text))
+        except Exception as ex:
+            PBinCLIError("Shorter: unexcepted behavior: {}".format(ex))

pbincli/cli.py

@@ -3,23 +3,35 @@ import os, sys, argparse
 
 import pbincli.actions
 from pbincli.api import PrivateBin
-from pbincli.utils import PBinCLIException
+from pbincli.utils import PBinCLIException, PBinCLIError, validate_url_ending
 
-CONFIG_PATHS = [os.path.join(".", "pbincli.conf", ),
+CONFIG_PATHS = [
-       os.path.join(os.getenv("HOME") or "~", ".config", "pbincli", "pbincli.conf") ]
+    os.path.join(".", "pbincli.conf", ),
+    os.path.join(os.getenv("HOME") or "~", ".config", "pbincli", "pbincli.conf")
+]
+
+if sys.platform == "win32":
+    CONFIG_PATHS.append(os.path.join(os.getenv("APPDATA"), "pbincli", "pbincli.conf"))
+elif sys.platform == "darwin":
+    CONFIG_PATHS.append(os.path.join(os.getenv("HOME") or "~", "Library", "Application Support", "pbincli", "pbincli.conf"))
 
 def read_config(filename):
     """Read config variables from a file"""
     settings = {}
     with open(filename) as f:
         for l in f.readlines():
-            key, value = l.strip().split("=")
+            if len(l.strip()) == 0:
-            settings[key.strip()] = value.strip()
+                continue
+            try:
+                key, value = l.strip().split("=", 1)
+                settings[key.strip()] = value.strip()
+            except ValueError:
+                PBinCLIError("Unable to parse config file, please check it for errors.")
 
     return settings
 
 def main():
-    parser = argparse.ArgumentParser()
+    parser = argparse.ArgumentParser(description='Full-featured PrivateBin command-line client')
     subparsers = parser.add_subparsers(title="actions", help="List of commands")
 
     # a send command
@@ -36,39 +48,81 @@ def main():
     send_parser.add_argument("-q", "--notext", default=False, action="store_true", help="don't send text in paste")
     send_parser.add_argument("-c", "--compression", default="zlib", action="store",
         choices=["zlib", "none"], help="set compression for paste (default: zlib). Note: works only on v2 paste format")
-    send_parser.add_argument("--no-check-certificate", default=True, action="store_false", help="disable certificate validation")
+    ## URL shortener
-    send_parser.add_argument("--no-insecure-warning", default=False, action="store_true", help="suppress InsecureRequestWarning (only with --no-check-certificate)")
+    send_parser.add_argument("-S", "--short", default=False, action="store_true", help="use URL shortener")
-    send_parser.add_argument("-d", "--debug", default=False, action="store_true", help="enable debug")
+    send_parser.add_argument("--short-api", default=argparse.SUPPRESS, action="store",
+        choices=["tinyurl", "clckru", "isgd", "vgd", "cuttly", "yourls", "custom"], help="API used by shortener service")
+    send_parser.add_argument("--short-url", default=argparse.SUPPRESS, help="URL of shortener service API")
+    send_parser.add_argument("--short-user", default=argparse.SUPPRESS, help="Shortener username")
+    send_parser.add_argument("--short-pass", default=argparse.SUPPRESS, help="Shortener password")
+    send_parser.add_argument("--short-token", default=argparse.SUPPRESS, help="Shortener token")
+    ## Connection options
+    send_parser.add_argument("-s", "--server", default=argparse.SUPPRESS, help="Instance URL (default: https://paste.i2pd.xyz/)")
+    send_parser.add_argument("-x", "--proxy", default=argparse.SUPPRESS, help="Proxy server address (default: None)")
+    send_parser.add_argument("--no-check-certificate", default=False, action="store_true", help="disable certificate validation")
+    send_parser.add_argument("--no-insecure-warning", default=False, action="store_true",
+        help="suppress InsecureRequestWarning (only with --no-check-certificate)")
+    ##
+    send_parser.add_argument("-L", "--mirrors", default=argparse.SUPPRESS, help="Comma-separated list of mirrors of service with scheme (default: None)")
+    send_parser.add_argument("-v", "--verbose", default=False, action="store_true", help="enable verbose output")
+    send_parser.add_argument("-d", "--debug", default=False, action="store_true", help="enable debug output")
     send_parser.add_argument("--dry", default=False, action="store_true", help="invoke dry run")
     send_parser.add_argument("stdin", help="input paste text from stdin", nargs="?", type=argparse.FileType("r"), default=sys.stdin)
     send_parser.set_defaults(func=pbincli.actions.send)
 
     # a get command
     get_parser = subparsers.add_parser("get", description="Get data from PrivateBin instance")
-    get_parser.add_argument("pasteinfo", help="example: aabb#cccddd")
+    get_parser.add_argument("pasteinfo", help="\"PasteID#Passphrase\" or full URL")
     get_parser.add_argument("-p", "--password", help="password for decrypting paste")
-    get_parser.add_argument("--no-check-certificate", default=True, action="store_false", help="disable certificate validation")
+    ## Connection options
-    get_parser.add_argument("--no-insecure-warning", default=False, action="store_true", help="suppress InsecureRequestWarning (only with --no-check-certificate)")
+    get_parser.add_argument("-s", "--server", default=argparse.SUPPRESS, help="Instance URL (default: https://paste.i2pd.xyz/, ignored if URL used in pasteinfo)")
-    get_parser.add_argument("-d", "--debug", default=False, action="store_true", help="enable debug")
+    get_parser.add_argument("-x", "--proxy", default=argparse.SUPPRESS, help="Proxy server address (default: None)")
+    get_parser.add_argument("--no-check-certificate", default=False, action="store_true", help="disable certificate validation")
+    get_parser.add_argument("--no-insecure-warning", default=False, action="store_true",
+        help="suppress InsecureRequestWarning (only with --no-check-certificate)")
+    ##
+    get_parser.add_argument("-v", "--verbose", default=False, action="store_true", help="enable verbose output")
+    get_parser.add_argument("-d", "--debug", default=False, action="store_true", help="enable debug output")
     get_parser.set_defaults(func=pbincli.actions.get)
 
     # a delete command
     delete_parser = subparsers.add_parser("delete", description="Delete paste from PrivateBin instance using token")
     delete_parser.add_argument("-p", "--paste", required=True, help="paste id")
     delete_parser.add_argument("-t", "--token", required=True, help="paste deletion token")
-    delete_parser.add_argument("--no-check-certificate", default=True, action="store_false", help="disable certificate validation")
+    ## Connection options
-    delete_parser.add_argument("--no-insecure-warning", default=False, action="store_true", help="suppress InsecureRequestWarning (only with --no-check-certificate)")
+    delete_parser.add_argument("-s", "--server", default=argparse.SUPPRESS, help="Instance URL (default: https://paste.i2pd.xyz/)")
-    delete_parser.add_argument("-d", "--debug", default=False, action="store_true", help="enable debug")
+    delete_parser.add_argument("-x", "--proxy", default=argparse.SUPPRESS, help="Proxy server address (default: None)")
+    delete_parser.add_argument("--no-check-certificate", default=False, action="store_true", help="disable certificate validation")
+    delete_parser.add_argument("--no-insecure-warning", default=False, action="store_true",
+        help="suppress InsecureRequestWarning (only with --no-check-certificate)")
+    ##
+    delete_parser.add_argument("-v", "--verbose", default=False, action="store_true", help="enable verbose output")
+    delete_parser.add_argument("-d", "--debug", default=False, action="store_true", help="enable debug output")
     delete_parser.set_defaults(func=pbincli.actions.delete)
 
     # parse arguments
     args = parser.parse_args()
 
     CONFIG = {
-        "server": "https://paste.i2pd.xyz/",
+        'server': 'https://paste.i2pd.xyz/',
-        "proxy": None
+        'mirrors': None, # real example for paste.i2pd.xyz: 'http://privatebin.ygg/,http://privatebin.i2p/'
+        'proxy': None,
+        'short': False,
+        'short_api': None,
+        'short_url': None,
+        'short_user': None,
+        'short_pass': None,
+        'short_token': None,
+        'no_check_certificate': False,
+        'no_insecure_warning': False
     }
 
+    # Configuration preference order:
+    # 1. Command line switches
+    # 2. Environment variables
+    # 3. Configuration file
+    # 4. Default values below
+
     for p in CONFIG_PATHS:
         if os.path.exists(p):
             CONFIG.update(read_config(p))
@@ -77,21 +131,21 @@ def main():
     for key in CONFIG.keys():
         var = "PRIVATEBIN_{}".format(key.upper())
         if var in os.environ: CONFIG[key] = os.getenv(var)
+        # values from command line switches are preferred
+        args_var = vars(args)
+        if key in args_var:
+            CONFIG[key] = args_var[key]
 
-    SETTINGS = {
+    # Re-validate PrivateBin instance URL
-        "proxy": CONFIG["proxy"],
+    CONFIG['server'] = validate_url_ending(CONFIG['server'])
-        "nocheckcert": args.no_check_certificate,
-        "noinsecurewarn": args.no_insecure_warning
-    }
 
-    api_client = PrivateBin(CONFIG["server"], settings=SETTINGS)
+    api_client = PrivateBin(CONFIG)
 
     if hasattr(args, "func"):
         try:
-            args.func(args, api_client)
+            args.func(args, api_client, settings=CONFIG)
         except PBinCLIException as pe:
-            print("PBinCLI error: {}".format(pe))
+            raise PBinCLIException("error: {}".format(pe))
-            sys.exit(1)
     else:
         parser.print_help()
 

pbincli/format.py

@@ -1,15 +1,33 @@
-from Crypto.Random import get_random_bytes
-from Crypto.Cipher import AES
 from base64 import b64encode, b64decode
-from pbincli.utils import PBinCLIException
+from pbincli.utils import PBinCLIError
 import zlib
 
+# try import AES cipher and check if it has GCM mode (prevent usage of pycrypto)
+try:
+    from Crypto.Cipher import AES
+    if not hasattr(AES, 'MODE_GCM'):
+        try:
+            from Cryptodome.Cipher import AES
+            from Cryptodome.Random import get_random_bytes
+        except ImportError:
+            PBinCLIError("AES GCM mode is not found in imported crypto module.\n" +
+                "That can happen if you have installed pycrypto.\n\n" +
+                "We tried to import pycryptodomex but it is not available.\n" +
+                "Please install it via pip, if you still need pycrypto, by running:\n" +
+                "\tpip install pycryptodomex\n" +
+                "... otherwise use separate python environment or uninstall pycrypto:\n" +
+                "\tpip uninstall pycrypto")
+    else:
+        from Crypto.Random import get_random_bytes
+except ImportError:
+    PBinCLIError("Unable import pycryptodome")
+
+
 CIPHER_ITERATION_COUNT = 100000
 CIPHER_SALT_BYTES = 8
 CIPHER_BLOCK_BITS = 256
-CIPHER_BLOCK_BYTES = int(CIPHER_BLOCK_BITS/8)
+CIPHER_TAG_BITS = 128
-CIPHER_TAG_BITS = int(CIPHER_BLOCK_BITS/2)
+
-CIPHER_TAG_BYTES = int(CIPHER_TAG_BITS/8)
 
 class Paste:
     def __init__(self, debug=False):
@@ -19,9 +37,13 @@ class Paste:
         self._text = ''
         self._attachment = ''
         self._attachment_name = ''
-        self._key = get_random_bytes(CIPHER_BLOCK_BYTES)
         self._password = ''
         self._debug = debug
+        self._iteration_count = CIPHER_ITERATION_COUNT
+        self._salt_bytes = CIPHER_SALT_BYTES
+        self._block_bits = CIPHER_BLOCK_BITS
+        self._tag_bits = CIPHER_TAG_BITS
+        self._key = get_random_bytes(int(self._block_bits / 8))
 
 
     def setVersion(self, version):
@@ -105,8 +127,8 @@ class Paste:
         return PBKDF2(
             self._key + self._password.encode(),
             salt,
-            dkLen = CIPHER_BLOCK_BYTES,
+            dkLen = int(self._block_bits / 8),
-            count = CIPHER_ITERATION_COUNT,
+            count = self._iteration_count,
             prf = lambda password, salt: HMAC.new(
                 password,
                 salt,
@@ -115,10 +137,10 @@ class Paste:
 
 
     @classmethod
-    def __initializeCipher(self, key, iv, adata):
+    def __initializeCipher(self, key, iv, adata, tagsize):
         from pbincli.utils import json_encode
 
-        cipher = AES.new(key, AES.MODE_GCM, nonce=iv, mac_len=CIPHER_TAG_BYTES)
+        cipher = AES.new(key, AES.MODE_GCM, nonce=iv, mac_len=tagsize)
         cipher.update(json_encode(adata))
         return cipher
 
@@ -143,7 +165,7 @@ class Paste:
         elif self._version == 1:
             return zlib.decompress(bytearray(map(lambda c:ord(c)&255, b64decode(s.encode('utf-8')).decode('utf-8'))), -zlib.MAX_WBITS)
         else:
-            raise PBinCLIException('Unknown compression type provided in paste!')
+            PBinCLIError('Unknown compression type provided in paste!')
 
 
     def __compress(self, s):
@@ -160,115 +182,146 @@ class Paste:
             b = co.compress(s) + co.flush()
             return b64encode(''.join(map(chr, b)).encode('utf-8'))
         else:
-            raise PBinCLIException('Unknown compression type provided!')
+            PBinCLIError('Unknown compression type provided!')
 
 
     def decrypt(self):
+        # that is wrapper which running needed function regrading to paste version
+        if self._version == 2: self._decryptV2()
+        else:                  self._decryptV1()
+
+
+    def _decryptV2(self):
+        from json import loads as json_decode
+        iv = b64decode(self._data['adata'][0][0])
+        salt = b64decode(self._data['adata'][0][1])
+
+        self._iteration_count = self._data['adata'][0][2]
+        self._block_bits = self._data['adata'][0][3]
+        self._tag_bits = self._data['adata'][0][4]
+        cipher_tag_bytes = int(self._tag_bits / 8)
+
+        key = self.__deriveKey(salt)
+
+        # Get compression type from received paste
+        self._compression = self._data['adata'][0][7]
+
+        cipher = self.__initializeCipher(key, iv, self._data['adata'], cipher_tag_bytes)
+        # Cut the cipher text into message and tag
+        cipher_text_tag = b64decode(self._data['ct'])
+        cipher_text = cipher_text_tag[:-cipher_tag_bytes]
+        cipher_tag = cipher_text_tag[-cipher_tag_bytes:]
+        cipher_message = json_decode(self.__decompress(cipher.decrypt_and_verify(cipher_text, cipher_tag)).decode())
+
+        self._text = cipher_message['paste'].encode()
+
+        if 'attachment' in cipher_message and 'attachment_name' in cipher_message:
+            self._attachment = cipher_message['attachment']
+            self._attachment_name = cipher_message['attachment_name']
+
+
+    def _decryptV1(self):
+        from sjcl import SJCL
         from json import loads as json_decode
 
-        if self._version == 2:
+        password = self.__preparePassKey()
-            iv = b64decode(self._data['adata'][0][0])
+        cipher_text = json_decode(self._data['data'])
-            salt = b64decode(self._data['adata'][0][1])
+        if self._debug: print("Text:\t{}\n".format(cipher_text))
-            key = self.__deriveKey(salt)
 
-            # Get compression type from received paste
+        text = SJCL().decrypt(cipher_text, password)
-            self._compression = self._data['adata'][0][7]
 
-            cipher = self.__initializeCipher(key, iv, self._data['adata'])
+        if len(text):
-            # Cut the cipher text into message and tag
+            if self._debug: print("Decoded Text:\t{}\n".format(text))
-            cipher_text_tag = b64decode(self._data['ct'])
+            self._text = self.__decompress(text.decode())
-            cipher_text = cipher_text_tag[:-CIPHER_TAG_BYTES]
-            cipher_tag = cipher_text_tag[-CIPHER_TAG_BYTES:]
-            cipher_message = json_decode(self.__decompress(cipher.decrypt_and_verify(cipher_text, cipher_tag)).decode())
 
-            self._text = cipher_message['paste'].encode()
+        if 'attachment' in self._data and 'attachmentname' in self._data:
+            cipherfile = json_decode(self._data['attachment'])
+            cipherfilename = json_decode(self._data['attachmentname'])
 
-            if 'attachment' in cipher_message and 'attachment_name' in cipher_message:
+            if self._debug: print("Name:\t{}\nData:\t{}".format(cipherfilename, cipherfile))
-                self._attachment = cipher_message['attachment']
-                self._attachment_name = cipher_message['attachment_name']
-        else:
-            from sjcl import SJCL
 
-            password = self.__preparePassKey()
+            attachment = SJCL().decrypt(cipherfile, password)
+            attachmentname = SJCL().decrypt(cipherfilename, password)
 
-            cipher_text = json_decode(self._data['data'])
+            self._attachment = self.__decompress(attachment.decode('utf-8')).decode('utf-8')
-
+            self._attachment_name = self.__decompress(attachmentname.decode('utf-8')).decode('utf-8')
-            if self._debug: print("Text:\t{}\n".format(cipher_text))
-
-            text = SJCL().decrypt(cipher_text, password)
-
-            if len(text):
-                if self._debug: print("Decoded Text:\t{}\n".format(text))
-                self._text = self.__decompress(text.decode())
-
-            if 'attachment' in self._data and 'attachmentname' in self._data:
-                cipherfile = json_decode(self._data['attachment'])
-                cipherfilename = json_decode(self._data['attachmentname'])
-
-                if self._debug: print("Name:\t{}\nData:\t{}".format(cipherfilename, cipherfile))
-
-                attachment = SJCL().decrypt(cipherfile, password)
-                attachmentname = SJCL().decrypt(cipherfilename, password)
-
-                self._attachment = self.__decompress(attachment.decode('utf-8')).decode('utf-8')
-                self._attachment_name = self.__decompress(attachmentname.decode('utf-8')).decode('utf-8')
 
 
     def encrypt(self, formatter, burnafterreading, discussion, expiration):
+        # that is wrapper which running needed function regrading to paste version
+        self._formatter = formatter
+        self._burnafterreading = burnafterreading
+        self._discussion = discussion
+        self._expiration = expiration
+
+        if self._debug: print("[Enc] Starting encyptor…")
+        if self._version == 2: self._encryptV2()
+        else:                  self._encryptV1()
+
+
+    def _encryptV2(self):
         from pbincli.utils import json_encode
-        if self._version == 2:
-            iv = get_random_bytes(CIPHER_TAG_BYTES)
-            salt = get_random_bytes(CIPHER_SALT_BYTES)
-            key = self.__deriveKey(salt)
 
-            # prepare encryption authenticated data and message
+        if self._debug: print("[Enc] Preparing IV, Salt…")
-            adata = [
+        iv = get_random_bytes(int(self._tag_bits / 8))
-                [
+        salt = get_random_bytes(self._salt_bytes)
-                    b64encode(iv).decode(),
+        if self._debug: print("[Enc] Deriving Key…")
-                    b64encode(salt).decode(),
+        key = self.__deriveKey(salt)
-                    CIPHER_ITERATION_COUNT,
-                    CIPHER_BLOCK_BITS,
-                    CIPHER_TAG_BITS,
-                    'aes',
-                    'gcm',
-                    self._compression
-                ],
-                formatter,
-                int(burnafterreading),
-                int(discussion)
-            ]
-            cipher_message = {'paste':self._text}
-            if self._attachment:
-                cipher_message['attachment'] = self._attachment
-                cipher_message['attachment_name'] = self._attachment_name
 
-            cipher = self.__initializeCipher(key, iv, adata)
+        if self._debug: print("[Enc] Preparing aData and message…")
-            ciphertext, tag = cipher.encrypt_and_digest(self.__compress(json_encode(cipher_message)))
+        # prepare encryption authenticated data and message
+        adata = [
+            [
+                b64encode(iv).decode(),
+                b64encode(salt).decode(),
+                self._iteration_count,
+                self._block_bits,
+                self._tag_bits,
+                'aes',
+                'gcm',
+                self._compression
+            ],
+            self._formatter,
+            int(self._discussion),
+            int(self._burnafterreading)
+        ]
+        cipher_message = {'paste':self._text}
+        if self._attachment:
+            cipher_message['attachment'] = self._attachment
+            cipher_message['attachment_name'] = self._attachment_name
 
-            self._data = {'v':2,'adata':adata,'ct':b64encode(ciphertext + tag).decode(),'meta':{'expire':expiration}}
+        if self._debug: print("[Enc] Encrypting message…")
+        cipher = self.__initializeCipher(key, iv, adata, int(self._tag_bits /8 ))
+        ciphertext, tag = cipher.encrypt_and_digest(self.__compress(json_encode(cipher_message)))
 
-        else:
+        if self._debug: print("PBKDF2 Key:\t{}\nCipherText:\t{}\nCipherTag:\t{}"
-            from sjcl import SJCL
+            .format(b64encode(key), b64encode(ciphertext), b64encode(tag)))
 
-            self._data = {'expire':expiration,'formatter':formatter,'burnafterreading':int(burnafterreading),'opendiscussion':int(discussion)}
+        self._data = {'v':2,'adata':adata,'ct':b64encode(ciphertext + tag).decode(),'meta':{'expire':self._expiration}}
 
-            password = self.__preparePassKey()
 
-            if self._debug: print("Password:\t{}".format(password))
+    def _encryptV1(self):
+        from sjcl import SJCL
+        from pbincli.utils import json_encode
 
-            # Encrypting text
+        self._data = {'expire':self._expiration,'formatter':self._formatter,
-            cipher = SJCL().encrypt(self.__compress(self._text.encode('utf-8')), password, mode='gcm')
+            'burnafterreading':int(self._burnafterreading),'opendiscussion':int(self._discussion)}
-            for k in ['salt', 'iv', 'ct']: cipher[k] = cipher[k].decode()
 
-            self._data['data'] = json_encode(cipher)
+        password = self.__preparePassKey()
+        if self._debug: print("Password:\t{}".format(password))
 
-            if self._attachment:
+        # Encrypting text
-                cipherfile = SJCL().encrypt(self.__compress(self._attachment.encode('utf-8')), password, mode='gcm')
+        cipher = SJCL().encrypt(self.__compress(self._text.encode('utf-8')), password, mode='gcm')
-                for k in ['salt', 'iv', 'ct']: cipherfile[k] = cipherfile[k].decode()
+        for k in ['salt', 'iv', 'ct']: cipher[k] = cipher[k].decode()
 
-                cipherfilename = SJCL().encrypt(self.__compress(self._attachment_name.encode('utf-8')), password, mode='gcm')
+        self._data['data'] = json_encode(cipher)
-                for k in ['salt', 'iv', 'ct']: cipherfilename[k] = cipherfilename[k].decode()
 
-                self._data['attachment'] = json_encode(cipherfile)
+        if self._attachment:
-                self._data['attachmentname'] = json_encode(cipherfilename)
+            cipherfile = SJCL().encrypt(self.__compress(self._attachment.encode('utf-8')), password, mode='gcm')
+            for k in ['salt', 'iv', 'ct']: cipherfile[k] = cipherfile[k].decode()
 
+            cipherfilename = SJCL().encrypt(self.__compress(self._attachment_name.encode('utf-8')), password, mode='gcm')
+            for k in ['salt', 'iv', 'ct']: cipherfilename[k] = cipherfilename[k].decode()
+
+            self._data['attachment'] = json_encode(cipherfile)
+            self._data['attachmentname'] = json_encode(cipherfilename)

pbincli/utils.py

@@ -1,9 +1,14 @@
-import json, ntpath, os
+import json, ntpath, os, sys
 
 class PBinCLIException(Exception):
     pass
 
 
+def PBinCLIError(message):
+    print("PBinCLI Error: {}".format(message), file=sys.stderr)
+    exit(1)
+
+
 def path_leaf(path):
     head, tail = ntpath.split(path)
     return tail or ntpath.basename(head)
@@ -12,14 +17,28 @@ def path_leaf(path):
 def check_readable(f):
     # Checks if path exists and readable
     if not os.path.exists(f) or not os.access(f, os.R_OK):
-        raise PBinCLIException("Error accessing path: {}".format(f))
+        PBinCLIError("Error accessing path: {}".format(f))
 
 
 def check_writable(f):
     # Checks if path is writable
     if not os.access(os.path.dirname(f) or ".", os.W_OK):
-        raise PBinCLIException("Path is not writable: {}".format(f))
+        PBinCLIError("Path is not writable: {}".format(f))
 
 
 def json_encode(s):
     return json.dumps(s, separators=(',',':')).encode()
+
+
+def validate_url_ending(s):
+    if not s.endswith('/'):
+        s = s + "/"
+    return s
+
+def uri_validator(x):
+    from urllib.parse import urlparse
+    try:
+        result = urlparse(x)
+        return all([result.scheme, result.netloc])
+    except ValueError:
+        return False

setup.cfg

@@ -0,0 +1,2 @@
+[metadata]
+license_files = LICENSE

setup.py

@@ -17,7 +17,7 @@ setup(
     long_description_content_type='text/x-rst',
     author='R4SAS',
     author_email='r4sas@i2pmail.org',
-    url='https://github.com/r4sas/PBinCLI',
+    url='https://github.com/r4sas/PBinCLI/',
     keywords='privatebin cryptography security',
     license='MIT',
     classifiers=[
@@ -31,9 +31,14 @@ setup(
     ],
     packages=['pbincli'],
     install_requires=install_requires,
+    python_requires='>=3',
     entry_points={
         'console_scripts': [
             'pbincli=pbincli.cli:main',
         ],
-    }
+    },
+    project_urls={
+        'Bug Reports': 'https://github.com/r4sas/PBinCLI/issues',
+        'Source': 'https://github.com/r4sas/PBinCLI/',
+    },
 )