Skip to content

Commit 696642a

Browse files
committed
Added documentation
1 parent ea55e3c commit 696642a

5 files changed

Lines changed: 69 additions & 0 deletions

File tree

docs/changelog.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Changelog
2+
3+
### 0.1.0 - First public version
4+
5+
* Initial fork from private repo

docs/index.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# yamlable
2+
3+
*A thin wrapper of PyYaml to convert Python objects to YAML and back.*
4+
5+
[![Build Status](https://travis-ci.org/smarie/python-yamlable.svg?branch=master)](https://travis-ci.org/smarie/python-yamlable) [![Tests Status](https://smarie.github.io/python-yamlable/junit/junit-badge.svg?dummy=8484744)](https://smarie.github.io/python-yamlable/junit/report.html) [![codecov](https://codecov.io/gh/smarie/python-yamlable/branch/master/graph/badge.svg)](https://codecov.io/gh/smarie/python-yamlable) [![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://smarie.github.io/python-yamlable/) [![PyPI](https://img.shields.io/badge/PyPI-yamlable-blue.svg)](https://pypi.python.org/pypi/yamlable/)
6+
7+
8+
9+
## Installing
10+
11+
```bash
12+
> pip install yamlable
13+
```
14+
15+
## Usage
16+
17+
TODO
18+
19+
See [Usage](./usage) for a complete example with exceptions handling and more.
20+
21+
22+
## Main features / benefits
23+
24+
* TODO
25+
26+
27+
## See Also
28+
29+
[PyYaml documentation](http://pyyaml.org/wiki/PyYAMLDocumentation)
30+
31+
### Others
32+
33+
*Do you like this library ? You might also like [my other python libraries](https://github.com/smarie?utf8=%E2%9C%93&tab=repositories&q=&type=&language=python)*
34+
35+
## Want to contribute ?
36+
37+
Details on the github page: [https://github.com/smarie/python-yamlable](https://github.com/smarie/python-yamlable)

docs/long_description.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# yamlable
2+
3+
[![Build Status](https://travis-ci.org/smarie/python-yamlable.svg?branch=master)](https://travis-ci.org/smarie/python-yamlable) [![Tests Status](https://smarie.github.io/python-yamlable/junit/junit-badge.svg?dummy=8484744)](https://smarie.github.io/python-yamlable/junit/report.html) [![codecov](https://codecov.io/gh/smarie/python-yamlable/branch/master/graph/badge.svg)](https://codecov.io/gh/smarie/python-yamlable) [![Documentation](https://img.shields.io/badge/docs-latest-blue.svg)](https://smarie.github.io/python-yamlable/) [![PyPI](https://img.shields.io/badge/PyPI-yamlable-blue.svg)](https://pypi.python.org/pypi/yamlable/)
4+
5+
*A thin wrapper of PyYaml to convert Python objects to YAML and back.*
6+
7+
The documentation for users is available here: [https://smarie.github.io/python-yamlable/](https://smarie.github.io/python-yamlable/)
8+
9+
A readme for developers is available here: [https://github.com/smarie/python-yamlable](https://github.com/smarie/python-yamlable)

docs/mkdocs.yml

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
site_name: yamlable
2+
# site_description: 'A short description of my project'
3+
repo_url: https://github.com/smarie/python-pytest-cases
4+
pages:
5+
- Home: index.md
6+
- Usage details: usage.md
7+
- Changelog: changelog.md
8+
theme: material # readthedocs mkdocs
9+
10+
markdown_extensions:
11+
- admonition # to add notes such as http://squidfunk.github.io/mkdocs-material/extensions/admonition/
12+
- codehilite(guess_lang=false)
13+
- toc(permalink=true)

docs/usage.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
# Usage
2+
3+
You have seen in the [main page](./index) a small example to understand the concepts. Below we present other advanced usages.
4+
5+
TODO

0 commit comments

Comments
 (0)