Skip to content

Commit 769346b

Browse files
committed
Switched docs to md
1 parent 46ec628 commit 769346b

9 files changed

Lines changed: 71 additions & 89 deletions

File tree

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,9 @@
1-
=======
2-
Credits
3-
=======
1+
# Credits
42

5-
Development Lead
6-
----------------
3+
## Development Lead
74

85
* Lucas Lobosque <[email protected]>
96

10-
Contributors
11-
------------
7+
## Contributors
128

139
None yet. Why not be the first?
Lines changed: 24 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,13 @@
1-
.. highlight:: shell
2-
3-
============
4-
Contributing
5-
============
1+
# Contributing
62

73
Contributions are welcome, and they are greatly appreciated! Every
84
little bit helps, and credit will always be given.
95

106
You can contribute in many ways:
117

12-
Types of Contributions
13-
----------------------
8+
## Types of Contributions
149

15-
Report Bugs
16-
~~~~~~~~~~~
10+
### Report Bugs
1711

1812
Report bugs at https://github.com/Lobosque/python_wpapi/issues.
1913

@@ -23,27 +17,23 @@ If you are reporting a bug, please include:
2317
* Any details about your local setup that might be helpful in troubleshooting.
2418
* Detailed steps to reproduce the bug.
2519

26-
Fix Bugs
27-
~~~~~~~~
20+
### Fix Bugs
2821

2922
Look through the GitHub issues for bugs. Anything tagged with "bug"
3023
and "help wanted" is open to whoever wants to implement it.
3124

32-
Implement Features
33-
~~~~~~~~~~~~~~~~~~
25+
### Implement Features
3426

3527
Look through the GitHub issues for features. Anything tagged with "enhancement"
3628
and "help wanted" is open to whoever wants to implement it.
3729

38-
Write Documentation
39-
~~~~~~~~~~~~~~~~~~~
30+
### Write Documentation
4031

4132
Python Wordpress API could always use more documentation, whether as part of the
4233
official Python Wordpress API docs, in docstrings, or even on the web in blog posts,
4334
articles, and such.
4435

45-
Submit Feedback
46-
~~~~~~~~~~~~~~~
36+
### Submit Feedback
4737

4838
The best way to send feedback is to file an issue at https://github.com/Lobosque/python_wpapi/issues.
4939

@@ -54,46 +44,54 @@ If you are proposing a feature:
5444
* Remember that this is a volunteer-driven project, and that contributions
5545
are welcome :)
5646

57-
Get Started!
58-
------------
47+
## Get Started!
5948

6049
Ready to contribute? Here's how to set up `python_wpapi` for local development.
6150

6251
1. Fork the `python_wpapi` repo on GitHub.
63-
2. Clone your fork locally::
52+
2. Clone your fork locally:
6453

54+
```
6555
$ git clone [email protected]:your_name_here/python_wpapi.git
56+
```
6657
6758
3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development::
6859
60+
```
6961
$ mkvirtualenv python_wpapi
7062
$ cd python_wpapi/
7163
$ python setup.py develop
64+
```
7265
7366
4. Create a branch for local development::
7467
68+
```
7569
$ git checkout -b name-of-your-bugfix-or-feature
70+
```
7671
7772
Now you can make your changes locally.
7873
7974
5. When you're done making changes, check that your changes pass flake8 and the tests, including testing other Python versions with tox::
8075
76+
```
8177
$ flake8 python_wpapi tests
8278
$ python setup.py test or py.test
8379
$ tox
80+
```
8481
8582
To get flake8 and tox, just pip install them into your virtualenv.
8683
8784
6. Commit your changes and push your branch to GitHub::
8885
86+
```
8987
$ git add .
9088
$ git commit -m "Your detailed description of your changes."
9189
$ git push origin name-of-your-bugfix-or-feature
90+
```
9291
9392
7. Submit a pull request through the GitHub website.
9493
95-
Pull Request Guidelines
96-
-----------------------
94+
### Pull Request Guidelines
9795
9896
Before you submit a pull request, check that it meets these guidelines:
9997
@@ -105,10 +103,10 @@ Before you submit a pull request, check that it meets these guidelines:
105103
https://travis-ci.org/Lobosque/python_wpapi/pull_requests
106104
and make sure that the tests pass for all supported Python versions.
107105
108-
Tips
109-
----
110-
111-
To run a subset of tests::
106+
## Tips
112107
108+
To run a subset of tests:
113109
110+
```
114111
$ python -m unittest tests.test_python_wpapi
112+
```

HISTORY.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
# History
2+
3+
## 0.2.1 (2016-11-16)
4+
5+
* Converted rst to markdown.
6+
7+
## 0.2.0 (2016-11-16)
8+
9+
* Added test suite.
10+
* Fixed bugs with api exception raising.
11+
12+
## 0.1.0 (2016-11-16)
13+
14+
* First release on PyPI.

HISTORY.rst

Lines changed: 0 additions & 13 deletions
This file was deleted.

README.md

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
# Python Wordpress API
2+
3+
[![Pypi][pypi-image]][pypi-url]
4+
[![Pyup][pyup-image]][pyup-url]
5+
6+
7+
Simple wrapper around the Wordpress REST API
8+
9+
10+
* Free software: MIT licensea
11+
12+
## Features
13+
14+
* Will soon work on some documentation
15+
16+
## Tests
17+
18+
```
19+
make test
20+
```
21+
22+
[pypi-image]: https://img.shields.io/npm/v/co.svg?style=flat-square
23+
[pypi-url]: https://npmjs.org/package/co
24+
[pyup-image]: https://img.shields.io/travis/tj/co.svg?style=flat-square
25+
[pyup-url]: https://travis-ci.org/tj/co

README.rst

Lines changed: 0 additions & 38 deletions
This file was deleted.

python_wpapi/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,4 +2,4 @@
22

33
__author__ = """Lucas Lobosque"""
44
__email__ = '[email protected]'
5-
__version__ = '0.2.0'
5+
__version__ = '0.2.1'

setup.cfg

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[bumpversion]
2-
current_version = 0.2.0
2+
current_version = 0.2.1
33
commit = True
44
tag = True
55

setup.py

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,10 +3,10 @@
33

44
from setuptools import setup
55

6-
with open('README.rst') as readme_file:
6+
with open('README.md') as readme_file:
77
readme = readme_file.read()
88

9-
with open('HISTORY.rst') as history_file:
9+
with open('HISTORY.md') as history_file:
1010
history = history_file.read()
1111

1212
requirements = [
@@ -19,7 +19,7 @@
1919

2020
setup(
2121
name='python_wpapi',
22-
version='0.2.0',
22+
version='0.2.1',
2323
description="Simple wrapper around the Wordpress REST API",
2424
long_description=readme + '\n\n' + history,
2525
author="Lucas Lobosque",

0 commit comments

Comments
 (0)