### Steem-Python is the official Python library for STEEM.

https://github.com/steemit/steem-python
###
In this tutorial series I would like to introduce you to Python and Steem-Python at the same time.

This part of the tutorial deals with setting up the environment and the Python library.
Steem-Python also comes with a wallet called ```steempy```.
If you only want to set up the wallet, you can also use this guide and leave out the second step.

I am not a good programmer.
If you want to learn good Python, you should use a different guide.
This will be an easy to follow, practical guide to use Python with STEEM.
If you know what functions and objects are, you should be able to follow this guide.
If you have no prior knowledge about programming at all, I would recommend you spend an afternoon or so with a Python beginners tutorial and return here.

___

#### Note: 
####
_The library is under constant development, while I will not be able to update this post.
If anything changes in the library, I will have to write a new post, or comment on this one._
___

# 1. Environment
#
First, we need an environment to develop in.
I choose Ubuntu 17.10 because it is easy to install Steem-Python on it.
If you already have an Ubuntu running, you can skip this part.

I assume, you are on Windows. 
If you are on iOS: your problem.

Simply download a copy of Ubuntu 17.10 here: 

https://www.ubuntu.com/desktop/1710

Then download VMWare **Player** here:

https://my.vmware.com/en/web/vmware/free#desktop_end_user_computing/vmware_workstation_player/14_0

Start VMWare Player and set up a new virtual machine with Ubuntu 17.10 on it.
You need very little RAM for this machine. 2 GB is plenty.

I assume you can handle this step. Search the web for help, if you have to.

Once Ubuntu 17.10 is up and running, log in.

This is much like Windows, so I assume you can deal with it ...

Set the timezone to your local time, or to UTC ( the timezone the STEEM blockchain uses ).
Set your keyboard layout to your language, if you have to.

Familiarize yourself with Ubuntu a little, if you have never used it before.

With ```ctrl``` + ```T``` you can open a new terminal window.

It should look something like this:

```felixxx@ubuntu:~$```

___
#### Note:
####

_The Windows commands ```ctrl``` +  ```C``` and ```ctrl``` +  ```V``` do **not** work in the terminal.
Use right mouse-button + paste instead._
___
###

Type ( or paste :P ):

    sudo apt-get update
###
It will update your Ubuntu.

    sudo apt install python3-pip
    pip3 install setuptools
    pip3 install scrypt
    pip3 install wheel
    pip3 install pytest
    sudo apt-get install libssl-dev
    pip3 install steem
###
Will install Steem-Python and all the stuff it needs to run.

#### Congratulations !
###
You have successfully set up your development environment.
###
# 2. First Script
###
Since this is a hands-on guide and I want you to have instant results, we will just skip ahead and try the first script.
I found a nice little example in the documentation ...
http://steem.readthedocs.io/en/latest/

In the terminal, open a new file:

    gedit myfirstscript.py
###
```gedit``` is a text editor. 
You can use any other editor.
It will create a file called myfirstscript.py in the directory you are currently in. 
You can navigate directories with ```cd``` - search the web if you have to.
 
For the first script, I will take some bits from the 'Simple Voting Bot' example.
http://steem.readthedocs.io/en/latest/examples.html ( bottom of the page ).

Copy these 7 lines of code into the editor-window:

    from steem.blockchain import Blockchain
    from steem.post import Post

    b = Blockchain()
    s = map(Post, b.stream(filter_by=['comment']))

    for post in s:

        if post.is_main_post():

            print('https://steemit.com/tag/@' + post['author'] + '/' + post['permlink'])
###
To see an instant result, save the file and close gedit.
Back in the terminal, type:

    python3 myfirstscript.py
###

# Voila !
###
You should see something like this ( slowly building up ) :

https://i.imgur.com/oM5LMlT.png
#
The code contains an open loop.
Press ```ctrl``` + ```c``` to stop it.

___

### Breakdown:
###
    from steem.blockchain import Blockchain
    from steem.post import Post
###
It will import the ```Blockchain``` object from the ```blockchain``` module of the ```steem``` library.
( Guess what the second line does ... )

    b = Blockchain()
###
Will _initialize_ ```'b'``` as a Blockchain() object.
The blockchain module has a ```stream```-function, which allows us to 'stream' block-wise through the chain or go through its history.

    s = map(Post, b.stream(filter_by=['comment']))
###
Will initialize a ```stream``` called ```'s'```.

___
#### Note:
####
_This ```map``` move is pretty cool, as it will create a Post() object from every item that goes through our stream.
Don't worry, if you don't understand it right now. 
This code doesn't work very well; **Every** comment forces a new API call to the node, which takes capacities off the node and costs you time, also.
Your script will not be able to keep up with the blockchain usually and crash after a while with an exception.
I will get to this in part 2 ..._

_Also note, that on blockchain level, there is no real difference between a comment and a post.
You will see a lot of different names for it. 
Comments have a 'parent_post' and posts ( also: 'main-posts' or 'root-posts' ) do not._
___

Since this is just a quick example for testing purposes, we will keep that ```map```-trick. 

Now all that is left is to set up a loop through all items in the ```stream``` and then do something.
How about this:

    for post in s:

        if post.is_main_post():

            print('https://steemit.com/tag/@' + post['author'] + '/' + post['permlink'])
###
For every post in the stream 's', which is also a main-post, this will construct the weblink to the post on steemit.com.
```is_main_post()``` is a handy function from the ```post```-module, which I think simply tests if the post has a parent, or not. I was too lazy to look that up.
The same module also has a 'construct_weblink'-function or something similar, which does exactly the same as the 3rd line of code above.

#### This was just a quick example to get you going.
###
I hope it works for you.

___

## To be continued ...
###
You can now play around with the [examples](http://steem.readthedocs.io/en/latest/examples.html).

This tutorial series will probably work best, if I get some feedback.
Please feel free to comment if you have any questions or scripts you would like to see here.

# Please do not use this knowledge to make annoying spam-bots !
###
It will not pay off anyways.

# Peace,
###
@felixxx