A command line interface for gateoverflow links
Project description
# Gateoverflow CLI :tada:
open / manage links with the question ids(which are right there, next to question title), create new lists of questions, update them etc.
#### Latest Release v0.4.2 :zap:
Available to install through pip [(pypi)](https://pypi.org/project/gateoverflow).
# Table of Contents :clipboard:
[Gateoverflow CLI](#gateoverflow-cli-tada) - [Latest Release v0.4.2](#latest-release-v042-zap)
[Table of Contents](#table-of-contents-clipboard)
[Motivation](#motivation-sleepy)
[Installation](#installation-rocket)
[Requirements](#requirements-hammer_and_wrench)
[Changelog](#changelog-pencil) - [v0.4.0](#v040) - [v0.3.1](#v031) - [v0.2.0](#v020)
[Usage](#usage-fire) - [Parser Commands](#parser-commands) - [Commands](#commands) - [Usage Examples](#usage-examples)
[Future](#future-sleepy)
[Release Checklist](#release-checklist-pencil2)
# Motivation :sleepy:
Scanning QR codes from the book is really inefficient, so is the Lists feature of Gateoverflow Website. With this tool, one can open / manage those links with the question ids(which are right there, next to question title), create new lists (called as tags here cause it’s one too many letters shorter than lists) of questions.
But this wasn’t really the motivation, since it can be just done with a simple script, if I wanted to. I just wanted to create this project to know how far I can push myself to do a _real_ project, which involves developing AND distributing a python project. Hope I live up to this.
I think I’ll write more about this later.
# Installation :rocket:
Install [python](https://www.python.org/downloads/). You can this step if you already have python installed.
Open Command Prompt / Terminal, and execute
`sh $ pip install gateoverflow `
Done! Now you can use this tool by opening a Command Prompt / Terminal and running
`sh $ gateoverflow `
# Requirements :hammer_and_wrench:
Don’t worry about this unless you are going to develop.
python >= 3.6
sqlite3
python-dateutil
requests
tabulate
toml
twine
# Changelog :pencil:
### v0.4.0
Added support for user defined configuration file, uses config.toml for it.
The program now has it’s own project_home directory.
Added a user table, which stores meta information about the database.
Introduced colors for the text with ANSI escape characters
Bugfixes, refactor and gucci.
### v0.3.1
listing recents shows title and description of the question now.
delete possibly invalid questions
Parser barely works, as specified in [link](###parser-commands)
Major refactor, queries and debug-outputs.
debug mode.
Available on PyPI now. Yay!
### v0.2.0
updated makefile to have a build target
changed behaviour of ls command. Now it only lists recents
refactor, and removing unnecessary code
Read [full changelog](./changelog.md)
# Usage :fire:
### Parser Commands
According to [this](https://github.com/toxdes/opengate/issues/4#issuecomment-612046118) comment, it is just convinient to use the commands as following.
If the input command is a list of comma/space separated integers, they are treated as question ids, and will be opened in the browser.
If the input command is # or tags, all created tags are listed.
If input command is mix of tags and question ids, then all of the questions are added to respective tags. If some of the mentioned tags do not exist, then the user is interactively prompted to create them.
If input command only contains tags, then list of questions with repective tags are shown.
### Commands
### Usage Examples
Suppose the link to the question is https://gateoverflow.in/6969, then the question ID in this case is 6969, wherever the word Question ID is mentioned in this context.
2345,2323,4344, #important - would add questions 2345,2323,4344 to #important.
#wrongly-attempted - would list the questions in #wrongly-attempted, sorted with mostly visited.
tags would list all the available tags. #recent would be a default tag, which would store all opened questions.
Questions could even be added to multiple tags at the same time by doing something like 2424,23232,3234, #important, #good, #hard to add those questions to specified tags.
create would create a new tag. E.g. create #not-so-cool to create a tag named not-so-cool.
# Future :sleepy:
I’m planning to add the following features, assuming I overcome the biggest challenge of not abandoning this.
usage of arrow keys to select, make UX amazing.
a “sync” mechanism that will be used to upload the db file to web, and will be shared across somehow.
create a gui maybe a web app that starts a http browser locally and opens a link in browser, like expo does?
maybe firebase
add gifs of usage
allow users to have a configuration file that allows them to change defaults e.g. shell-prefix-symbol etc.
A documentation site.
Travis CI?
Currently PIP works, but create some standalone OS-specific releases?
# Release Checklist :pencil2:
Does it work?
Are changes merged with master?
Is changelog.md updated with changes?
Is README.md updated with changes?
Is Table Of Contents updated, if it is changed, which can be generated from here?
Am I on master branch right now?
make build succeeds without an error?
Cool.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for gateoverflow-0.4.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7152d55612b0579fca30155135c23e7a534ae83e95e02fba91781dcf2def226a |
|
MD5 | b82c51ee548794a1bcc8413ccb9861f6 |
|
BLAKE2b-256 | 832e89d91d151710081f4b61ba9658d8992f7713902a84884aa46bb7d5298d34 |