S1cbUui6)

Stack Overflow command line written in python. Using SoCLI you can search and browse Stack Overflow without leaving the terminal. Just use the socli command:

!SoCLI in action

$3

##### Supported platforms
* Linux
* Windows
* Mac

##### Requirements
* Python 2.0 or higher

##### For Linux
Install python and just use pip command to install socli:
``

bash

sudo apt-get install python python-pip

sudo pip install socli



##### For Windows

Download and install Python. Don't forget to check the option "Add to path".



Open a command prompt with administrative privileges and use pip command to install socli:

bash

pip install socli



Use easy_install if your python path have a space in it. Read more: "Failed to create process":



easy_install socli





##### For Mac (via homebrew)

Install python and socli:

bash

brew install python

easy_install pip

pip install socli



$3

Use the command below to update your existing version of socli to the newest version so that you won't miss any features:

bash

sudo pip install --upgrade socli





$3

##### Quick Search

Use the socli command followed by the search query:

bash

socli for loop in python syntax





The above command will search for the query "for loop in python syntax" and displays the first most voted question in Stack Overflow with its most voted answer. Pretty quick, right?



##### Interactive Search

You can search Stack Overflow interactively by using the command below:

sh

socli -iq html error 404





This will display a list of questions from Stack Overflow for the query "html error 404" and it will allow you to choose any of the questions you like interactively. When you choose a question, it will display the complete description of the chosen question with its most voted answer. You can also browse through the other answers to that question using the up and down arrow keys as well as go back to the list of questions using the left arrow key.



##### Manual Search

This will allow you to specify a requested question number for your query. For example, consider the following command:

sh

socli -r 2 -q javascript prototype function



This command searches for "javascript prototype function" in Stack Overflow and displays the second question that contains it.



##### Topic-Based Search

Stack Overflow supports topic by using tags. socli allows you to query Stack Overflow based on specific tags.  Just specify the tag via the following command:

sh

socli -t javascript -q window.open



You can also specify multiple tags, Just seporate them with a comma:

sh

socli -t javascript,node.js -q window.open



See the complete list of tags here.



##### User Profile Browsing

Just use the command below to set your user ID in socli. When you execute the command next time, it will automaticially fetch the data.

sh

socli -u



if your are an extensive user of StackOverflow, socli allows you to set your own API key to overcome the StackOverflow API Limitations. Just use the command below:

sh

socli --api



You can get an API Key here by registering as a new app. Please don't use SoCLI as app name.



##### Posting a New Question

If you can't find an answer for your question in Stack Overflow, socli allows you to create a new question via the web browser. Just type the command below and socli will open the new question page of Stack Overflow in the web browser for you:

sh

socli -n





$3

socli has the following syntax



Usage: socli [ Arguments] < Search Query >





###### Arguments (optional)

| Short | Long | Description | Example |

|--------|--------|--------|--------|

| -q | --query | Used to specify the query when arguments are used. A query value must be passed to it. If it is used alone (socli -q query) then it will display the same result as socli query. | socli -q query |

| -i | --interactive |  Used to search interactively. It doesn't take any values. It must be followed by a -q or --query after it. | socli -i -q query |

| -r | --res | Used for manual search. It takes the question number as the argument and it must be followed by a  -q or --query after it. | socli -r 4 -q query |

| -t | --tag | Specifies the tag to search for the query on Stack Overflow. It must be followed by a  -q or --query after it. | socli -t js -q query |

| -n | --new | Opens the web browser to create a new question on Stack Overflow. | socli --new |

| -u | --user | Displays the user profile informations. If no argument is given, it will display your profile. | socli -u 22656 |

| -a | --api | Sets a custom API key. | socli --api |

| -d | --del | Deletes the configuration file generated by socli -u manually. | socli -d |

| -s | --sosearch | SoCLI uses Google search by default to search for questions. To override this and use stackoverflow's default search instead. | socli -s -q for loop python |

| -h | --help | Displays the help text. | socli --help |



###### Query

This term refers to what you're searching for in Stack Overflow.



$3

These are the amazing features of SoCLI:

* Manual Search

* Interactively browse Stack Overflow using the interactive mode

* Coloured interface

* Question stats view

* Tag support

* Can open the page in a browser

* Can view user profiles

* Can create a new question via the web browser



$3

Command line interface for:

- [ ] Stack Overflow authentication

- [ ] Posting to Stack Overflow

- [ ] Upvote answer

- [ ] Comment on an answer

- [ ] Browsing stackoverflow home page



Please check out the list of issues.



$3

If you are willing to contribute to SoCLI project, you are awesome! Just follow the steps below:



1. Fork it!

2. Make a local clone:

sh

  git clone https://github.com/{YOUR_USERNAME}/socli.git





3. Switch to the directory:

cd socli

 

4. Create your new branch:

git checkout -b feature name



5. Make necessary changes to this source code

6. Add changes to git index by using

git add --all .



7. Commit your changes:

git commit -am 'Added new feature'



8. Push to the branch:

git push`
9. Submit a new pull request :smile:

$3

Special thanks to these superheroes:
* Elliott Beach for improving color support by adding colorama #29, For making SoCLI more interactive #35. 36 #40 You rocks...
* Aaxu for the PR: #59, #58, #56, #54, and #53. High Five!
* Killbee for making SoCLI colorful #3
* Sam Dean for adding Macintosh SoCLI installation instructions #1
* Plinio89s for adding the check for color support #8
* nagracks for improving readability of the SoCLI code #11
* mwwynne for adding links to the SoCLI #13
* Carlos J. Puga Medina for finding the bug #11 on SoCLI python2 version and for making SoCLI freshports port
Jon Ericson (Community Manager, Stack Overflow*) for the PR #18 and letting me know about the Stack Overflow attribution policy. Thanks for the blog post
* Ankit Kr. Singh for fixing some typos PR #21 #23
* Harsha Alva for fixing windows encoding problem PR #24
* Pia Mancini for adding SoCLI to OpenCollective #27
* Aditya Tandon for the issue #30
* Akshatha Nayak for your first contribution to an open source project. PR #31
* Levi Sabah for PR #43
* liamhawkins for PR #44 and #45
* Arount for fixing issue #48 via PR #47
* Cédric Picard for the issue #42
* Amartya Chaudhuri for his first contribution to SOCLI #51

$3

If you are experiencing any bugs, don’t forget to open a new issue.

$3

* Thanks to all the existing users of SoCLI.
* Thanks to all upvoters and followers on reddit.
* impress that girl in the Starbucks by browsing SO with your CLI app XD XD by insane0hflex. Thanks for the post :wink:
* Special thanks to people who wrote about SoCLI on their blogs and websites:
* wykop.pl
* memect.com
* pseudoscripter
* b.hatena.ne.jp
* jericson.github.io
* The really big list of really interesting Open Source projects
* Ostechnix
* lamiradadelreplicante.com
* dou.ua
* Tweets:
* @cyb3rops
* @pythontrending
* Thanks to my favourite IDE JetBrains PyCharm :heart: :smile:

$3

Sponsor SoCLI on Collaborizm or on Open Collective:

* Thanks Steven Reubenstone for contributing $5 for the issue #22

$3

Hope you liked this project, don't forget to give it a star :star:

SoCLI ![PyPI version](https://badge.fury.io/py/socli) ![Build Status](https://travis-ci.org/gautamkrishnar/socli) ![Collaborizm](https://www.collaborizm.com/project/S1cbUui6)

Stack Overflow command line written in python. Using SoCLI you can search and browse Stack Overflow without leaving the terminal. Just use the socli command:

!SoCLI in action

$3

##### Supported platforms
* Linux
* Windows
* Mac

##### Requirements
* Python 2.0 or higher

##### For Linux
Install python and just use pip command to install socli:
``

bash

sudo apt-get install python python-pip

sudo pip install socli



##### For Windows

Download and install Python. Don't forget to check the option "Add to path".



Open a command prompt with administrative privileges and use pip command to install socli:

bash

pip install socli



Use easy_install if your python path have a space in it. Read more: "Failed to create process":



easy_install socli





##### For Mac (via homebrew)

Install python and socli:

bash

brew install python

easy_install pip

pip install socli



$3

Use the command below to update your existing version of socli to the newest version so that you won't miss any features:

bash

sudo pip install --upgrade socli





$3

##### Quick Search

Use the socli command followed by the search query:

bash

socli for loop in python syntax





The above command will search for the query "for loop in python syntax" and displays the first most voted question in Stack Overflow with its most voted answer. Pretty quick, right?



##### Interactive Search

You can search Stack Overflow interactively by using the command below:

sh

socli -iq html error 404





This will display a list of questions from Stack Overflow for the query "html error 404" and it will allow you to choose any of the questions you like interactively. When you choose a question, it will display the complete description of the chosen question with its most voted answer. You can also browse through the other answers to that question using the up and down arrow keys as well as go back to the list of questions using the left arrow key.



##### Manual Search

This will allow you to specify a requested question number for your query. For example, consider the following command:

sh

socli -r 2 -q javascript prototype function



This command searches for "javascript prototype function" in Stack Overflow and displays the second question that contains it.



##### Topic-Based Search

Stack Overflow supports topic by using tags. socli allows you to query Stack Overflow based on specific tags.  Just specify the tag via the following command:

sh

socli -t javascript -q window.open



You can also specify multiple tags, Just seporate them with a comma:

sh

socli -t javascript,node.js -q window.open



See the complete list of tags here.



##### User Profile Browsing

Just use the command below to set your user ID in socli. When you execute the command next time, it will automaticially fetch the data.

sh

socli -u



if your are an extensive user of StackOverflow, socli allows you to set your own API key to overcome the StackOverflow API Limitations. Just use the command below:

sh

socli --api



You can get an API Key here by registering as a new app. Please don't use SoCLI as app name.



##### Posting a New Question

If you can't find an answer for your question in Stack Overflow, socli allows you to create a new question via the web browser. Just type the command below and socli will open the new question page of Stack Overflow in the web browser for you:

sh

socli -n





$3

socli has the following syntax



Usage: socli [ Arguments] < Search Query >





###### Arguments (optional)

| Short | Long | Description | Example |

|--------|--------|--------|--------|

| -q | --query | Used to specify the query when arguments are used. A query value must be passed to it. If it is used alone (socli -q query) then it will display the same result as socli query. | socli -q query |

| -i | --interactive |  Used to search interactively. It doesn't take any values. It must be followed by a -q or --query after it. | socli -i -q query |

| -r | --res | Used for manual search. It takes the question number as the argument and it must be followed by a  -q or --query after it. | socli -r 4 -q query |

| -t | --tag | Specifies the tag to search for the query on Stack Overflow. It must be followed by a  -q or --query after it. | socli -t js -q query |

| -n | --new | Opens the web browser to create a new question on Stack Overflow. | socli --new |

| -u | --user | Displays the user profile informations. If no argument is given, it will display your profile. | socli -u 22656 |

| -a | --api | Sets a custom API key. | socli --api |

| -d | --del | Deletes the configuration file generated by socli -u manually. | socli -d |

| -s | --sosearch | SoCLI uses Google search by default to search for questions. To override this and use stackoverflow's default search instead. | socli -s -q for loop python |

| -h | --help | Displays the help text. | socli --help |



###### Query

This term refers to what you're searching for in Stack Overflow.



$3

These are the amazing features of SoCLI:

* Manual Search

* Interactively browse Stack Overflow using the interactive mode

* Coloured interface

* Question stats view

* Tag support

* Can open the page in a browser

* Can view user profiles

* Can create a new question via the web browser



$3

Command line interface for:

- [ ] Stack Overflow authentication

- [ ] Posting to Stack Overflow

- [ ] Upvote answer

- [ ] Comment on an answer

- [ ] Browsing stackoverflow home page



Please check out the list of issues.



$3

If you are willing to contribute to SoCLI project, you are awesome! Just follow the steps below:



1. Fork it!

2. Make a local clone:

sh

  git clone https://github.com/{YOUR_USERNAME}/socli.git





3. Switch to the directory:

cd socli

 

4. Create your new branch:

git checkout -b feature name



5. Make necessary changes to this source code

6. Add changes to git index by using

git add --all .



7. Commit your changes:

git commit -am 'Added new feature'



8. Push to the branch:

git push`
9. Submit a new pull request :smile:

$3

If you are experiencing any bugs, don’t forget to open a new issue.

$3

Sponsor SoCLI on Collaborizm or on Open Collective:

* Thanks Steven Reubenstone for contributing $5 for the issue #22

$3

Hope you liked this project, don't forget to give it a star :star:

socli-3.8

SoCLI ![PyPI version](https://badge.fury.io/py/socli) ![Build Status](https://travis-ci.org/gautamkrishnar/socli) ![Collaborizm](https://www.collaborizm.com/project/S1cbUui6)

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

socli-3.8

SoCLI ![PyPI version](https://badge.fury.io/py/socli) ![Build Status](https://travis-ci.org/gautamkrishnar/socli) ![Collaborizm](https://www.collaborizm.com/project/S1cbUui6)

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3