point-tools/README.md

105 lines
2.8 KiB
Markdown
Raw Permalink Normal View History

2016-12-11 04:14:47 +00:00
[ ![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)
2016-12-11 06:11:47 +00:00
[![codecov](https://codecov.io/bb/skobkin/point-tools/branch/master/graph/badge.svg)](https://codecov.io/bb/skobkin/point-tools)
2017-01-11 02:22:34 +00:00
[![Total Downloads](https://poser.pugx.org/skobkin/point-tools/downloads)](https://packagist.org/packages/skobkin/point-tools)
[![License](https://poser.pugx.org/skobkin/point-tools/license)](https://packagist.org/packages/skobkin/point-tools)
2016-12-11 02:41:30 +00:00
2015-06-02 04:03:58 +00:00
# Point Tools
Point Tools is a service which provides additional features for [Point.im](https://point.im/) microblog users.
2015-06-02 04:03:58 +00:00
# Installation
2015-06-02 04:03:58 +00:00
Application setup is quite simple:
2015-06-02 04:03:58 +00:00
## Getting the source code
2015-06-02 04:03:58 +00:00
### Via Git
```bash
2015-06-02 04:03:58 +00:00
git clone https://skobkin@bitbucket.org/skobkin/point-tools.git
cd point-tools
```
### Via Composer
```bash
composer create-project skobkin/point-tools -s dev
cd point-tools
```
## Setting file access privileges
Set up appropriate write privileges for `app/cache` and `app/logs`.
2015-06-02 04:03:58 +00:00
## Installing dependencies (not needed after installation via Composer)
2015-06-02 04:03:58 +00:00
```bash
# In developer environment:
2015-06-02 04:03:58 +00:00
composer install
# In production environment
2015-06-02 04:03:58 +00:00
composer install --no-dev --optimize-autoloader
```
After dependencies installation you will be asked for database credentials of PostgreSQL database and some other application parameters.
2015-06-02 04:03:58 +00:00
## Database initialization
2015-06-02 04:03:58 +00:00
```bash
2015-06-02 04:03:58 +00:00
php app/console doctrine:migrations:migrate
```
## Web assets installation
2015-06-02 04:03:58 +00:00
```bash
2015-06-02 04:03:58 +00:00
php app/console assets:install web --symlink
```
## Adding CRON jobs
2015-06-02 04:03:58 +00:00
```bash
2015-06-02 04:03:58 +00:00
crontab -e
```
You can use following jobs as an example:
2015-06-02 04:03:58 +00:00
```crontab
# point.skobk.in
*/10 * * * * /usr/bin/php /path/to/point-tools/app/console point:update:subscriptions --env=prod
0 0 * * * /usr/bin/php /path/to/point-tools/app/console point:update:subscriptions --all-users --env=prod
2015-06-02 04:03:58 +00:00
```
See [`app/crontab`](https://bitbucket.org/skobkin/point-tools/src/master/app/crontab) for more advanced usage.
2017-01-04 22:40:26 +00:00
## Setting Telegram webhook (to enable bot)
```bash
2017-01-15 03:29:30 +00:00
php app/console telegram:webhook set
2017-01-04 22:40:26 +00:00
```
## Removing Telegram webhook
```bash
2017-01-04 22:40:26 +00:00
php app/console telegram:webhook delete
```
# Running tests
## Configure environment variables
```bash
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
2017-01-15 03:29:30 +00:00
export SYMFONY_ENV=test
```
## Load fixtures (if needed)
```bash
php app/console doctrine:fixtures:load --no-interaction
```
## Run tests
```bash
phpunit -c app/
```