Skip to main content

this is a description

Project description

intro

suppose you want to make a comand line tool called mac_mathpix_ocr. it accept integer as numbers ouput carrots we need to feed

ex:
	cmd> mac_mathpix_ocr 2 
	ouput: 4

we can get the output by two ways:

  • command line

      mac_mathpix_ocr  2
    
  • call python moudle

    python -m mac_mathpix_ocr 2
    

best practice schema

env

Generated by make env

This is first step you need to do in any python project

  • it will create a virtual env
  • auto source it
  • install requirements for the start up

test

run make test

run

make run will run in module mode make main will run in normal mode

You can see that main.py and mac_mathpix_ocr/__main__.py are the same content file.

why do we need main.py ? It is eay to make an entry in IDE , like intellij.

Could I just use __main__.py to run like this?

python mac_mathpix_ocr/__main__.py

You cound not.

That is because the top-level package problem.

Ex:

python main.py 
top-level package is the same as main.py

python src/func/main.py  
top-level package is the same as main.py, aka func 
top-level package is the folder where you run this command from

So , why mac_mathpix_ocr/__main__.py does not work?

because top-level package is mac_mathpix_ocr now.

logging

Always use logging for log print,dont use printlogging config is controlled bylogging.yml, which can control every module level call setup_logging` in main file (ra)

make module

update readmeput moudle in the folder parallel with logx folder.

  • logx
  • your_module

packing module or cmd

local

for quick test purpose

  • install: pip install .
  • uninstall: pip uninstall <module_name>

make install make uninstall

upload to test or prod PYPI server

upload to test server:

make upload-to-test 

upload to prod server:

make upload-to-prod

test and coverage

pure test

make test

test with coverage

make coverage

Project details


Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

mac_mathpix_ocr-0.0.1-py2.py3-none-any.whl (5.5 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file mac_mathpix_ocr-0.0.1-py2.py3-none-any.whl.

File metadata

  • Download URL: mac_mathpix_ocr-0.0.1-py2.py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 2, Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.4.2 requests/2.23.0 setuptools/40.6.3 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.7.1

File hashes

Hashes for mac_mathpix_ocr-0.0.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 52cbcea86ec77d55a180174012e545d113f822e89f12fe45e3d4b31f2e4b0262
MD5 b2fd32551f24c04f740e892ae4a0a172
BLAKE2b-256 3cacc29bb3ca2523158532ccf471a5f09f651b4497aa8080ae454095e9e450b8

See more details on using hashes here.

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