skobkin/point-tools
1
1
Fork 0
Code Issues 4 Pull requests 1 Releases Activity

README.md updated: translation to English, tests, fixtures, Scrutinizer badges.

Browse source
This commit is contained in:
Alexey Skobkin 2016-12-12 00:59:16 +03:00
parent 0dfdf9793e
commit 8ed6d1dd6c
1 changed files with 36 additions and 12 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

48
README.md
View file

@ -1,26 +1,28 @@
[ ![Codeship Status for skobkin/point-tools](https://app.codeship.com/projects/bb9fe730-a175-0134-5572-12490b0b4938/status?branch=master)](https://app.codeship.com/projects/189850) [ ![Codeship Status for skobkin/point-tools](https://app.codeship.com/projects/bb9fe730-a175-0134-5572-12490b0b4938/status?branch=master)](https://app.codeship.com/projects/189850)
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/b/skobkin/point-tools/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/b/skobkin/point-tools/?branch=master)
[![Scrutinizer Code Coverage](https://scrutinizer-ci.com/b/skobkin/point-tools/badges/coverage.png?b=master)](https://scrutinizer-ci.com/b/skobkin/point-tools/?branch=master)
[![codecov](https://codecov.io/bb/skobkin/point-tools/branch/master/graph/badge.svg)](https://codecov.io/bb/skobkin/point-tools) [![codecov](https://codecov.io/bb/skobkin/point-tools/branch/master/graph/badge.svg)](https://codecov.io/bb/skobkin/point-tools)
[![SensioLabsInsight](https://insight.sensiolabs.com/projects/a54ef130-5aed-44f5-9ea9-c404a3d8db6b/mini.png)](https://insight.sensiolabs.com/projects/a54ef130-5aed-44f5-9ea9-c404a3d8db6b) [![SensioLabsInsight](https://insight.sensiolabs.com/projects/a54ef130-5aed-44f5-9ea9-c404a3d8db6b/mini.png)](https://insight.sensiolabs.com/projects/a54ef130-5aed-44f5-9ea9-c404a3d8db6b)
# Point Tools # Point Tools
Point Tools - это сервис предоставляющий дополнительные функции для блогов [Point.im](https://point.im/). Point Tools is a service which provides additional features for [Point.im](https://point.im/) microblog users.
# Установка # Installation
Установка сервиса довольно проста: Application setup is quite simple:
## Получение исходников ## Getting the source code
```shell ```shell
git clone https://skobkin@bitbucket.org/skobkin/point-tools.git git clone https://skobkin@bitbucket.org/skobkin/point-tools.git
cd point-tools cd point-tools
``` ```
## Выставление прав ## Setting file access privileges
Выставьте права на запись для директорий `app/cache` и `app/logs`. Set up appropriate write privileges for `app/cache` and `app/logs`.
## Установка зависимостей ## Installing dependencies
```shell ```shell
# В dev-среде: # В dev-среде:
@ -29,27 +31,27 @@ composer install
composer install --no-dev --optimize-autoloader composer install --no-dev --optimize-autoloader
``` ```
После установки зависимостей у вас будут запрошены реквизиты доступа к БД PostgreSQL и данные необходимые для функционирования сервиса. After dependencies installation you will be asked for database credentials of PostgreSQL database and some other application parameters.
## Инициализация БД ## Database initialization
```shell ```shell
php app/console doctrine:migrations:migrate php app/console doctrine:migrations:migrate
``` ```
## Установка ресурсов ## Web assets installation
```shell ```shell
php app/console assets:install web --symlink php app/console assets:install web --symlink
``` ```
## Добавление задания в CRON ## Adding CRON jobs
```shell ```shell
crontab -e crontab -e
``` ```
Вставьте в ваш файл crontab конфиг задания: You can use following jobs as an example:
```crontab ```crontab
# point.skobk.in # point.skobk.in
@ -57,3 +59,25 @@ crontab -e
0 0 * * * /usr/bin/php /path/to/point-tools/app/console point:update:subscriptions --all-users --env=prod 0 0 * * * /usr/bin/php /path/to/point-tools/app/console point:update:subscriptions --all-users --env=prod
``` ```
# Running tests
## Configure environment variables
```shell
export SYMFONY__TEST_DATABASE_USER=some_database_user
export SYMFONY__TEST_DATABASE_PASSWORD=some_database_password
export SYMFONY__TEST_DATABASE_NAME=some_database_name
export SYMFONY__TEST_DATABASE_PORT=postgresql_port
```
## Load fixtures (if needed)
```shell
php app/console doctrine:fixtures:load --no-interaction
```
## Run tests
```shell
phpunit -c app/
```