This is a repository that holds a bunch of separated python scripts whose origin arises from a bunch of several independent ideas that are not big enough to have a dedicated repository and dedicated attention. Some of the utilities will be described in this README file and others maybe not. The idea is to keep this little ideas living in the realm of consciousness and to organize this birth living thoughts, that may end in nothing, but were important for me somewhere in this journey I call life.

Here we have a folder dedicated to networking based experiences. It could be in the other repository called pysniff that is dedicated to low level networking protocols. But since this was a separated line of thought that impeled me to start the work this ended up as a miscellaneous script in this jungle of code. The most interesting thing here is the upnp.py script that uses the Simple Service Discovery Protocol to ask the router for information. The next step here, if it will ever be one (muhahaha) would be to clean the code and give a more organized python API to query the router and give them instructions, namely for port forward rules based on this UPNp philosophy.

Don't worry I will not sell you ISP solutions. I'm a portuguese folk and in my country (Portugal, for those who don't know what portuguese mean) there is a ISP called MEO that used to setup Thompson Routers for their clients. It turns out that they were poorly configured and they were vulnerable to this attack so this is basically the python implemented described there. As a disclaimer I must add that no other routers were attacked, just my own for educational and proof of concept, purposes.

This was an initial idea of scrapping public services to automate analysis and in someway generates the project called WebPtData. This will scrap the Base.gov.pt site and inject the data in a local MySQL database for further analysis.

I have an Ereader. Yes I'm capable of reading stuff, who would say!? So it turns out that my ereader is a Cybook Ocean a very nice 8 inch ereader that sucks in terms of software and integration with other platforms. I'm a tech guy who also happens to use Goodreads to keep track of my reading status. It also happens that the integration between these two worlds is practically non existent so I decide to give it a help and try to mitigate this serious failure. The initial idea would be to use some goodreads API and do only the SQLite extraction of data and inject it in goodreads with one of the given APIs. It turns out that I didn't like any of them, more on this subject here, and by this reason I decided also to implement my own goodreads API which is under the file goodreads.py.

To ease the use with goodreads API in the shell it was developed a python script that will enable you direct iteraction with the goodreads api and, as soon as it is fully developed will be put under the bin folder to be added to your binary folder during your installation through pip invocation

The goodreads command line script has a description that can be consulted by executing

goodreads -h

The goodreads needs OAuth tokens and Application tokens that need to be provided to the script via a yaml file you need that, at the moment, has the following structure

Goodreads:
  APP_KEY: 'APP_KEY'
  APP_SECRET:  'APP_SECRET'
  OAUTH_TOKEN : 'OAUTH_TOKEN'
  OAUTH_SECRET : 'OAUTH_SECRET'

To list the last 100 user status you type

goodreads -c configs.yaml -u -st -l

where configs.yaml has the configurations needed for the script to work. The flag -u means that we want user operations, -st we want status information and the -l means we want to list, in short this commands means list user status. The output will be a json with the result of the query, it will inclusively include the http communication information because it can be useful in some cases

Adding reviews is also a feature you can exploit with this command line tool, as an example follows a review done to the first book registered in th Goodreads,

goodreads -c configs.yaml -r -a -d '{"idBook" : "1", "review" : "This is an amazing book. I m just filling up this with keywords because the review has a minimum amount of text you must fill. So, for this reason and this reason only I must fill up space and time with silly and shallow words.", "rating":"4"}'

To install this package in your system you just need to run

sudo pip install butils --extra-index-url http://pip.balhau.net/simple

This command line will fetch the last version from my local pip repository.