Skip to content

Commit 89ff101

Browse files
committed
bump to a stable version 1.0.0, fixed typos
1 parent 0bafe5c commit 89ff101

File tree

5 files changed

+51
-44
lines changed

5 files changed

+51
-44
lines changed

README.rst

+25-18
Original file line numberDiff line numberDiff line change
@@ -11,23 +11,30 @@ Python wrapper for ``GitHub's Gist API``.
1111
.. |Downloads| image:: https://pypip.in/d/simplegist/badge.png
1212
:target: https://pypi.python.org/pypi//simplegist/
1313

14+
|Latest Version| |Downloads|
15+
16+
.. |Latest Version| image:: https://img.shields.io/pypi/v/simplegist.svg
17+
:target: https://pypi.python.org/pypi/simplegist
18+
19+
.. |Downloads| image:: https://img.shields.io/pypi/dm/simplegist.svg
20+
:target: https://pypi.python.org/pypi/simplegist
1421

1522
Features
1623
--------
1724

18-
* Creating gists returning the url, script and clone link for copy-paste purpose
19-
* Checkout one's gists - Name(s), Description and Content
25+
* Create Gists and get url, script and clone link on success (can be used for copy-paste purpose too)
26+
* View one's Gist(s) - name, description and it's content
2027
* Edit and Delete a gist
21-
* Search GitHub user's gist - fork, star and unstar them
22-
* List-all comments of any gist, make/edit a comment on a gist, delete a comment
28+
* Search Gist(s) of any user; fork, star and unstar them
29+
* List all comments on any Gist, put/edit/delete a comment on a Gist
2330

2431
Installation
2532
-------------
2633
.. code-block:: bash
2734
2835
$ pip install simplegist
2936
30-
Download `here <https://github.com/softvar/simplegist/tarball/0.3.2>`_ and run ``python setup.py install`` after changing directory to ``/simplegist``
37+
Download `here <https://github.com/softvar/simplegist/tarball/1.0.0>`_ and run ``python setup.py install`` after changing directory to ``/simplegist``
3138

3239
Generating Github API Access Token
3340
----------------------------------
@@ -41,20 +48,20 @@ Example Usage
4148
4249
from simplegist import SimpleGist
4350
44-
GHgist = Simplegist(username='USERNAME',api_token='API_TOKEN')
45-
# or provide USERNAME and API_TOKEN in config.py file, so just, GHgist = Gist()
51+
ghGist = Simplegist(username='USERNAME', api_token='API_TOKEN')
52+
# or provide USERNAME and API_TOKEN in config.py file, so just, ghGist = Gist()
53+
54+
# creating gist and getting url, script and clone link
55+
ghGist.create(name='_GISTNAME', description='_ANY_DESCRIPTION', public=1, content='_CONTENT_GOES_HERE')
4656
47-
# creating gist and returning url, script, clone link
48-
GHgist.create(name='_GISTNAME', description='_ANY_DESCRIPTION', public=1, content='_CONTENT_GOES_HERE')
57+
# List down all the names of authenticated user's Gists
58+
ghGist.profile().listall()
4959
50-
# Lists all the names of authenticated user's gists
51-
GHgist.profile().listall()
60+
# List down only the names of recent two Gists of user '_USERNAME'
61+
ghGist.search('_USERNAME').list(2)
5262
53-
# Lists only the names of recent two gists of user '_USERNAME'
54-
GHgist.search('_USERNAME').list(2)
55-
56-
# Lists all the comments on gist named '_GISTNAME' of user 'USERNAME'
57-
GHgist.comments().listall(user='_USERNAME',name='_GISTNAME')
63+
# List down all the comments on gist named '_GISTNAME' of user 'USERNAME'
64+
ghGist.comments().listall(user='_USERNAME', name='_GISTNAME')
5865
5966
# ...and many more...
6067
@@ -63,8 +70,8 @@ Full Usage and Documentation
6370

6471
Visit here `READTHEDOCS <https://simplegist.readthedocs.org/en/latest/>`_ or `PYTHONHOSTED <http://pythonhosted.org/simplegist/>`_
6572

66-
Patches and suggestions are welcomed
67-
------------------------------------
73+
Patches and suggestions are welcome
74+
-----------------------------------
6875

6976
.. code-block:: bash
7077

docs/index.rst

+7-7
Original file line numberDiff line numberDiff line change
@@ -14,15 +14,15 @@ Features
1414
* Checkout one's gists - Name(s), Description and Content
1515
* Edit and Delete a gist
1616
* Search GitHub user's gist - fork, star and unstar them
17-
* List comments of any gist, make/edit a comment on a gist, delete a comment
17+
* List comments of any gist, make/edit a comment on a gist, delete a comment
1818

1919
Installation
2020
------------
2121
.. code-block:: bash
2222
2323
$ pip install simplegist
2424
25-
Or download it from `here <https://github.com/softvar/GistApi-Wrapper-python/tarball/0.3.2>`_ and then,
25+
Or download it from `here <https://github.com/softvar/GistApi-Wrapper-python/tarball/1.0.0>`_ and then,
2626

2727
.. code-block:: bash
2828
@@ -44,7 +44,7 @@ Creating an Instance
4444
GHgist = Simplegist(username='USERNAME',api_token='API_TOKEN')
4545
4646
# else
47-
GHgist = Simplegist()
47+
GHgist = Simplegist()
4848
4949
Example Usage
5050
-------------
@@ -56,17 +56,17 @@ Below is an example to getting started with using GistAPI and its useful functio
5656
from simplegist import SimpleGist
5757
5858
# provide USERNAME and API_TOKEN in config.py file, so just, GHgist = Gist(), OR,
59-
GHgist = Simplegist(username='USERNAME',api_token='API_TOKEN')
59+
GHgist = Simplegist(username='USERNAME',api_token='API_TOKEN')
6060
6161
# creating gist and returning url, script, clone link
62-
GHgist.create(name='_GISTNAME', description='_ANY_DESCRIPTION', public=1, content='_CONTENT_GOES_HERE')
62+
GHgist.create(name='_GISTNAME', description='_ANY_DESCRIPTION', public=1, content='_CONTENT_GOES_HERE')
6363
6464
# Lists all the names of authenticated user's gists
6565
GHgist.profile().listall()
6666
67-
# Lists only the names of recent two gists of user '_USERNAME'
67+
# Lists only the names of recent two gists of user '_USERNAME'
6868
GHgist.search('_USERNAME').list(2)
69-
69+
7070
# Lists all the comments on gist named '_GISTNAME' of user '_USERNAME'
7171
GHgist.comments().listall(user='_USERNAME',name='_GISTNAME')
7272

docs/manage.rst

+7-7
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ Managing authenticated user's gists
33

44
.. warning::
55

6-
user must be authenticated
6+
user must be authenticated
77

88

99
Listing all the Gists ``profile().listall()``
@@ -19,7 +19,7 @@ Fetch all the GistsNames.
1919
2020
GHgist.profile().listall()
2121
22-
Listing the required number of Gists ``profile().list(integar)``
22+
Listing the required number of Gists ``profile().list(integer)``
2323
----------------------------------------------------------------
2424

2525
Fetch only the limited number of Gists ``list(4)``.
@@ -28,8 +28,8 @@ Fetch only the limited number of Gists ``list(4)``.
2828

2929
Input
3030

31-
integar
32-
``integar`` is **required** as an argument which will limit the number of Gists to be listed.
31+
integer
32+
``integer`` is **required** as an argument which will limit the number of Gists to be listed.
3333

3434
.. code-block:: python
3535
@@ -58,7 +58,7 @@ Fetch Gist-Link, Clone-Link and Embed-Script-Link of your gist ``profile().links
5858
5959
GHgist.profile('YOURUSERNAME').links(id='_GISTID')
6060
GHgist.profile('YOURUSERNAME').links(name='_GISTNAME')
61-
61+
6262
Fetching the contents of a Gist ``profile().content(params)``
6363
-------------------------------------------------------------
6464

@@ -67,7 +67,7 @@ Fetch the contents of a Gist by name (GISTNAME) ``content(name='_GISTNAME')``.
6767
.. code-block:: python
6868
6969
GHgist.profile().content(name='_GISTNAME')
70-
70+
7171
Fetch by id (GISTID)
7272

7373
.. code-block:: python
@@ -126,7 +126,7 @@ Edit a Gist by providing either GistName or GistID, and content.
126126
GHgist.profile().edit(description='_NEW_DESCRIPTION',name='_GISTNAME',content='_UPDATED_CONETNT_GOES_HERE')
127127
128128
# with required arguments
129-
GHgist.profile().edit(id='_GISTID',content='_UPDATED_CONTENT_GOES_HERE')
129+
GHgist.profile().edit(id='_GISTID',content='_UPDATED_CONTENT_GOES_HERE')
130130
131131
Getting a GistName using GistID ``profile().getMyID(params)``
132132
-------------------------------------------------------------

docs/searching.rst

+7-7
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Fetch all the GistsNames of a Github User.
1414
1515
GHgist.search('_USERNAME').listall()
1616
17-
Listing the required number of Gists ``search('_USERNAME').list(integar)``
17+
Listing the required number of Gists ``search('_USERNAME').list(integer)``
1818
--------------------------------------------------------------------------
1919

2020
Fetch only the limited number of Gists.
@@ -23,13 +23,13 @@ Fetch only the limited number of Gists.
2323

2424
Input
2525

26-
integar
27-
``integar`` is **required** as an argument which will limit the number of Gists to be listed.
26+
integer
27+
``integer`` is **required** as an argument which will limit the number of Gists to be listed.
2828

2929
.. code-block:: python
3030
3131
GHgist.search('_USERNAME').list(2)
32-
32+
3333
Fetching the contents of a Gist using GistName ``search('_USERNAME').content(params)``
3434
--------------------------------------------------------------------------------------
3535

@@ -38,7 +38,7 @@ Fetch the contents of a Gist by name (GistName).
3838
.. code-block:: python
3939
4040
GHgist.search('_USERNAME').content(name='_GISTNAME')
41-
41+
4242
Fetching the contents of any Gist using GistID ``search('').content(id='_GISTID')``
4343
-----------------------------------------------------------------------------------
4444

@@ -60,15 +60,15 @@ Fetch Gist's name by provoding it's ID i.e. GistID.
6060
Fetch Gist-Link, Clone-Link and Embed-Script-Link of searched gist ``search('_USERNAME/EMPTY').links(id/name)``
6161
------------------------------------------------------------------------------------------------------------------------------
6262

63-
It is very very useful and solves the dual purpose. Providing the username and a Gistname of that user not only provides the above mentioned Links but also let 'one' know about the GistID of that Gist.
63+
It is very very useful and solves the dual purpose. Providing the username and a Gistname of that user not only provides the above mentioned Links but also let 'one' know about the GistID of that Gist.
6464

6565
Moreover, this criteria can also be applied in finding 'one\'s' own Gist's GistID by providing Gistname.
6666

6767
.. note::
6868

6969
Input
7070

71-
``name/id`` -
71+
``name/id`` -
7272
if providing GistdID, Github-Username should be blank like search(''),links(id='_GISTID')
7373
if providing GistName, Github-Username is required like search('Github-User').links(name='THATUSERSGISTNAME')
7474

setup.py

+5-5
Original file line numberDiff line numberDiff line change
@@ -10,17 +10,17 @@
1010

1111
setup(
1212
name = 'simplegist',
13-
packages = ['simplegist'],
14-
version = '0.3.2',
13+
packages = ['simplegist'],
14+
version = '1.0.0',
1515
install_requires=required,
1616
description = 'Python wrapper for Gist ',
1717
long_description=open('README.rst').read(),
1818
author = 'Varun Malhotra',
1919
author_email = '[email protected]',
20-
url = 'https://github.com/softvar/GistApi-Wrapper-python',
21-
download_url = 'https://github.com/softvar/GistApi-Wrapper-python/tarball/0.3.2',
20+
url = 'https://github.com/softvar/GistApi-Wrapper-python',
21+
download_url = 'https://github.com/softvar/GistApi-Wrapper-python/tarball/1.0.0',
2222
keywords = ['gist', 'github', 'API'],
23-
license = 'MIT',
23+
license = 'MIT',
2424
classifiers = (
2525
"Programming Language :: Python",
2626
"Programming Language :: Python :: 2.5",

0 commit comments

Comments
 (0)