{"id":21614670,"url":"https://github.com/eea/art12-viewer","last_synced_at":"2026-04-11T21:47:22.984Z","repository":{"id":21191295,"uuid":"24499765","full_name":"eea/art12-viewer","owner":"eea","description":"A viewer for the collected article 12 data","archived":false,"fork":false,"pushed_at":"2025-01-08T21:29:21.000Z","size":1705,"stargazers_count":1,"open_issues_count":1,"forks_count":0,"subscribers_count":48,"default_branch":"master","last_synced_at":"2025-01-24T20:41:36.280Z","etag":null,"topics":["art12","docker","eionet","flask"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/eea.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-09-26T13:07:58.000Z","updated_at":"2024-11-13T09:43:53.000Z","dependencies_parsed_at":"2023-12-22T15:58:44.341Z","dependency_job_id":"226d9433-5478-4516-9895-5d484cf7f824","html_url":"https://github.com/eea/art12-viewer","commit_stats":null,"previous_names":[],"tags_count":39,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Fart12-viewer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Fart12-viewer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Fart12-viewer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eea%2Fart12-viewer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eea","download_url":"https://codeload.github.com/eea/art12-viewer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244266091,"owners_count":20425825,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["art12","docker","eionet","flask"],"created_at":"2024-11-24T22:08:51.271Z","updated_at":"2026-04-11T21:47:17.925Z","avatar_url":"https://github.com/eea.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Project Name\n------------\nThe Project Name is `Art 12 Consultation Tool`\n\n[![Travis](https://travis-ci.org/eea/art12-viewer.svg?branch=master)](https://travis-ci.org/eea/art12-viewer)\n[![Docker](https://img.shields.io/docker/build/eeacms/art12-viewer)](https://hub.docker.com/r/eeacms/art12-viewer/builds/)\n\nPrerequisites - System packages\n-------------------------------\n\nThese packages should be installed as superuser (root).\n\n### Debian based systems ###\n\nInstall these before setting up an environment:\n\n    apt-get install python-setuptools python-dev libmysqlclient-dev \\\n    libldap2-dev libsasl2-dev python-virtualenv mysql-server git\n\n### RHEL based systems ###\nInstall Python2.7 with PUIAS: https://gist.github.com/nico4/9616638\n\nRun these commands:\n\n    curl https://raw.github.com/pypa/pip/master/contrib/get-pip.py | python2.7 -\n\n    pip2.7 install virtualenv\n\n    yum install mysql-server mysql git openldap-devel cyrus-sasl-devel \\\n    mysql-devel\n\n\nInstall dependencies\n--------------------\n\nWe should use Virtualenv for isolated environments. The following commands will\nbe run as an unprivileged user in the product directory:\n\n1.Clone the repository:\n\n\n    git clone git@github.com:eea/art12-viewer.git -o origin art12\n    cd art12\n\n2.1.Create \u0026 activate a virtual environment:\n\n\n    virtualenv --no-site-packages sandbox\n    echo '*' \u003e sandbox/.gitignore\n    source sandbox/bin/activate\n\n2.2.Make sure setuptools \u003e= 0.8 is installed:\n\n    pip install -U setuptools\n\n3.Install dependencies:\n\n    pip install -r requirements-dep.txt\n\n4.Create a configuration file:\n\n    cd art12\n    mkdir -p instance\n    cp settings.py.example instance/settings.py\n\n    # Follow instructions in settings.py.example to adapt it to your needs.\n    # MAPS_PATH and MAPS_URI should be filled in according to your local deployment\n    # e.g: MAPS_PATH = '/Users/foo/art12/art12/static/maps/' MAPS_URI = '/static/maps/'\n\n5.Set up the MySQL database:\n\n    # Replace [user] and [password] with your MySQL credentials and [db_name] with the name of the database:\n    mysql -u[user] -p[password] -e 'create database [db_name] CHARACTER SET utf8 COLLATE utf8_general_ci;'\n    ./manage.py db upgrade\n\n\nTests\n----------------\n\n1. Run the application by starting docker containers:\n\n       docker-compose up -d\n\n2. Access the art12-mysql container:\n\n       docker exec -it art12.db bash\n\n3. Create the test database and grant all the privileges to the test user:\n\n        CREATE USER art12 WITH PASSWORD 'password';\n        CREATE DATABASE art12_test;\n        GRANT ALL PRIVILEGES ON DATABASE art12_test TO art12;\n        ALTER DATABASE art12_test OWNER TO art12;\n\n       create database art12test character set utf8 collate utf8_general_ci;\n       create user 'test'@'%' identified by 'test';\n       grant all privileges on art12test.* to 'test'@'%';\n\n\n4. Make sure to complete the data for environment variables in docker/art12.env file:\n\n       # test art12\n       DB_NAME_TEST=art12_test\n       DB_USER_TEST=art12\n       DB_PASSWORD_TEST=art12\n       DB_HOST_TEST=db\n\n5. Access the art12-app container:\n\n       docker exec -it art12-app bash\n\n6. Install dependencies:\n\n       pip install -r requirements-dev.txt\n\n7. Run tests:\n\n       pytest testsuite\n\n\nBuild production\n----------------\n\nSetup the production environment like this (using an unprivileged user)::\n\n    # install dependencies, see above\n    cd /var/local/art12\n    source sandbox/bin/activate\n\nAt this stage, the application is up and running. You should also configure:\n\n    * firewall policy\n    * public webserver (see vhost.conf.example for an example)\n    * start supervisord with the system (see init-svisor.example as an example\n      init script)\n\n\nBuild staging\n-------------\n\nTo setup a staging environment, follow the same steps as above. Create and use\na different database (for example ``art12staging``).\n\n\nFactsheet generator\n-------------------\n\nPrintouts work using `wkhtmltopdf 0.12.2.1`. Using an older version may cause\nproblems in rendering pdfs.\n\nIf you don't have this version installed, add it to your virtualenv.\n\n1. Go to http://wkhtmltopdf.org/downloads.html and select the build\n   corresponding with your system. Copy the direct link into your clipboard.\n\n2. Install it locally in your virtualenv\n\n    * For RedHat-based systems in production:\n\n            wget $PASTE_URL_COPIED_AT_STEP_1\n            # $PACKAGE is the file downloaded with wget\n            sudo rpm -i --prefix=/var/local/wkhtmltox-0.12.1 $PACKAGE.rpm\n            # If the command fails because the file is already installed\n            # copy `wkhtmltopdf` from the installation directory and skip\n            # the next command\n            cp /var/local/wkhtmltox-0.12.1/bin/wkhmtltopdf sandbox/bin/\n\n    * For RedHat-based development systems:\n\n            # If you don't work on projects that require other versions\n            # Install this version globally\n            wget $PASTE_URL_COPIED_AT_STEP_1\n            sudo rpm -i $PACKAGE.rpm\n\n    * For Debian based systems:\n\n            wget $PASTE_URL_COPIED_AT_STEP_1\n            dpkg-deb -x wkhtmltox-0.12.1_\u003cyour_distro\u003e.deb sandbox\n            cp sandbox/usr/local/bin/wkhtmltopdf sandbox/bin\n\n\nContacts\n========\n\n\nThe project owner is Alex Eftimie (alex.eftimie at eaudeweb.ro)\n\nOther people involved in this project are:\n\n* Mihai Zamfir (mihai.zamfir at eaudeweb.ro)\n\n\nResources\n=========\n\nHardware\n--------\n\nMinimum requirements:\n\n * 2048MB RAM\n * 2 CPU 1.8GHz or faster\n * 4GB hard disk space\n\nRecommended:\n\n * 4096MB RAM\n * 4 CPU 2.4GHz or faster\n * 8GB hard disk space\n\n\nSoftware\n--------\n\nAny recent Linux version.\napache2, local MySQL server\n\n\nCopyright and license\n=====================\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feea%2Fart12-viewer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feea%2Fart12-viewer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feea%2Fart12-viewer/lists"}