jenkins-bot has submitted this change and it was merged. ( 
https://gerrit.wikimedia.org/r/365268 )

Change subject: Update pypi description
......................................................................


Update pypi description

README.rst does not contain a valid desciption for pypi because it also
contains root files and scripts but these files aren't shipped with the
pypi package. Use a new file "pypi_description.rst" for it.

Change-Id: I1b536ef30ce772124e0ae52472e5848b0e28867b
---
A pypi_description.rst
M setup.py
2 files changed, 90 insertions(+), 1 deletion(-)

Approvals:
  Merlijn van Deen: Looks good to me, approved
  jenkins-bot: Verified



diff --git a/pypi_description.rst b/pypi_description.rst
new file mode 100644
index 0000000..25af392
--- /dev/null
+++ b/pypi_description.rst
@@ -0,0 +1,89 @@
+Pywikibot
+=========
+
+The Pywikibot framework is a Python library that interfaces with the
+`MediaWiki API 
<https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page>`_
+version 1.14 or higher.
+
+Also included are various general function scripts that can be adapted for
+different tasks.
+
+For further information about the library excluding scripts see
+the full `code documentation <https://doc.wikimedia.org/pywikibot/>`_.
+
+Quick start
+-----------
+
+::
+
+    git clone https://gerrit.wikimedia.org/r/pywikibot/core.git
+    cd core
+    git submodule update --init
+    python pwb.py script_name
+
+Or to install using PyPI (excluding scripts)
+::
+
+    pip install pywikibot --pre
+
+Our `installation
+guide 
<https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Pywikibot/Installation>`_
+has more details for advanced usage.
+
+Basic Usage
+-----------
+
+If you wish to write your own script it's very easy to get started:
+
+::
+
+    import pywikibot
+    site = pywikibot.Site('en', 'wikipedia')  # The site we want to run our 
bot on
+    page = pywikibot.Page(site, 'Wikipedia:Sandbox')
+    page.text = page.text.replace('foo', 'bar')
+    page.save('Replacing "foo" with "bar"')  # Saves the page
+
+-------------------------------------------------------------------------------------------
+
+For more documentation on pywikibot see our `docs 
<https://doc.wikimedia.org/pywikibot/>`_.
+
+
+The contents of the package
+----------------------------
+
+    
+----------------------------------------------------------------------------------+
+    |  Directories                                                             
        |
+    
+===========================+======================================================+
+    |  pywikibot                | Library routines, control files and global 
settings  |
+    
+---------------------------+------------------------------------------------------+
+    |  pywikibot/comms          | Communication layer                          
        |
+    
+---------------------------+------------------------------------------------------+
+    |  pywikibot/compat         | Package to provide compatibility with compat 
scripts |
+    
+---------------------------+------------------------------------------------------+
+    |  pywikibot/data           | Module with several layers for data access 
to wiki   |
+    
+---------------------------+------------------------------------------------------+
+    |  pywikibot/families       | wiki-specific information and settings       
        |
+    
+---------------------------+------------------------------------------------------+
+    |  pywikibot/tools          | Miscellaneous helper functions (not 
wiki-dependent)  |
+    
+---------------------------+------------------------------------------------------+
+    |  pywikibot/userinterfaces | GUI and terminal interface                   
        |
+    
+---------------------------+------------------------------------------------------+
+
+
+Required external programs
+---------------------------
+
+It may require the following programs to function properly:
+
+* `7za`: To extract 7z files
+
+Contributing
+------------
+
+Our code is maintained on Wikimedia's `Gerrit installation 
<https://gerrit.wikimedia.org/>`_,
+`learn <https://www.mediawiki.org/wiki/Special:MyLanguage/Developer_access>`_ 
how to get
+started.
+
+.. image:: 
https://secure.travis-ci.org/wikimedia/pywikibot-core.png?branch=master
+   :alt: Build Status
+   :target: https://travis-ci.org/wikimedia/pywikibot-core
diff --git a/setup.py b/setup.py
index 015a817..d78a7e2 100644
--- a/setup.py
+++ b/setup.py
@@ -208,7 +208,7 @@
     name=name,
     version=version,
     description='Python MediaWiki Bot Framework',
-    long_description=open('README.rst').read(),
+    long_description=open('pypi_description.rst').read(),
     keywords=('pywikibot', 'python', 'mediawiki', 'bot', 'wiki', 'framework',
               'wikimedia', 'wikipedia', 'pwb', 'pywikipedia', 'API'),
     maintainer='The Pywikibot team',

-- 
To view, visit https://gerrit.wikimedia.org/r/365268
To unsubscribe, visit https://gerrit.wikimedia.org/r/settings

Gerrit-MessageType: merged
Gerrit-Change-Id: I1b536ef30ce772124e0ae52472e5848b0e28867b
Gerrit-PatchSet: 3
Gerrit-Project: pywikibot/core
Gerrit-Branch: master
Gerrit-Owner: Xqt <i...@gno.de>
Gerrit-Reviewer: John Vandenberg <jay...@gmail.com>
Gerrit-Reviewer: Magul <tomasz.magul...@gmail.com>
Gerrit-Reviewer: Merlijn van Deen <valhall...@arctus.nl>
Gerrit-Reviewer: jenkins-bot <>

_______________________________________________
Pywikibot-commits mailing list
Pywikibot-commits@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/pywikibot-commits

Reply via email to