Skip to content

Commit

Permalink
Release instructions (#260)
Browse files Browse the repository at this point in the history
* doc : RELEASE.md added

* doc : counters section added to RELEASE.md

* doc : RELEASE.md website section updated

* doc : README.md updated

* doc : website section of RELEASE.md updated

* doc : if needed tag added to RELEASE.md

* doc : image alt attribute added

* doc : website section of RELEASE.md updated

* fix : version check script updated

* doc : RELEASE.md updated

* doc : minor edit in RELEASE.md
  • Loading branch information
sepandhaghighi authored Sep 14, 2023
1 parent 8c005b6 commit 00fc330
Show file tree
Hide file tree
Showing 3 changed files with 115 additions and 32 deletions.
52 changes: 26 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
<div align="center">
<img src="https://github.com/sepandhaghighi/art/raw/master/otherfile/logo.png">
<img src="https://github.com/sepandhaghighi/art/raw/master/otherfile/logo.png" alt="Logo">
<br/>
<br/>
<a href="https://codecov.io/gh/sepandhaghighi/art">
<img src="https://codecov.io/gh/sepandhaghighi/art/branch/master/graph/badge.svg" alt="Codecov" />
</a>
<a href="https://badge.fury.io/py/art"><img src="https://badge.fury.io/py/art.svg" alt="PyPI version" height="18"></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3" /></a>
<a href="https://github.com/sepandhaghighi/art/blob/master/FontList.ipynb"><img src="https://img.shields.io/badge/Font List-652-blue.svg"></a>
<a href="https://github.com/sepandhaghighi/art/blob/master/ArtList.ipynb"><img src="https://img.shields.io/badge/Art List-710-orange.svg"></a>
<a href="https://github.com/sepandhaghighi/art/blob/master/DecorList.ipynb"><img src="https://img.shields.io/badge/Decor List-218-green.svg"></a>
<a href="https://t.me/artlib_bot" target="__blank"><img src="https://img.shields.io/badge/Telegram-Bot-red.svg"></a>
<a href="https://anaconda.org/sepandhaghighi/art"><img src="https://anaconda.org/sepandhaghighi/art/badges/version.svg"></a>
<a href="https://badge.fury.io/py/art"><img src="https://badge.fury.io/py/art.svg" alt="PyPI" height="18"></a>
<a href="https://www.python.org/"><img src="https://img.shields.io/badge/built%20with-Python3-green.svg" alt="built with Python3"></a>
<a href="https://github.com/sepandhaghighi/art/blob/master/FontList.ipynb"><img src="https://img.shields.io/badge/Font List-652-blue.svg" alt="Font List"></a>
<a href="https://github.com/sepandhaghighi/art/blob/master/ArtList.ipynb"><img src="https://img.shields.io/badge/Art List-710-orange.svg" alt="Art List"></a>
<a href="https://github.com/sepandhaghighi/art/blob/master/DecorList.ipynb"><img src="https://img.shields.io/badge/Decor List-218-green.svg" alt="Decor List"></a>
<a href="https://t.me/artlib_bot" target="__blank"><img src="https://img.shields.io/badge/Telegram-Bot-red.svg" alt="Telegram Bot"></a>
<a href="https://anaconda.org/sepandhaghighi/art"><img src="https://anaconda.org/sepandhaghighi/art/badges/version.svg" alt="Anaconda"></a>
<a href="https://discord.com/invite/FAAyq3QJqP"><img src="https://img.shields.io/discord/897532566301724722.svg" alt="Discord Channel"></a>
</div>

Expand Down Expand Up @@ -50,29 +50,29 @@ ART is a Python lib for text converting to ASCII art fancy. ;-)


<table>
<tr>
<td align="center">Open Hub</td>
<td align="center"><a href="https://www.openhub.net/p/artlib"><img src="https://www.openhub.net/p/artlib/widgets/project_thin_badge.gif"></a></td>
<tr align="center">
<td>Open Hub</td>
<td><a href="https://www.openhub.net/p/artlib"><img src="https://www.openhub.net/p/artlib/widgets/project_thin_badge.gif"></a></td>
</tr>
<tr>
<td align="center">PyPI Counter</td>
<td align="center"><a href="http://pepy.tech/project/art"><img src="http://pepy.tech/badge/art"></a></td>
<tr align="center">
<td>PyPI Counter</td>
<td><a href="http://pepy.tech/project/art"><img src="http://pepy.tech/badge/art"></a></td>
</tr>
<tr>
<td align="center">Github Stars</td>
<td align="center"><a href="https://github.com/sepandhaghighi/art"><img src="https://img.shields.io/github/stars/sepandhaghighi/art.svg?style=social&label=Stars"></a></td>
<tr align="center">
<td>Github Stars</td>
<td><a href="https://github.com/sepandhaghighi/art"><img src="https://img.shields.io/github/stars/sepandhaghighi/art.svg?style=social&label=Stars"></a></td>
</tr>
<tr>
<td align="center">Font Counter</td>
<td align="center">652</td>
<tr align="center">
<td>Font Counter</td>
<td id="font_counter">652</td>
</tr>
<tr>
<td align="center">1-Line-Art Counter</td>
<td align="center">710</td>
<tr align="center">
<td>1-Line-Art Counter</td>
<td id="art_counter">710</td>
</tr>
<tr>
<td align="center">Decor Counter</td>
<td align="center">218</td>
<tr align="center">
<td>Decor Counter</td>
<td id="decor_counter">218</td>
</tr>
</table>

Expand Down
83 changes: 83 additions & 0 deletions otherfile/RELEASE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,83 @@

# Art Release Instructions

#### Last Update: 2023-09-13

1. Create the `release` branch under `dev`
2. Update all version tags
1. `setup.py`
2. `INSTALL.md`
3. `otherfile/version_check.py`
4. `otherfile/meta.yaml`
5. `art/art_param.py`
6. `ArtList.ipynb`
7. `DecorList.ipynb`
8. `FontList.ipynb`
3. Update `help_func` function output in `test.py`
4. Update all font counters in `README.md` (**If needed**)
1. `<img src="https://img.shields.io/badge/Font List-{font_counter}-blue.svg" alt="Font List">`
2. `<td id="font_counter">{font_counter}</td>`
5. Update all art counters in `README.md` (**If needed**)
1. `<img src="https://img.shields.io/badge/Art List-{art_counter}-orange.svg" alt="Art List">`
2. `<td id="art_counter">{art_counter}</td>`
6. Update all decor counters in `README.md` (**If needed**)
1. `<img src="https://img.shields.io/badge/Decor List-{decor_counter}-green.svg" alt="Decor List">`
2. `<td id="decor_counter">{decor_counter}</td>`
7. Update `CHANGELOG.md`
1. Add a new header under `Unreleased` section (Example: `## [0.2] - 2022-08-17`)
2. Add a new compare link to the end of the file (Example: `[0.2]: https://github.com/sepandhaghighi/art/compare/v0.1...v0.2`)
3. Update `dev` compare link (Example: `[Unreleased]: https://github.com/sepandhaghighi/art/compare/v0.2...dev`)
8. Update Document
1. Run `otherfile/doc_run.bat`
9. Create a PR from `release` to `dev`
1. Title: `Version x.x` (Example: `Version 0.1`)
2. Tag all related issues
3. Labels: `release`
4. Set milestone
5. Set project
6. Wait for all CI pass
7. Need review (**1** reviewer)
10. Merge `dev` branch into `master`
1. Checkout to `master`
2. `git merge dev`
3. `git push origin master`
4. Wait for all CI pass
11. Create a new release
1. Target branch: `master`
2. Tag: `vx.x` (Example: `v0.1`)
3. Title: `Version x.x` (Example: `Version 0.1`)
4. Copy changelogs
5. Tag all related issues
12. Bump!!
13. Close this version issues
14. Close milestone
15. Close project
16. Generate HTML files
1. Run `otherfile/doc_to_html.bat`
2. Copy `doc_html` folder for the next steps
17. Update website
1. `git checkout gh-pages`
2. Update all version tags
1. `index.html`
3. Update fonts list
1. Update `FontList.html` (Step **16.2**)
4. Update arts list
1. Update `ArtList.html` (Step **16.2**)
5. Update decors list
1. Update `DecorList.html` (Step **16.2**)
6. Update all font counters in `index.html` (**If needed**)
1. `<img src="https://img.shields.io/badge/Font List-{font_counter}-blue.svg" alt="Font List">`
2. `<td id="font_counter">{font_counter}</td>`
7. Update all art counters in `index.html` (**If needed**)
1. `<img src="https://img.shields.io/badge/Art List-{art_counter}-orange.svg" alt="Art List">`
2. `<td id="art_counter">{art_counter}</td>`
8. Update all decor counters in `index.html` (**If needed**)
1. `<img src="https://img.shields.io/badge/Decor List-{decor_counter}-green.svg" alt="Decor List">`
2. `<td id="decor_counter">{decor_counter}</td>`

9. Update `Reference` section (**If needed**)
10. Update code examples (**If needed**)
1. [http://www.hilite.me](http://www.hilite.me)
2. Python console session
3. Colorful
4. Line numbers
12 changes: 6 additions & 6 deletions otherfile/version_check.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,12 @@
Failed = 0
VERSION = "6.0"

README_ITEMS = ['<td align="center">{0}</td>'.format(str(FONT_COUNTER)),
'<img src="https://img.shields.io/badge/Art List-{0}-orange.svg">'.format(str(ART_COUNTER)),
'<img src="https://img.shields.io/badge/Font List-{0}-blue.svg">'.format(str(FONT_COUNTER)),
'<td align="center">{0}</td>'.format(str(ART_COUNTER)),
'<td align="center">{0}</td>'.format(str(DECORATION_COUNTER)),
'<img src="https://img.shields.io/badge/Decor List-{0}-green.svg">'.format(str(DECORATION_COUNTER))]
README_ITEMS = ['<td id="font_counter">{0}</td>'.format(str(FONT_COUNTER)),
'<img src="https://img.shields.io/badge/Font List-{0}-blue.svg" alt="Font List">'.format(str(FONT_COUNTER)),
'<td id="art_counter">{0}</td>'.format(str(ART_COUNTER)),
'<img src="https://img.shields.io/badge/Art List-{0}-orange.svg" alt="Art List">'.format(str(ART_COUNTER)),
'<td id="decor_counter">{0}</td>'.format(str(DECORATION_COUNTER)),
'<img src="https://img.shields.io/badge/Decor List-{0}-green.svg" alt="Decor List">'.format(str(DECORATION_COUNTER))]

SETUP_ITEMS = [
"version='{0}'"]
Expand Down

0 comments on commit 00fc330

Please sign in to comment.