Skip to main content

irelease is an Python package to release your package.

Project description

irelease - Library that automates releasing your Github python package at Pypi.

Python PyPI Version License Downloads Downloads DOI

Release your library by using the command: 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.

     a. Make new wheel, build and install package
     b. Set tag to newest version
     c. Push to git
     d. 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

pip install irelease

Alternatively, install irelease from the GitHub source:

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:

$ pyrelease

The following arguments are availble:

# Github name
pyrelease -u <githubname>

# Package name your want to release
pyrelease -p <packagename>

# Removing local builds:
# 1: Yes
# 0: No
pyrelease -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
pyrelease -v 5

# Twine path for to irelease at pypi. This is automatically determined if standard installation is performed.
pyrelease -t 'C://Users/erdogant/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:

    <any_dirname>/
    ├── <package_dir>/
    │   ├── __init__.py
    │   ├── package_name.py
    │   ├── ...
    ├── .gitignore
    ├── LICENSE
    ├── README.md
    ├── requirements.txt
    ├── setup.py
    └── ...

Example: releasing bnlearn package.

    bnlearn/
    ├── bnlearn/
    │   ├── __init__.py
    │   ├── bnlearn.py
    ├── .gitignore
    ├── LICENSE
    ├── README.md
    ├── requirements.txt
    ├── setup.py

Go to your destination dir and run release:

$ pyrelease

release with your specified arguments

# Package can be specified:
$ bnlearn>pyrelease -p bnlearn

# Username can be specified:
$ bnlearn>pyrelease -u erdogant

# Cleaning of previous builds in directory can be disabled
$ bnlearn>pyrelease -c 0

Do not forget to enter some release information on github and mark your release number:

References

Maintainer

  • Erdogan Taskesen, github: erdogant
  • Contributions are welcome.
  • If you wish to buy me a Coffee for this work, it is very appreciated :)

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

irelease-1.0.3.tar.gz (10.9 kB view hashes)

Uploaded source

Built Distribution

irelease-1.0.3-py3-none-any.whl (10.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page