معرفی شرکت ها

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

تبلیغات ما

مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.

مشاهده بیشتر

توضیحات

Simply setup AB testing environment

ویژگی	مقدار
سیستم عامل	-
نام فایل	abing-0.1.2
نام	abing
نسخه کتابخانه	0.1.2
نگهدارنده	[]
ایمیل نگهدارنده	[]
نویسنده	Dohyung Park
ایمیل نویسنده	dohyung.prk@gmail.com
آدرس صفحه اصلی	https://github.com/dohyungp/abing
آدرس اینترنتی	https://pypi.org/project/abing/
مجوز	-

# Welcome to ABING! ## What is ABING? ABING는 AB테스트를 위한 라우팅 툴입니다. 일반적인 비즈니스 모델에서 사용할 수 있도록 ABING는 별도의 연동과정 없이 AB테스팅을 운영할 수 있도록 개발되었습니다. UI에서 실험 생성 및 설정 후 route API([/api/v1/experiments/route](localhost:8000/api/v1/experiments/route))에서 각 user id별(필요 시 uuid)로 할당만 받으면 자유롭게 AB테스팅을 할 수 있습니다. ## Getting started ### Installation 아래와 같이 pip로 빠르게 설치할 수 있습니다. ```shell pip install abing ``` ### 서버 실행 #### DB 초기화 DB 연결을 위해 ABING은 다음 다섯개의 환경변수를 필요로 합니다. - ABING_DB - ABING_DB_USER - ABING_DB_PASSWORD - ABING_DB_HOST - ABING_DB_PORT 따라서 아래와 같이 환경변수를 export해주세요 ```shell export ABING_DB="abing" export ABING_DB_USER="abing" export ABING_DB_PASSWORD="$uperScretPassW0rd" export ABING_DB_HOST="abing-db.com" export ABING_DB_PORT=5432 ``` 이후 migration을 위해 아래와 같이 명령어를 입력해주시면 됩니다(abing은 migration툴로 alembic을 사용하고 있으므로 정상적으로 마이그레이션이 되었다면, alembic migration 로그가 출력될 거에요) ```shell abing initdb ``` #### 서버 실행 abing은 uvicorn을 사용하여 서버를 실행합니다. 따라서 아래와 같이 커맨드를 날리면 바로 서버가 구동됩니다 ```shell uvicorn abing:app --reload --host "0.0.0.0" ``` gunicorn과 같이 실행하고 싶으시다면 아래와 같이 uvicorn worker class와 같이 사용하시는걸 추천드립니다. ```shell gunicorn abing:app -w 4 -k uvicorn.workers.UvicornWorker ``` #### 최초 관리자 계정 생성 다른 유저 계정을 만들어주려면 최초 관리자 계정이 필요합니다. 따라서 아래와 같이 `createsuperuser` 명령어로 최초의 슈퍼계정을 만들어주세요. ```shell abing createsueruser ``` 여기까지 정상적으로 실행이 되셨다면, 배포하는 url의 루트(`/`)에서 슈퍼계정으로 로그인을 해보세요. 로그인이 정상적으로 되었다면 성공적으로 abing을 시작하셨습니다! ### 실험 생성하기 1. Experiments - List에서 Add a new experiment를 클릭하시거나, Experiments - Create를 눌러 실험 생성 메뉴로 갈 수 있습니다. 2. 각 항목을 입력하고, Create를 누르면 실험이 생성됩니다. * Name(실험 명)은 고유할 필요는 없으나, 운영차원에서 코드와 함께 관리되는 것이 좋습니다. * Create로 만들때에는 실험은 런칭이 되지 않은 상태로 리스트업됩니다. * `+` Add Arm을 누르면 바로 생성할 Arm을 추가할 수 있습니다. 이 때 Traffic은 얼마나 유저를 해당 Arm에 보낼지에 대한 가중치로, 모든 Arm 합산 대비 해당 Arm의 비율로 내부적으로 계산되어 추후 Arm 선택 시 반영됩니다. * 각 Arm의 Feature는 해당 Arm이 선택되었을 때 보여줄 Feature flag입니다. 예를 들어 feature `key`가 `fontColor`라면 `value`는 `#fff`같이 입력하여 자유롭게 클라이언트에서 dynamic한 값으로 사용할 수 있습니다. 물론 key value는 문자열에 불과하기 때문에 사용자에 따라서는 분기를 위한 flag 수준으로만 사용해도 무방합니다(e.g `key`에 `is_baseline`, `value`에 `true` 이런 식으로 지정할 수 있습니다) ### 실험 운영하기 1. 실험이 성공적으로 만들어졌다면 **Experiments - List**에서 실험을 찾아볼 수 있습니다. * 실험은 운영 중인 실험, 최근에 만든 실험 순, 최근에 업데이트된 실험 순으로 자동 정렬되어 있습니다. * Progress는 일종의 부가정보입니다. Progress가 100%에 도달한다고 해서 실험이 종료되거나 하지 않습니다. 2. 방근 만든 실험을 바로 런칭하고 싶다면 오른쪽 스위치를 누르기만 하면 됩니다. * 실험 정보를 보고 싶다면 `+`를 눌러 펼쳐보거나 실험명에 있는 링크를 눌러 자세히 볼 수 있습니다. 3. 포함해야 하는 feature 혹은 Arm이 있는데 반영이 안되었다면 링크를 눌러 수정할 수 있습니다. ### Client에서 실험 라우팅하기 1. `/api/v1/experiments/route`를 통해 현재 운영중인 모든 실험의 각 arm에 할당될 수 있습니다. * parameter로 `user_id` 값만 보내주면 됩니다. * user_id는 로그인이 없는 서비스라면 uuid값을 보내주는 것으로 충분합니다. 로그인마다 동일하게 보이려면 local storage에 uuid를 저장하기만 하면 됩니다(abing는 별도의 id 저장없이 동일한 traffic allocation이 가능하도록 디자인 되었습니다) 2. `/api/v1/experiments/{id}/route`를 통해 특정 id의 실험에 한해 route받을 수도 있습니다. * 모든 parameter는 `/api/v1/experiments/route`와 동일합니다. ## Future ### 추가 기능 1. MAB 기능 지원: Thomson sampling, Eplisilon Greedy, UCB 세가지 유형을 지원. 2. SDK: 각 언어에 맞는 sdk를 지원하여, 다양한 플랫폼에서 활용할 수 있도록 함. 3. 실험 통계 기능: 각 실험화면에서 Sample size calculator, Significant calculator 및 Power analysis 등을 지원 4. Tag 기능: Arm 태그 기능을 통해 특정 태그값을 가지고 있는 경우 특정 Arm으로 포함되도록 지원(e.g Control tag가 iOS이고 client에서 보내주는 User meta에 iOS가 포함되면 해당 Arm에 포함) 5. 사용성 증대: 실험 검색 기능, 카테고리 기능 추가 6. 기타 Bug fix: 에러 메시지 분류 등

نیازمندی

مقدار	نام
-	fastapi
-	uvicorn
-	sqlalchemy
-	alembic
-	pydantic[email]
-	python-jose[cryptography]
-	passlib[bcrypt]
-	psycopg2-binary
-	xxhash
-	python-multipart
-	aiofiles
-	jinja2
-	click
-	sentry-sdk

زبان مورد نیاز

مقدار	نام
>=3.6	Python

نحوه نصب

نصب پکیج whl abing-0.1.2:

pip install abing-0.1.2.whl

نصب پکیج tar.gz abing-0.1.2:

pip install abing-0.1.2.tar.gz