Skip to main content

Rename image file to only digit name and convert ebook files.

Project description



The Ebook_homebrew is changing file name to only digit name like 001.jpg and make e-book format files. Project Status: Active Maintainability Test Coverage CodeFactor Actions Status Actions Status Documentation Status Latest PyPI version!-1EAEDB.svg Twitter URL GitPitch dockerhub Deploy to Heroku Deploy to Azure

ebook_homebrew is command line interface which change file name to only digit name like 001.jpg and make e-book format files.

Getting Started

The Ebook_homebrew is a python package, so that you can use or pip installer.


$ python install

Or using pip installer

$ pip install ebook-homebrew


You can use global command ebookhomebrew .

Show help.

$ ebookhomebrew -h

Ex1) Rename image file to only digit and Create PDF file.

$ ebookhomebrew auto -s ./tests -d 3,4 -e jpg -f test.pdf

Ex2) Run Rest API Server for converting pdf from images.

$ ebookhomebrew api -p 8080

ebookhomebrew command line interface

You can use ebookhomebrew command line interface.

Choose subcommands. Usually choose "auto"
 auto      Make only digit file name, convert e-book file such as PDF
 api               Provides Rest API interfaces
 makezip           Make zip file for adding specify extension files.
Options auto
-h, --help            show this help message and exit
-s SRC_DIR, --src_dir SRC_DIR
                      Source directory which put original image files.
--dst_dir DST_DIR     Destination directory which put e-book file.
-d N,N, --digit N,N   Serial number digits you remain file name
-e EXT, --extension EXT
                      Destination directory which put e-book file.
-f FILENAME, --filename FILENAME
                      Destination directory which put e-book file.
-m, --manual          Duplicate file name, solving manually.
-r, --remove          Remove original image file.
-y, --assume_yes      no verify users.
Options api
optional arguments:
-h, --help            show this help message and exit
-p PORT, --port PORT  API Server Port


Unit Test

Using pytest, if you want to test.

$ pytest

If you get coverage report, run coverage and report.

$ coverage run --source=ebook_homebrew -m pytest
$ coverage report -m

Or pytest-cov param for pytest

$ pytest --cov=ebook_homebrew --cov-report html --cov-report xml

Integration Test

Using pytest, if you want to test with mark “–it”

$ pytest --it

With tox

With tox, you can test multiple python version.(only python3.5, 3.6)

$ tox


This Repo is studies repo which CI/CD Config by tubone. Check config on this repo!


This repository uses Travis-CI and be building jobs by push or PR branches.


Also you can check coverage with Codecov


You can check the code maintainability, smells and technical debt with CodeClimate


Scrutinizer is the CI which build app and check code quality


Appveyor is the CI which use Windows Platform and Push the artifacts to PyPI

Azure Pipelines

This repo use Azure Dev Ops Azure Pipelines with platform MacOS.


Shippable is the CI use Docker containers.


CircleCI is the great CI which can use selenium (not use selenium test in this repo but use ebook-homebrew-vue-typescript-client).


LGTM is code smells check.


Snyk is fix and prevent vulnerabilities in this code.


This repo use ReadTheDocs by Docs.


Push master branch, build docker container with DockerHub


Stand Alone Web GUI

Stand alone Web GUI. Such as Create PDF from your images by using Flask.

Command Line Tools with using Rest API

Command Line Tools which client app for REST API.

Client App with ebook-homebrew’s rest API

Vue.js Frontend App

Using Vue.js, Call REST API.

ebook-homebrew-vue-client (deprecated)


Rust Command Line Client

Using Rust, Call REST API by CLI


Deploy API to Heroku

Deploy Ebook-homebrew to Heroku app.

Push a button below.

Deploy to Heroku



The ebook-homebrew REST API DEMO is deploy to Heroku.


With Vue.js Front

Using Vue.js, Call REST API DEMO App, deploy to Heroku.

With Flutter Android App

Using Flutter, Call REST API DEMO Android App, deploy to Deploygate. Try me!

Try it on your device via DeployGate

And also, you can download to Google Play


Ebook Homebrew presentation is made in GitPitch.



This software is released under the MIT License, see LICENSE.

API Document

The Document write by Sphinx.


v1.0.0 (2019-1-14)

  • First release.

v1.1.0 (2019-02-05)

  • Rename to digit filename a little bit speedy for using asyncio

  • More Testcase(Windows)

v2.0.0 (2019-04-20)

  • Rest API Interface.

v2.1.0 (2019-07-29)

  • Use Sqlite3 and save uploadID

  • Typescript Demo app

v2.1.1 (2019-08-28)

  • Create Logo.

v2.1.3 (2019-09-14)

  • Fix Vulnerability

  • Awesome Design

  • Result List

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

ebook_homebrew-2.1.4.tar.gz (19.7 kB view hashes)

Uploaded Source

Built Distributions

ebook_homebrew-2.1.4-py3.7.egg (49.7 kB view hashes)

Uploaded Source

ebook_homebrew-2.1.4-py2.py3-none-any.whl (24.2 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page