Bladeren bron

Markdown -> reStructuredText

tags/v0.1^2
Ben Kurtovic 12 jaren geleden
bovenliggende
commit
b20b6ba092
2 gewijzigde bestanden met toevoegingen van 90 en 69 verwijderingen
  1. +0
    -69
      README.md
  2. +90
    -0
      README.rst

+ 0
- 69
README.md Bestand weergeven

@@ -1,69 +0,0 @@
[EarwigBot](http://en.wikipedia.org/wiki/User:EarwigBot) is a
[Python](http://python.org/) robot that edits
[Wikipedia](http://en.wikipedia.org/) and interacts with people over
[IRC](http://en.wikipedia.org/wiki/Internet_Relay_Chat).

# History

Development began, based on the
[Pywikipedia framework](http://pywikipediabot.sourceforge.net/), in early 2009.
Approval for its fist task, a
[copyright violation detector](http://en.wikipedia.org/wiki/Wikipedia:Bots/Requests_for_approval/EarwigBot_1),
was carried out in May, and the bot has been running consistently ever since
(with the exception of Jan/Feb 2011). It currently handles
[several ongoing tasks](http://en.wikipedia.org/wiki/User:EarwigBot#Tasks),
ranging from statistics generation to category cleanup, and on-demand tasks
such as WikiProject template tagging. Since it started running, the bot has
made over 50,000 edits.

A project to rewrite it from scratch began in early April 2011, thus moving
away from the Pywikipedia framework and allowing for less overall code, better
integration between bot parts, and easier maintenance.

# Installation

This package contains the core `earwigbot`, abstracted enough that it should be
usable and customizable by anyone running a bot on a MediaWiki site. Since it's
component-based, the IRC components can be disabled if desired. IRC commands
and bot tasks specific to
[my instance of EarwigBot](http://en.wikipedia.org/wiki/User:EarwigBot) are
available from the package
[earwigbot-plugins](https://github.com/earwig/earwigbot-plugins).

## Latest release (v0.1)

EarwigBot is available from the [Python Package Index](http://pypi.python.org),
so you can install the latest release with `pip install earwigbot`
([get pip](http://pypi.python.org/pypi/pip)).

You can also install it from source directly:

curl -Lo earwigbot.tgz "https://github.com/earwig/earwigbot/tarball/v0.1"
tar -xf earwigbot.tgz
cd earwig-earwigbot-*
python setup.py install # may require root, or use --user switch to install locally
cd ..
rm -r earwigbot.tgz earwig-earwigbot-*

## Development version

You can install the development version of the bot from `git`, probably on the
`develop` branch which contains (usually) working code. `master` contains the
latest release. EarwigBot uses
[git flow](http://nvie.com/posts/a-successful-git-branching-model/), so you're
free to browse by tags or by new features (`feature/*` branches).

git clone git://github.com/earwig/earwigbot.git earwigbot
cd earwigbot
python setup.py develop # may require root, or use --user switch to install locally

# Setup

It's recommended to run the bot's unit tests before installing. Run
`python -m unittest discover tests` from the project's root directory.

*Note:* some unit tests require an internet connection.

# Customizing

# Hacking

+ 90
- 0
README.rst Bestand weergeven

@@ -0,0 +1,90 @@
EarwigBot
=========

EarwigBot_ is a Python_ robot that edits Wikipedia_ and interacts with people
over IRC_.

History
-------

Development began, based on the `Pywikipedia framework`_, in early 2009.
Approval for its fist task, a `copyright violation detector`_, was carried out
in May, and the bot has been running consistently ever since (with the
exception of Jan/Feb 2011). It currently handles `several ongoing tasks`_
ranging from statistics generation to category cleanup, and on-demand tasks
such as WikiProject template tagging. Since it started running, the bot has
made over 50,000 edits.

A project to rewrite it from scratch began in early April 2011, thus moving
away from the Pywikipedia framework and allowing for less overall code, better
integration between bot parts, and easier maintenance.

Installation
------------

This package contains the core ``earwigbot``, abstracted enough that it should
be usable and customizable by anyone running a bot on a MediaWiki site. Since
it is component-based, the IRC components can be disabled if desired. IRC
commands and bot tasks specific to `my instance of EarwigBot`_ are available
from the package `earwigbot-plugins`_.

Latest release (v0.1)
~~~~~~~~~~~~~~~~~~~~~

EarwigBot is available from the `Python Package Index`_, so you can install the
latest release with ``pip install earwigbot`` (`get pip`_).

You can also install it from source [1]_ directly::

curl -Lo earwigbot.tgz "https://github.com/earwig/earwigbot/tarball/v0.1"
tar -xf earwigbot.tgz
cd earwig-earwigbot-*
python setup.py install
cd ..
rm -r earwigbot.tgz earwig-earwigbot-*

Development version
~~~~~~~~~~~~~~~~~~~

You can install the development version of the bot from ``git`` by using
setuptools/distribute's ``develop`` command [1]_, probably on the ``develop``
branch which contains (usually) working code. ``master`` contains the latest
release. EarwigBot uses `git flow`_, so you're free to
browse by tags or by new features (``feature/*`` branches)::

git clone git://github.com/earwig/earwigbot.git earwigbot
cd earwigbot
python setup.py develop

Setup
-----

It's recommended to run the bot's unit tests before installing. Run
``python setup.py test`` from the project's root directory.

*Note:* some unit tests require an internet connection.

Customizing
-----------

Hacking
-------

Footnotes
---------

.. _EarwigBot: http://en.wikipedia.org/wiki/User:EarwigBot
.. _Python: http://python.org/
.. _Wikipedia: http://en.wikipedia.org/
.. _IRC: http://en.wikipedia.org/wiki/Internet_Relay_Chat
.. _Pywikipedia framework: http://pywikipediabot.sourceforge.net/
.. _copyright violation detector: http://en.wikipedia.org/wiki/Wikipedia:Bots/Requests_for_approval/EarwigBot_1
.. _several ongoing tasks: http://en.wikipedia.org/wiki/User:EarwigBot#Tasks
.. _my instance of EarwigBot: http://en.wikipedia.org/wiki/User:EarwigBot
.. _earwigbot-plugins: https://github.com/earwig/earwigbot-plugins
.. _Python Package Index: http://pypi.python.org
.. _get pip: http://pypi.python.org/pypi/pip
.. _git flow: http://nvie.com/posts/a-successful-git-branching-model/

.. [1] ``python setup.py install``/``develop`` may require root, or use the
``--user`` switch to install for the current user only

Laden…
Annuleren
Opslaan