Mise en correspondance de bitextes dans des langues différentes
See Pypi's ENPC-Aligner documentation here
-
SASS : http://sass-lang.com/guide
-
BEM with SASS : https://css-tricks.com/snippets/sass/bem-mixins/
-
Javascript : https://openclassrooms.com/courses/dynamisez-vos-sites-web-avec-javascript
-
Yarn : https://yarnpkg.com
-
Reactjs :
- https://openclassrooms.com/courses/build-web-apps-with-reactjs
- https://reactjs.org/tutorial/tutorial.html
- React-redux : https://redux.js.org/docs/basics/UsageWithReact.html
- Apollo Link : https://www.apollographql.com/docs/link/#apollo-client The HttpLink is a replacement for createNetworkInterface from Apollo Client 1.0
-
GraphQL :
-
Python : https://openclassrooms.com/courses/apprenez-a-programmer-en-python
-
Django : https://www.djangoproject.com
- Graphene-Django : http://docs.graphene-python.org/projects/django/en/latest/
- Pytest-django : https://pytest-django.readthedocs.io/en/latest/
- Django-cors-headers : https://github.com/ottoyiu/django-cors-headers
-
Docker : https://docs.docker.com/get-started/
Extra ressources :
- https://github.com/mbrochh/django-graphql-apollo-react-demo (admin pannel, testing, JWT authentication, routing parameters, error handling, filtering, pagination but with deprecated Apollo v1 networkInterface instead of Link)
- https://dev-blog.apollodata.com/full-stack-react-graphql-tutorial-582ac8d24e3b
- CORS : https://fr.wikipedia.org/wiki/Cross-origin_resource_sharing
- React-redux creator workflow : https://www.youtube.com/watch?v=xsSnOQynTHs
- GraphQL at Facebook :
- Ctypes : https://cvstuff.wordpress.com/2014/11/19/warping-c-libraries-with-python-ctypes/
Sous Debian ou dérivé, exécutez ./install-debian.sh
Pour voir le rapport de couverture, faire
cd back/
pytest --cov-report html --cov
Puis ouvrir htmlcov/index.html dans un navigateur.
Pour exécuter les tests:
cd back/
pytest
Run the Django web server :
cd back/
python manage.py runserver
Go to http://localhost:8000/graphiql and query for
{
all_bitexts {
title
texts {
language
paragraphs {
sentences {
content
}
}
}
}
}
Click on "docs" on the right-hand corner to go through the graph structure.
Run the Django web server and create an admin account :
cd back/
python manage.py createsuperuser
python manage.py runserver
Go to http://localhost:8000/admin
Apollo lets you automatically batch multiple queries into one request when they are made within a certain interval. This means that if you render several components, for example a navbar, sidebar, and content, and each of those do their own GraphQL query, they will all be sent in one roundtrip. Batching works only with server that support batched queries (for example graphql-server). Batched requests to servers that don’t support batching will fail. To learn how to use batching with Apollo checkout the indepth guide
from mixer.backend.django import mixer
# Generate model with some values
client = mixer.blend(Client, username='test')
assert client.username == 'test'
# Generate model with reference
message = mixer.blend(Message, client__username='test2')
assert message.client.username == 'test2'
# Value may be callable
client = mixer.blend(Client, username=lambda:'callable_value')
assert client.username == 'callable_value'
# Value may be a generator
clients = mixer.cycle(4).blend(Client, username=(name for name in ('Piter', 'John')))
# Value could be getting a counter
clients = mixer.cycle(4).blend(Client, username=mixer.sequence(lambda c: "test_%s" % c))
print clients[2].username # --> 'test_2'
# Short format for string formating
clients = mixer.cycle(4).blend(Client, username=mixer.sequence("test_{0}"))
print clients[2].username # --> 'test_2'
# Force to generation of a default (or null) values
client = mixer.blend(Client, score=mixer.RANDOM)
print client.score # Some like: --> 456
# Set related values from db by random
message = mixer.blend(Message, client=mixer.SELECT)
assert message.client in Client.objects.all()
Lazy loading routes : or use react-loadable instead
In React, we can lazy load components and routes by code splitting using Webpack. By splitting our app into chunks we can load & evaluate only the code that is required for the page rendered. A React app has routes/components that can use several React plugins. Without code splitting, all the React code and plugins in use will be bundled into one JavaScript file, but with code splitting, only the component/plugin needed would be loaded.
https://www.youtube.com/watch?v=tWp0oxbzZ3s
Execute
yarn global add serve
cd back/
python manage.py runserver
cd ../front/
yarn build
serve -s build
Go to http://localhost:3000
With the delorean ssh alias for the VPS, execute
cd front
yarn build
scp -r build/* delorean:/var/www/alignment
Reference : https://docs.djangoproject.com/en/1.11/howto/deployment/checklist/
Many of these settings are sensitive and should be treated as confidential. If you’re releasing the source code for your project, a common practice is to publish suitable settings for development, and to use a private settings module for production.
Reference : https://www.caktusgroup.com/blog/2017/03/14/production-ready-dockerfile-your-python-django-app/
Docker repo : https://hub.docker.com/r/philippefds/bitext-matching/
Image development :
docker build -t django-alignment . # ajouter *--no-cache* pour désactiver l'usage du cache
docker run -e DATABASE_URL=none -p 8000:8000 -t django-alignment
Useful commands :
docker container ls
docker stop back
docker exec -it back /bin/sh # /bin contient très peu de programmes sur Alpine Linux (optimisé pour la production), il y a /bin/sh mais pas /bin/bash !
docker cp file back:file
Image deployment :
docker pull philippefds/bitext-matching
- How it work : http://sametmax.com/quest-ce-que-wsgi-et-a-quoi-ca-sert/
- Gunicorn, uWSGI, or mod_wsgi : https://djangodeployment.com/2017/01/02/which-wsgi-server-should-i-use/
- Install on VPS : https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-django-with-postgres-nginx-and-gunicorn
References :
- Static Files : https://docs.djangoproject.com/fr/1.11/howto/static-files/
- Mod_wsgi : https://github.com/GrahamDumpleton/mod_wsgi
Add mod_wsgi to requirements.txt and 'mod_wsgi.server' to INSTALLED_APPS in settings
To prepare for running mod_wsgi-express, ensure that you first collect up any Django static file assets into the directory specified for them in the Django settings file:
python manage.py collectstatic
You can now run the Apache server with mod_wsgi hosting your Django application by running:
python manage.py runmodwsgi
If working in a development environment and you would like to have any code changes automatically reloaded, then you can use the --reload-on-changes option.
python manage.py runmodwsgi --reload-on-changes
If wanting to have Apache started as root in order to listen on port 80, instead of using mod_wsgi-express setup-server as described above, use the --setup-only option to the runmodwsgi management command.
python manage.py runmodwsgi --setup-only --port=80 \
--user www-data --group www-data \
--server-root=/etc/mod_wsgi-express-80
This will setup all the required files and you can use apachectl to start and stop the Apache instance as explained previously.
- React spinkits : https://github.com/KyleAMathews/react-spinkit (TODO)
- Semantic UI React : https://react.semantic-ui.com
http://delorean.fdesousa.fr:8000/graphiql?query={all_bitexts{title texts{language paragraphs{sentences {content}}}}} http://delorean.fdesousa.fr:8000/admin http://alignment.fdesousa.fr