# irelease
[](https://img.shields.io/pypi/pyversions/irelease)
[](https://pypi.org/project/irelease/)
[](https://github.com/erdogant/irelease/blob/master/LICENSE)
[](https://github.com/erdogant/irelease/network)
[](https://github.com/erdogant/irelease/issues)
[](http://www.repostatus.org/#active)
[](https://pepy.tech/project/irelease/)
[](https://pepy.tech/project/irelease)
[](https://erdogant.github.io/irelease/pages/html/Documentation.html#medium-blog)

[](https://erdogant.github.io/irelease/pages/html/Documentation.html#)
<!---[](https://erdogant.github.io/irelease/)
<!---[!GitHub Repo stars](https://img.shields.io/github/stars/erdogant/irelease)-->
<!---[](https://www.buymeacoffee.com/erdogant)-->
<!---[](https://erdogant.github.io/donate/?currency=USD&amount=5)-->
Release your library by using the command: ``irelease`` or ``pyrelease``
#
**Star this repo if you like it! ⭐️**
#
## Introduction
irelease is Python package that will help to release your python package on both github and pypi.
A new release of your package is created by taking the following steps:
1. Extract the version from the __init__.py file
2. Remove old build directories such as dist, build and x.egg-info
3. Git pull (to make sure all is up to date)
4. Get latest release version at github
5. Check if the local (current) version is newer then the latest github release.
1. Make new wheel, build and install package
2. Set tag to newest version
3. Push to git
4. Upload to pypi (credentials for pypi required)
---------------
### Installation
* Install irelease from PyPI (recommended). irelease is compatible with Python 3.6+ and runs on Linux, MacOS X and Windows.
* It is distributed under the MIT license.
### Quick Start
```bash
pip install irelease
```
### Alternatively, install irelease from the GitHub source:
```bash
git clone https://github.com/erdogant/irelease.git
cd irelease
python setup.py install
```
### Run irelease
Go to the directory where the package is you want to release and simply run ``release``:
```bash
$ irelease
```
The following arguments are availble:
```bash
# Github name
irelease -u <githubname>
# Package name your want to release
irelease -p <packagename>
# Removing local builds:
# 1: Yes
# 0: No
irelease -c 1
# Verbosity messages:
# 0: No messages
# 1: Error only
# 2: Warnings and above
# 3: Regular messages and above
# 4: Debug and above
# 5: Trace and above
irelease -v 5
# Twine path for to irelease at pypi. This is automatically determined if standard installation is performed.
irelease -t 'C://<username>/AppData/Roaming/Python/Python36/Scripts/twine.exe'
```
### Example:
Your package to-be-published must have the correct structure. At least these files and folders are expected:
```bash
<any_dirname>/
├── <package_dir>/
│ ├── __init__.py
│ ├── package_name.py
│ ├── ...
├── .gitignore
├── LICENSE
├── README.md
├── requirements.txt
├── setup.py
└── ...
```
### Example: releasing bnlearn package.
```bash
bnlearn/
├── bnlearn/
│ ├── __init__.py
│ ├── bnlearn.py
├── .gitignore
├── LICENSE
├── README.md
├── requirements.txt
├── setup.py
```
<p align="left">
<img src="https://github.com/erdogant/irelease/blob/master/docs/figs/fig1.png" width="500" />
</p>
#### Go to your destination dir and run release:
```bash
$ irelease
```
**release with your specified arguments**
```bash
# Package can be specified:
$ bnlearn>irelease -p bnlearn
# Username can be specified:
$ bnlearn>irelease -u erdogant
# Cleaning of previous builds in directory can be disabled
$ bnlearn>irelease -c 0
```
<p align="left">
<img src="https://github.com/erdogant/irelease/blob/master/docs/figs/fig2.png" width="600" />
</p>
<p align="left">
<img src="https://github.com/erdogant/irelease/blob/master/docs/figs/fig2b.png" width="600" />
</p>
### Do not forget to enter some release information on github and mark your release number:
<p align="left">
<img src="https://github.com/erdogant/irelease/blob/master/docs/figs/fig3.png" width="600" />
<img src="https://github.com/erdogant/irelease/blob/master/docs/figs/fig4.png" width="600" />
</p>
#### References
* https://github.com/erdogant/irelease
### Maintainer
* Erdogan Taskesen, github: [erdogant](https://github.com/erdogant)
* Contributions are welcome.
* If you wish to buy me a <a href="https://www.buymeacoffee.com/erdogant">Coffee</a> for this work, it is very appreciated :)
Raw data
{
"_id": null,
"home_page": "https://github.com/erdogant/irelease",
"name": "irelease",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3",
"maintainer_email": "",
"keywords": "",
"author": "Erdogan Taskesen",
"author_email": "erdogant@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/4b/6e/47611b0b885b2c79235c53038e15e0fe17c26824b9e778cf9822ac261c1c/irelease-1.2.0.tar.gz",
"platform": null,
"description": "# irelease\r\n[](https://img.shields.io/pypi/pyversions/irelease)\r\n[](https://pypi.org/project/irelease/)\r\n[](https://github.com/erdogant/irelease/blob/master/LICENSE)\r\n[](https://github.com/erdogant/irelease/network)\r\n[](https://github.com/erdogant/irelease/issues)\r\n[](http://www.repostatus.org/#active)\r\n[](https://pepy.tech/project/irelease/)\r\n[](https://pepy.tech/project/irelease)\r\n[](https://erdogant.github.io/irelease/pages/html/Documentation.html#medium-blog)\r\n\r\n[](https://erdogant.github.io/irelease/pages/html/Documentation.html#)\r\n<!---[](https://erdogant.github.io/irelease/)\r\n<!---[!GitHub Repo stars](https://img.shields.io/github/stars/erdogant/irelease)-->\r\n<!---[](https://www.buymeacoffee.com/erdogant)-->\r\n<!---[](https://erdogant.github.io/donate/?currency=USD&amount=5)-->\r\n\r\n\r\nRelease your library by using the command: ``irelease`` or ``pyrelease``\r\n\r\n# \r\n**Star this repo if you like it! \u2b50\ufe0f**\r\n#\r\n\r\n## Introduction\r\nirelease is Python package that will help to release your python package on both github and pypi.\r\nA new release of your package is created by taking the following steps:\r\n\r\n1. Extract the version from the __init__.py file\r\n2. Remove old build directories such as dist, build and x.egg-info\r\n3. Git pull (to make sure all is up to date)\r\n4. Get latest release version at github\r\n5. Check if the local (current) version is newer then the latest github release.\r\n\r\n 1. Make new wheel, build and install package\r\n 2. Set tag to newest version\r\n 3. Push to git\r\n 4. Upload to pypi (credentials for pypi required)\r\n\r\n---------------\r\n\r\n### Installation\r\n* Install irelease from PyPI (recommended). irelease is compatible with Python 3.6+ and runs on Linux, MacOS X and Windows. \r\n* It is distributed under the MIT license.\r\n\r\n### Quick Start\r\n```bash\r\npip install irelease\r\n```\r\n\r\n### Alternatively, install irelease from the GitHub source:\r\n```bash\r\ngit clone https://github.com/erdogant/irelease.git\r\ncd irelease\r\npython setup.py install\r\n```\r\n\r\n\r\n### Run irelease\r\nGo to the directory where the package is you want to release and simply run ``release``:\r\n```bash\r\n$ irelease\r\n```\r\n\r\nThe following arguments are availble:\r\n```bash\r\n# Github name\r\nirelease -u <githubname>\r\n\r\n# Package name your want to release\r\nirelease -p <packagename>\r\n\r\n# Removing local builds:\r\n# 1: Yes\r\n# 0: No\r\nirelease -c 1\r\n\r\n# Verbosity messages:\r\n# 0: No messages\r\n# 1: Error only\r\n# 2: Warnings and above\r\n# 3: Regular messages and above\r\n# 4: Debug and above\r\n# 5: Trace and above\r\nirelease -v 5\r\n\r\n# Twine path for to irelease at pypi. This is automatically determined if standard installation is performed.\r\nirelease -t 'C://<username>/AppData/Roaming/Python/Python36/Scripts/twine.exe'\r\n```\r\n\r\n### Example:\r\nYour package to-be-published must have the correct structure. At least these files and folders are expected:\r\n```bash\r\n <any_dirname>/\r\n \u251c\u2500\u2500 <package_dir>/\r\n \u2502 \u251c\u2500\u2500 __init__.py\r\n \u2502 \u251c\u2500\u2500 package_name.py\r\n \u2502 \u251c\u2500\u2500 ...\r\n \u251c\u2500\u2500 .gitignore\r\n \u251c\u2500\u2500 LICENSE\r\n \u251c\u2500\u2500 README.md\r\n \u251c\u2500\u2500 requirements.txt\r\n \u251c\u2500\u2500 setup.py\r\n \u2514\u2500\u2500 ...\r\n```\r\n\r\n\r\n### Example: releasing bnlearn package.\r\n```bash\r\n bnlearn/\r\n \u251c\u2500\u2500 bnlearn/\r\n \u2502 \u251c\u2500\u2500 __init__.py\r\n \u2502 \u251c\u2500\u2500 bnlearn.py\r\n \u251c\u2500\u2500 .gitignore\r\n \u251c\u2500\u2500 LICENSE\r\n \u251c\u2500\u2500 README.md\r\n \u251c\u2500\u2500 requirements.txt\r\n \u251c\u2500\u2500 setup.py\r\n```\r\n<p align=\"left\">\r\n <img src=\"https://github.com/erdogant/irelease/blob/master/docs/figs/fig1.png\" width=\"500\" />\r\n</p>\r\n\r\n\r\n#### Go to your destination dir and run release:\r\n```bash\r\n$ irelease\r\n```\r\n\r\n**release with your specified arguments**\r\n```bash\r\n# Package can be specified:\r\n$ bnlearn>irelease -p bnlearn\r\n\r\n# Username can be specified:\r\n$ bnlearn>irelease -u erdogant\r\n\r\n# Cleaning of previous builds in directory can be disabled\r\n$ bnlearn>irelease -c 0\r\n```\r\n\r\n<p align=\"left\">\r\n <img src=\"https://github.com/erdogant/irelease/blob/master/docs/figs/fig2.png\" width=\"600\" />\r\n</p>\r\n\r\n<p align=\"left\">\r\n <img src=\"https://github.com/erdogant/irelease/blob/master/docs/figs/fig2b.png\" width=\"600\" />\r\n</p>\r\n\r\n### Do not forget to enter some release information on github and mark your release number:\r\n<p align=\"left\">\r\n <img src=\"https://github.com/erdogant/irelease/blob/master/docs/figs/fig3.png\" width=\"600\" />\r\n <img src=\"https://github.com/erdogant/irelease/blob/master/docs/figs/fig4.png\" width=\"600\" />\r\n</p>\r\n\r\n\r\n#### References\r\n* https://github.com/erdogant/irelease\r\n\r\n### Maintainer\r\n* Erdogan Taskesen, github: [erdogant](https://github.com/erdogant)\r\n* Contributions are welcome.\r\n* If you wish to buy me a <a href=\"https://www.buymeacoffee.com/erdogant\">Coffee</a> for this work, it is very appreciated :)\r\n",
"bugtrack_url": null,
"license": "",
"summary": "irelease is an Python package to release your package.",
"version": "1.2.0",
"project_urls": {
"Download": "https://github.com/erdogant/irelease/archive/1.2.0.tar.gz",
"Homepage": "https://github.com/erdogant/irelease"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "dd6848c5c3f33c10233018e8b1d646be1bad81e3d869213b9a39d46ce79c627f",
"md5": "d677e3b460270367df05d826575fd92f",
"sha256": "af7e8069b631a8b9a9917a3f63ef12560ce620e5a24e01355f73b1e450df0088"
},
"downloads": -1,
"filename": "irelease-1.2.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d677e3b460270367df05d826575fd92f",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3",
"size": 11194,
"upload_time": "2023-11-25T21:57:20",
"upload_time_iso_8601": "2023-11-25T21:57:20.462751Z",
"url": "https://files.pythonhosted.org/packages/dd/68/48c5c3f33c10233018e8b1d646be1bad81e3d869213b9a39d46ce79c627f/irelease-1.2.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "4b6e47611b0b885b2c79235c53038e15e0fe17c26824b9e778cf9822ac261c1c",
"md5": "f118c7f96ee3ab0edc6c9ba5d59dbec3",
"sha256": "bb7b2f1180020abe49603a1048b349e36b8c08e792f8e7e4764494aeffe03efa"
},
"downloads": -1,
"filename": "irelease-1.2.0.tar.gz",
"has_sig": false,
"md5_digest": "f118c7f96ee3ab0edc6c9ba5d59dbec3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3",
"size": 12261,
"upload_time": "2023-11-25T21:57:22",
"upload_time_iso_8601": "2023-11-25T21:57:22.321262Z",
"url": "https://files.pythonhosted.org/packages/4b/6e/47611b0b885b2c79235c53038e15e0fe17c26824b9e778cf9822ac261c1c/irelease-1.2.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-25 21:57:22",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "erdogant",
"github_project": "irelease",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "irelease"
}