Skip to content

Commit 82bed61

Browse files
committed
Update with new features to the readme doc
Signed-off-by: Ganesh Hubale <[email protected]>
1 parent 7fa7cf1 commit 82bed61

File tree

2 files changed

+50
-55
lines changed

2 files changed

+50
-55
lines changed

README.rst

Lines changed: 49 additions & 54 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ Readit - Command Line Tool
88

99

1010
.. image:: https://asciinema.org/a/XHY1hKrgOry69OeWG04iucT1k.png
11-
:alt: asciicast
12-
:scale: 50%
13-
:target: https://asciinema.org/a/XHY1hKrgOry69OeWG04iucT1k?t=1
11+
:alt: asciicast
12+
:scale: 50%
13+
:target: https://asciinema.org/a/XHY1hKrgOry69OeWG04iucT1k?t=1
1414

1515

1616
Introduction
@@ -21,23 +21,23 @@ Readit is command line bookmark manager. It is a command line utility to add, de
2121
Features
2222
********
2323
* Bookmark multiple URLs at a time
24-
* Bookmark URL with respective Tags
24+
* Bookmark url with respective Tags at the same time
2525
* Search and display Bookmarks by TAG and URL's substring
2626
* Display all Bookmarks in table format
2727
* Remove a Bookmarked URL
2828
* Remove all Bookmarked URLs
2929
* Update a Bookmarked URL with a specific ID
3030
* URL validation
3131
* Open URL in the browser
32-
* Export bookmarks into the CSV file
32+
* Choose specific folder and Export bookmarks into the CSV file
3333
* Show all Tags available in the database
3434
* Bookmark URLs either online or offline
3535

3636

3737
Dependencies
3838
************
3939
============================================= ==================
40-
Features Dependancy
40+
Features Dependancy
4141
============================================= ==================
4242
``Scripting Language`` Python 3.0+
4343
``HTTP(S)`` requests
@@ -48,7 +48,7 @@ Dependencies
4848

4949
Installation
5050
************
51-
readit is available on PyPI and can be installed with pip3:
51+
Readit is available on PyPI and can be installed with pip3:
5252

5353
.. code-block:: bash
5454
@@ -60,20 +60,23 @@ Command line options
6060
6161
Usage: readit [OPTIONS] [INSERT]...
6262
63-
Readit - Command-line bookmark manager tool.
64-
63+
Readit - Command-line bookmark manager tool.
6564
Options:
66-
-a, --add TEXT... Add URLs with space-separated
67-
-t, --tag TEXT... Add Tag with space-separated URL
68-
-d, --delete TEXT Remove a URL of particular ID
69-
-c, --clear TEXT... Clear bookmarks
70-
-u, --update TEXT... Update a URL for specific ID
71-
-s, --search TEXT Search all bookmarks by Tag and URL's substring
72-
-v, --view TEXT... Show bookmarks
73-
-o, --openurl TEXT Open URL in Browser using id, tag or URL's substring
74-
-V, --version Check latest version
75-
-e, --export TEXT... Export URLs in csv file
76-
-tl, --taglist TEXT... Show all Tags
65+
-a, --add TEXT Add urls --> readit -a <url1> <url2>
66+
-t, --tag TEXT Use to tag url --> readit -a <url1> -t <tag1>
67+
-d, --delete TEXT Remove a URL of particular ID --> readit -d <url_id>
68+
-c, --clear TEXT Clear bookmarks --> readit -c
69+
-u, --update TEXT Update a URL for specific ID --> readit -u
70+
<existing_id> <new_url>
71+
-s, --search TEXT Search for bookmarks using either a tag or a
72+
substring of the URL --> readit -s <tag> or
73+
<substring>
74+
-v, --view TEXT... Show bookmarks --> readit -v
75+
-o, --openurl TEXT Open a URL in your browser by entering a part of the
76+
URL. --> readit -o <url_substring>
77+
-V, --version Check latest version --> readit -V
78+
-e, --export TEXT... Export URLs in csv file --> readit -e
79+
-tl, --taglist TEXT... Show all Tags --> readit -tl
7780
--help Show this message and exit.
7881
7982
@@ -83,11 +86,17 @@ Examples
8386

8487
.. code-block:: bash
8588
86-
$ readit url1 url2 ...
89+
$ readit <url1> <url2> ...
8790
or
88-
$ readit --add url1 url2 ...
91+
$ readit --add <url1> <url2> ...
8992
or
90-
$ readit -a url1 url2 ...
93+
$ readit -a <url1> <url2> ...
94+
95+
2. **Bookmark** urls and tags at the same time
96+
97+
.. code-block:: bash
98+
99+
$ readit -a <url1> -t <tag1>
91100
92101
2. **View** all available bookmarks:
93102

@@ -101,17 +110,17 @@ Examples
101110

102111
.. code-block:: bash
103112
104-
$ readit -u url_id url
113+
$ readit -u <url_id> <url>
105114
or
106-
$ readit --update url_id url
115+
$ readit --update <url_id> <url>
107116
108117
4. **Delete** a bookmarked URL using its ID:
109118

110119
.. code-block:: bash
111120
112-
$ readit -d url_id
121+
$ readit -d <url_id>
113122
or
114-
$ readit --delete url_id
123+
$ readit --delete <url_id>
115124
116125
5. **Clear** all the bookmarks:
117126

@@ -121,51 +130,37 @@ Examples
121130
or
122131
$ readit --clear
123132
124-
6. **Bookmark** URL along with TAG:
133+
6. **Search** and **Display** all bookmarks using the TAG or URL's substring:
125134

126135
.. code-block:: bash
127136
128-
$ readit -t tag_name url
137+
$ readit -s <tag_name> or <url_substring>
129138
or
130-
$ readit --tag tag_name url
139+
$ readit --search <tag_name> or <url_substring>
131140
132-
7. **Search** and **Display** all bookmarks using the TAG or URL's substring:
141+
7. Open URL in the Browser using URL's substring:
133142

134143
.. code-block:: bash
135144
136-
$ readit -s tag_name
137-
or
138-
$ readit --search tag_name
145+
$ readit -o <url_substring>
139146
or
140-
$ readit -s url_substring
147+
$ readit --openurl <url_substring>
141148
142-
8. Open URL in the Browser using specific ID, TAG or URL's substring:
149+
8. **Export** bookmarks into the CSV file:
143150

144151
.. code-block:: bash
145152
146-
$ readit -o urlid
147-
or
148-
$ readit --openurl urlid
153+
$ readit --export
149154
or
150-
$ readit -o url_substring
151-
or
152-
$ readit -o tag
153-
154-
9. **Export** bookmarks into the CSV file:
155-
156-
.. code-block:: bash
157-
158-
$ readit --export
159-
or
160-
$ readit -e
155+
$ readit -e
161156
162-
10. Show all Tags available in the database
157+
9. Show all Tags available in the database
163158

164159
.. code-block:: bash
165160
166-
$ readit -tl
167-
or
168-
$ readit --taglist
161+
$ readit -tl
162+
or
163+
$ readit --taglist
169164
170165
How to install source code for development
171166
**********************************************

readit/cli.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@
3434
@click.option("--search", "-s", help="Search for bookmarks using either a tag or a substring of the URL --> readit -s <tag> or <substring>")
3535
@click.option("--view", "-v", multiple=True, nargs=0, help="Show bookmarks --> readit -v")
3636
@click.option("--openurl", "-o", help="Open a URL in your browser by entering a part of the URL. --> readit -o <url_substring>")
37-
@click.option("--version", "-V", is_flag=True, help="Check latest version --> readit readit -V")
37+
@click.option("--version", "-V", is_flag=True, help="Check latest version --> readit -V")
3838
@click.option("--export", "-e", multiple=True, nargs=0, help="Export URLs in csv file --> readit -e")
3939
@click.option("--taglist", "-tl", multiple=True, nargs=0, help="Show all Tags --> readit -tl")
4040
@click.argument("insert", nargs=-1, required=False)

0 commit comments

Comments
 (0)