mumuki-python-runner 1.10.0 → 1.10.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbc061e567fe9908248e887785edd1eff8e58b4476d100f8038a92b8c8c5a67f
-  data.tar.gz: 6e9cbf4ee3c0f325c3c069449749b22179f17186f66e2fee905db0cf2ce412e7
+  metadata.gz: cfe4c1b7c4a05396eff95054475016150f8625f9986a7470e7ae3616c2ac74ea
+  data.tar.gz: c2c69063f8ce3905dcca15c0b8c9bbcefcb6ebc28be1d92fb4780f29b97f3b25
 SHA512:
-  metadata.gz: 3fb0ca410a3646ac41ceab49250378b89b705879102f26f02537e71b2c94d6cac2798cbf5d4ecec0a015f383ae30a916abfb48f12cb01430ba9b2b96b4a1f976
-  data.tar.gz: 942566870256f6f55aeb68e74f135118a0be9de3b6adc39f088f60a6117a00e9cd8150ee514311b9b09d421a2d160934694f94fb6de02bb0daa87b17584a65f4
+  metadata.gz: 3661eefa8f35a6992f4632893ef87d04f888c0f56076b73a4a7793d329f37e4a5dda9e09526e14ae1f33e940d8b628966d0da5f2d840163bf9d84600e30a1e43
+  data.tar.gz: 0b248d700f5a711514f76a34310ef9b2598e6d04d68bffe7cb54d6f59a9404d93949785d3cf4826c0d44f1461b43bca4e9ab08271dd41cfc7642ef686890dc75

data/lib/base/version.rb

@@ -1,4 +1,4 @@
 
 module BasePythonVersionHook
-  VERSION = '1.10.0'
+  VERSION = '1.10.2'
 end

data/lib/python3/metadata_hook.rb

@@ -1,16 +1,20 @@
 class Python3MetadataHook < BasePythonMetadataHook
+  def self.read_xce_file(path)
+    File.read(File.expand_path "../../../xce/#{path}", __FILE__)
+  end
+
   XCE_INSTRUCTIONS = {
     'Colab': {
-      'en': File.read("xce/colab/en/README.md"),
-      'pt': File.read("xce/colab/pt/README.md"),
-      'es': File.read("xce/colab/es-ar/README.md"),
-      'es-ar': File.read("xce/colab/es-ar/README.md")
+      'en': read_xce_file('colab/en/README.md'),
+      'pt': read_xce_file('colab/pt/README.md'),
+      'es': read_xce_file('colab/es-ar/README.md'),
+      'es-ar': read_xce_file('colab/es-ar/README.md')
     },
     'Visual Studio Code': {
-      'en': File.read("xce/visual_studio/en/README.md"),
-      'pt': File.read("xce/visual_studio/pt/README.md"),
-      'es': File.read("xce/visual_studio/es-ar/README.md"),
-      'es-ar': File.read("xce/visual_studio/es-ar/README.md")
+      'en': read_xce_file('visual_studio/en/README.md'),
+      'pt': read_xce_file('visual_studio/pt/README.md'),
+      'es': read_xce_file('visual_studio/es-ar/README.md'),
+      'es-ar': read_xce_file('visual_studio/es-ar/README.md')
     }
   }
 

data/xce/colab/en/README.md

@@ -0,0 +1,31 @@
+### Login into Colab
+
+In order to solve exercises like this, you will need to create an account and login into [`Colab`](https://colab.research.google.com/) first.
+
+### Solving an exercise
+
+First, create a cell with the following code:
+
+```python
+!pip install mumuki-xce
+
+from mumuki import IMumuki
+mumuki = IMumuki("#...token...#", "#...locale...#")
+mumuki.visit("#...organization...#", "#...exercise_id...#")
+```
+
+Then create another cell, whose first line must be `%%solution`. Right after it, write down your solution inside it:
+
+```python
+%%solution
+
+# your solution goes here
+```
+
+Edit and execute that cell as many times as you need and feel free to do all the tests you need. When you are done, add a new cell after it and enter the following code:
+
+```python
+mumuki.test()
+```
+
+By executing that line you will submit your solution and will get feedback of it. If you make changes to your code, don't forget to re-execute the corresponding cells. Good luck!

data/xce/colab/es-ar/README.md

@@ -0,0 +1,31 @@
+### Ingreso a Colab
+
+Para poder resolver ejercicios como éste, necesitarás ingresar a [`Colab`](https://colab.research.google.com/). ¡Asegurate de haber iniciado sesión!
+
+### Resolución de un ejercicio
+
+Primero, creá una celda con el siguiente código:
+
+```python
+!pip install mumuki-xce
+
+from mumuki import IMumuki
+mumuki = IMumuki("#...token...#", "#...locale...#")
+mumuki.visit("#...organization...#", "#...exercise_id...#")
+```
+
+Luego creá otra celda, cuya primera línea debe ser `%%solution` y comenzá a escribir tu solución dentro de ella:
+
+```python
+%%solution
+
+# tu solución va acá
+```
+
+Editá y ejecutá la celda cuantas veces necesites y no dudes en hacer todas las pruebas que hagan falta. Y finalmente, cuando quieras enviar tu solución, escribí en otra celda lo siguiente:
+
+```python
+mumuki.test()
+```
+
+Si hacés modificaciones a tu código, no olvides volver a ejecutar las celdas correspondientes. ¡Éxitos!

data/xce/colab/pt/README.md

@@ -0,0 +1,31 @@
+### Login no Colab
+
+Para resolver exercícios como este, você precisará fazer login no [`Colab`](https://colab.research.google.com/).
+
+### Resolvendo um exercício
+
+Primeiro, crie uma célula com o seguinte código:
+
+```python
+!pip install mumuki-xce
+
+from mumuki import IMumuki
+mumuki = IMumuki("#...token...#", "#. . .locale...#")
+mumuki.visit("#...organization...#", "#...exercise_id...#")
+```
+
+Em seguida, crie outra célula, cuja primeira linha deve ser ` %%solution` e comece a escrever sua solução dentro dela:
+
+```python
+%%solution
+
+# sua solução vai aqui
+```
+
+Edite e execute a célula quantas vezes precisar e fique à vontade para fazer todos os testes que precisar. E finalmente, quando você quiser enviar sua solução, escreva em outra célula o seguinte:
+
+```python
+mumuki.test()
+```
+
+Se você fizer alterações em seu código, não se esqueça de executar novamente as células correspondentes. Boa sorte!

data/xce/visual_studio/en/README.md

@@ -0,0 +1,35 @@
+### Environment setup
+
+You will need to use `python` and `pip` in order to solve exercises like this. Please ensure you have those commands locally installed in your computer. Then install `mumuki-xce`:
+
+```shell
+pip install mumuki-xce
+```
+
+Now you are ready to solve exercises!
+
+### Solving an exercise
+
+Just create a new python file with `py` extension, and paste the following code in it:
+
+```python
+from mumuki import Mumuki
+mumuki = Mumuki("#...token...#", "#...locale...#")
+mumuki.visit("#...organization...#", "#...exercise_id...#")
+
+# ...place your solution here...
+
+mumuki.test()
+```
+
+If you want to submit your solution, just run on your terminal
+
+```bash
+python your_file.py
+```
+
+If you just want to load it into a node interpreter and test and play with your code, run:
+
+```bash
+python -i your_file.py
+```

data/xce/visual_studio/es-ar/README.md

@@ -0,0 +1,37 @@
+### Preparación del entorno
+
+Para poder resolver ejercicios como éste, necesitarás utilizar los comandos `python` y `pip`. Antes de comenzar, asegurate de tenerlos instalados. Después, ejecutá el siguiente comando, por única vez (si ya lo hiciste anteriormente, podés saltar al siguente paso):
+
+```shell
+pip install mumuki-xce
+```
+
+¡Ya podés empezar a resolver ejercicios!
+
+### Resolución de un ejercicio
+
+Creá un archivo con extensión `.py` en tu computadora y adentro copiá el siguiente código:
+
+```python
+from mumuki import Mumuki
+mumuki = Mumuki("#...token...#", "#...locale...#")
+mumuki.visit("#...organization...#", "#...exercise_id...#")
+
+# Escribí tu solución acá
+
+mumuki.test()
+```
+
+Si querés enviar tu solución, simplemente ejecutá en tu terminal lo siguiente:
+
+```bash
+python tu_archivo.py
+```
+
+Si en cambio querés cargar tu archivo en el intérprete de `python` para probarlo y jugar con sus funciones antes de enviarlas, ejecutá lo siguiente:
+
+```bash
+python -i tu_archivo.py
+```
+
+¡Éxitos!

data/xce/visual_studio/pt/README.md

@@ -0,0 +1,37 @@
+### Preparação do ambiente
+
+Para resolver exercícios como este, você precisará usar os comandos `python` e `pip`. Antes de começar, certifique-se de tê-los instalados. Então, execute o seguinte comando, apenas uma vez (se você já fez isso antes, você pode pular para o próximo passo):
+
+```shell
+pip install mumuki-xce
+```
+
+Agora você pode começar a resolver os exercícios!
+
+### Resolvendo um exercício
+
+Crie um arquivo com extensão `.py` em seu computador e copie o seguinte código dentro dele:
+
+```python
+from mumuki import Mumuki
+mumuki = Mumuki("#...token...#", " #...locale...#")
+mumuki.visit("#...organization...#", "#...exercise_id...#")
+
+# Escreva sua solução aqui
+
+mumuki.test()
+```
+
+Se você deseja enviar sua solução, basta executar o seguinte em seu terminal:
+
+```bash
+python your_file.py
+```
+
+Se, em vez disso, você deseja carregar seu arquivo no interpretador `python` para testá-lo e brincar com seu funções primeiro Depois de enviá-los, execute o seguinte:
+
+```bash
+python -i seu_arquivo.py
+```
+
+Boa sorte!

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: mumuki-python-runner
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.10.2
 platform: ruby
 authors:
 - Franco Leonardo Bulgarelli
@@ -157,6 +157,12 @@ files:
 - lib/python3/version.rb
 - lib/python3_runner.rb
 - lib/python_runner.rb
+- xce/colab/en/README.md
+- xce/colab/es-ar/README.md
+- xce/colab/pt/README.md
+- xce/visual_studio/en/README.md
+- xce/visual_studio/es-ar/README.md
+- xce/visual_studio/pt/README.md
 homepage: http://github.com/mumuki/mumuki-python-runner
 licenses:
 - MIT