summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorCoprDistGit <infra@openeuler.org>2023-06-20 09:29:26 +0000
committerCoprDistGit <infra@openeuler.org>2023-06-20 09:29:26 +0000
commit07ef379722b0b2294ff4ac0b1bb105d18a74f96a (patch)
tree94b965207dc8594ab0ef4970e910ac3d12e27afd
parent6072bf2213d6b2c5f8e5529d9d1066b58c265ce5 (diff)
automatic import of python-avantpyopeneuler20.03
-rw-r--r--.gitignore1
-rw-r--r--python-avantpy.spec403
-rw-r--r--sources1
3 files changed, 405 insertions, 0 deletions
diff --git a/.gitignore b/.gitignore
index e69de29..d210514 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/avantpy-0.0.15.tar.gz
diff --git a/python-avantpy.spec b/python-avantpy.spec
new file mode 100644
index 0000000..a23e125
--- /dev/null
+++ b/python-avantpy.spec
@@ -0,0 +1,403 @@
+%global _empty_manifest_terminate_build 0
+Name: python-avantpy
+Version: 0.0.15
+Release: 1
+Summary: Python with training wheels: executable pseudocode in any language.
+License: MIT License
+URL: https://github.com/aroberge/avantpy
+Source0: https://mirrors.aliyun.com/pypi/web/packages/cb/db/3cd8548b740cc6b43250d27b4231c8008cea953b5c3bc871bff550ac8107/avantpy-0.0.15.tar.gz
+BuildArch: noarch
+
+Requires: python3-friendly-traceback
+
+%description
+# AvantPy
+
+Python with **training wheels**: _executable pseudocode_ in any language.
+
+:warning: On April 7th, I decided decided to carve out the part of this project dealing with
+simplified tracebacks into a project of its own. **For the next few weeks, I will temporarily
+stop working on AvantPy.** Work will resume when "friendly-traceback" is substantially complete.
+
+Those interested should go to https://aroberge.github.io/friendly-traceback-docs/docs/html/index.html (Code at: https://github.com/aroberge/friendly-traceback)
+
+Please see https://aroberge.github.io/avantpy/docs/html/ for more information, including for those
+who wish to contribute or file issues.
+AvantPy uses Black.
+![Black logo](https://img.shields.io/badge/code%20style-black-000000.svg)
+
+## What is AvantPy
+
+- AvantPy is a collection of dialects, each dialect being a superset of Python, designed to make it easier to learn programming concepts in a given human language.
+ - Each dialect consists of a translations of most Python keywords in a given human language, supplemented by a few additional constructs intended to make some programming concepts easier to learn.
+ - The current version includes three dialects: English, French and Spanish.
+ The translation currently done is subject to change; feel free to make suggestions for alternative to use.
+- AvantPy is a preprocessor, that takes a program written either totally or
+in parts in a given dialect, and converts it to standard Python prior to execution.
+ - A syntactically valid program can include a mix of code written in normal Python and in a specific dialect. This is to ease the transition to learning Python.
+- AvantPy is written as a standard Python module/package meant to be usable with any "normal" Python environment. Thus, it could be included as a plugin for a given
+editor, or run with a standard Python interpreter from the command line.
+- AvantPy also includes a tool to convert programs written in a given dialect into standard Python, showing the differences between the two, thus helping motivated users to make the transition to using only standard Python.
+- AvantPy also includes a custom REPL that can use any of the existing dialects.
+
+AvantPy uses [Friendly-traceback](https://aroberge.github.io/friendly-traceback-docs/docs/html/) to process Python tracebacks and translate them into easier to understand feedback for beginners.
+
+## Who is it for
+
+The main target audience is composed of students who do not know English and are learning programming for the first time, under the guidance of an
+instructor.
+
+## Executable pseudocode
+
+Python is often described as executable pseudocode. Once people have learned a few idiomatic expressions, like `for variable in range(n)`, translating pseudocode written in English into Python is usually very straightforward.
+
+If the pseudocode is not written in English, the translation process is, at least initially, not as straightforward since an additional mental step is required by the translation from the original language into Python's English.
+
+Even though the number of Python keywords is small, for absolute beginners who are learning programming concepts (control flow structures, defining functions, etc.), being able to use a language that uses keywords easily understood in their own language can definitely facilitate the learning process.
+**This is the approach taken by people using block-based environment
+(Scratch, Blockly, etc.) developed by educational experts
+to help students learn programming concepts.**
+
+Realistically, many students who learn computer programming as part of a formal course might never use programming again or, if so, it might not be for many years. Given enough time, they would likely forget most of the programming syntax they had learned.
+However they likely would retain programming **concepts** better if they are first learning them in their natural language.
+
+## What is meant by training wheels
+
+To help beginners learning how to ride a bicycle, one sometimes uses [training wheels](https://en.wikipedia.org/wiki/Training_wheels). After a while, the new cyclists ride
+their bicycles without the training wheels needing to touch the ground to offer
+additional support. This is similar to what AvantPy aims to do for learning Python.
+
+Imagine that I am a French speaker that learns to program using AvantPy.
+My first program might be:
+
+```py
+imprime("Bonjour !")
+```
+
+A while later, I might write a program like the following:
+
+```py
+si commande == 'q'
+ imprime("Au revoir !")
+```
+
+When I would try to execute such a program, I would get the following error message:
+
+```txt
+Il y a une erreur de syntaxe dans ce programme dans la ligne contenant le code suivant:
+
+ si commande == 'q'
+
+Une instruction débutant avec le mot "si" doit terminer par deux points (:).
+[Voir documentation-si.]
+```
+
+The equivalent English version would be
+
+```txt
+There is a syntax error in this program at the line containing the following code:
+
+ if commande == 'q'
+
+A statement beginning with the word "if" must end with a colon (:).
+[Relevant link to the documentation on "if" provided here.]
+```
+
+Eventually, I might want to learn some "true" Python code.
+Along the way, I would make use of a tool provided to show me the
+true Python code corresponding to the code written in my given dialect:
+
+```py
+if commande == 'q': # si commande == 'q':
+ print("Au revoir !") # imprime("Au revoir !")
+```
+
+and feel ready to leave AvantPy and only write Python.
+
+
+## Code of Conduct
+
+We completely support the [Python Community Code of Conduct](https://www.python.org/psf/codeofconduct/)
+Contributors to this project are expected to do the same.
+
+
+
+
+%package -n python3-avantpy
+Summary: Python with training wheels: executable pseudocode in any language.
+Provides: python-avantpy
+BuildRequires: python3-devel
+BuildRequires: python3-setuptools
+BuildRequires: python3-pip
+%description -n python3-avantpy
+# AvantPy
+
+Python with **training wheels**: _executable pseudocode_ in any language.
+
+:warning: On April 7th, I decided decided to carve out the part of this project dealing with
+simplified tracebacks into a project of its own. **For the next few weeks, I will temporarily
+stop working on AvantPy.** Work will resume when "friendly-traceback" is substantially complete.
+
+Those interested should go to https://aroberge.github.io/friendly-traceback-docs/docs/html/index.html (Code at: https://github.com/aroberge/friendly-traceback)
+
+Please see https://aroberge.github.io/avantpy/docs/html/ for more information, including for those
+who wish to contribute or file issues.
+AvantPy uses Black.
+![Black logo](https://img.shields.io/badge/code%20style-black-000000.svg)
+
+## What is AvantPy
+
+- AvantPy is a collection of dialects, each dialect being a superset of Python, designed to make it easier to learn programming concepts in a given human language.
+ - Each dialect consists of a translations of most Python keywords in a given human language, supplemented by a few additional constructs intended to make some programming concepts easier to learn.
+ - The current version includes three dialects: English, French and Spanish.
+ The translation currently done is subject to change; feel free to make suggestions for alternative to use.
+- AvantPy is a preprocessor, that takes a program written either totally or
+in parts in a given dialect, and converts it to standard Python prior to execution.
+ - A syntactically valid program can include a mix of code written in normal Python and in a specific dialect. This is to ease the transition to learning Python.
+- AvantPy is written as a standard Python module/package meant to be usable with any "normal" Python environment. Thus, it could be included as a plugin for a given
+editor, or run with a standard Python interpreter from the command line.
+- AvantPy also includes a tool to convert programs written in a given dialect into standard Python, showing the differences between the two, thus helping motivated users to make the transition to using only standard Python.
+- AvantPy also includes a custom REPL that can use any of the existing dialects.
+
+AvantPy uses [Friendly-traceback](https://aroberge.github.io/friendly-traceback-docs/docs/html/) to process Python tracebacks and translate them into easier to understand feedback for beginners.
+
+## Who is it for
+
+The main target audience is composed of students who do not know English and are learning programming for the first time, under the guidance of an
+instructor.
+
+## Executable pseudocode
+
+Python is often described as executable pseudocode. Once people have learned a few idiomatic expressions, like `for variable in range(n)`, translating pseudocode written in English into Python is usually very straightforward.
+
+If the pseudocode is not written in English, the translation process is, at least initially, not as straightforward since an additional mental step is required by the translation from the original language into Python's English.
+
+Even though the number of Python keywords is small, for absolute beginners who are learning programming concepts (control flow structures, defining functions, etc.), being able to use a language that uses keywords easily understood in their own language can definitely facilitate the learning process.
+**This is the approach taken by people using block-based environment
+(Scratch, Blockly, etc.) developed by educational experts
+to help students learn programming concepts.**
+
+Realistically, many students who learn computer programming as part of a formal course might never use programming again or, if so, it might not be for many years. Given enough time, they would likely forget most of the programming syntax they had learned.
+However they likely would retain programming **concepts** better if they are first learning them in their natural language.
+
+## What is meant by training wheels
+
+To help beginners learning how to ride a bicycle, one sometimes uses [training wheels](https://en.wikipedia.org/wiki/Training_wheels). After a while, the new cyclists ride
+their bicycles without the training wheels needing to touch the ground to offer
+additional support. This is similar to what AvantPy aims to do for learning Python.
+
+Imagine that I am a French speaker that learns to program using AvantPy.
+My first program might be:
+
+```py
+imprime("Bonjour !")
+```
+
+A while later, I might write a program like the following:
+
+```py
+si commande == 'q'
+ imprime("Au revoir !")
+```
+
+When I would try to execute such a program, I would get the following error message:
+
+```txt
+Il y a une erreur de syntaxe dans ce programme dans la ligne contenant le code suivant:
+
+ si commande == 'q'
+
+Une instruction débutant avec le mot "si" doit terminer par deux points (:).
+[Voir documentation-si.]
+```
+
+The equivalent English version would be
+
+```txt
+There is a syntax error in this program at the line containing the following code:
+
+ if commande == 'q'
+
+A statement beginning with the word "if" must end with a colon (:).
+[Relevant link to the documentation on "if" provided here.]
+```
+
+Eventually, I might want to learn some "true" Python code.
+Along the way, I would make use of a tool provided to show me the
+true Python code corresponding to the code written in my given dialect:
+
+```py
+if commande == 'q': # si commande == 'q':
+ print("Au revoir !") # imprime("Au revoir !")
+```
+
+and feel ready to leave AvantPy and only write Python.
+
+
+## Code of Conduct
+
+We completely support the [Python Community Code of Conduct](https://www.python.org/psf/codeofconduct/)
+Contributors to this project are expected to do the same.
+
+
+
+
+%package help
+Summary: Development documents and examples for avantpy
+Provides: python3-avantpy-doc
+%description help
+# AvantPy
+
+Python with **training wheels**: _executable pseudocode_ in any language.
+
+:warning: On April 7th, I decided decided to carve out the part of this project dealing with
+simplified tracebacks into a project of its own. **For the next few weeks, I will temporarily
+stop working on AvantPy.** Work will resume when "friendly-traceback" is substantially complete.
+
+Those interested should go to https://aroberge.github.io/friendly-traceback-docs/docs/html/index.html (Code at: https://github.com/aroberge/friendly-traceback)
+
+Please see https://aroberge.github.io/avantpy/docs/html/ for more information, including for those
+who wish to contribute or file issues.
+AvantPy uses Black.
+![Black logo](https://img.shields.io/badge/code%20style-black-000000.svg)
+
+## What is AvantPy
+
+- AvantPy is a collection of dialects, each dialect being a superset of Python, designed to make it easier to learn programming concepts in a given human language.
+ - Each dialect consists of a translations of most Python keywords in a given human language, supplemented by a few additional constructs intended to make some programming concepts easier to learn.
+ - The current version includes three dialects: English, French and Spanish.
+ The translation currently done is subject to change; feel free to make suggestions for alternative to use.
+- AvantPy is a preprocessor, that takes a program written either totally or
+in parts in a given dialect, and converts it to standard Python prior to execution.
+ - A syntactically valid program can include a mix of code written in normal Python and in a specific dialect. This is to ease the transition to learning Python.
+- AvantPy is written as a standard Python module/package meant to be usable with any "normal" Python environment. Thus, it could be included as a plugin for a given
+editor, or run with a standard Python interpreter from the command line.
+- AvantPy also includes a tool to convert programs written in a given dialect into standard Python, showing the differences between the two, thus helping motivated users to make the transition to using only standard Python.
+- AvantPy also includes a custom REPL that can use any of the existing dialects.
+
+AvantPy uses [Friendly-traceback](https://aroberge.github.io/friendly-traceback-docs/docs/html/) to process Python tracebacks and translate them into easier to understand feedback for beginners.
+
+## Who is it for
+
+The main target audience is composed of students who do not know English and are learning programming for the first time, under the guidance of an
+instructor.
+
+## Executable pseudocode
+
+Python is often described as executable pseudocode. Once people have learned a few idiomatic expressions, like `for variable in range(n)`, translating pseudocode written in English into Python is usually very straightforward.
+
+If the pseudocode is not written in English, the translation process is, at least initially, not as straightforward since an additional mental step is required by the translation from the original language into Python's English.
+
+Even though the number of Python keywords is small, for absolute beginners who are learning programming concepts (control flow structures, defining functions, etc.), being able to use a language that uses keywords easily understood in their own language can definitely facilitate the learning process.
+**This is the approach taken by people using block-based environment
+(Scratch, Blockly, etc.) developed by educational experts
+to help students learn programming concepts.**
+
+Realistically, many students who learn computer programming as part of a formal course might never use programming again or, if so, it might not be for many years. Given enough time, they would likely forget most of the programming syntax they had learned.
+However they likely would retain programming **concepts** better if they are first learning them in their natural language.
+
+## What is meant by training wheels
+
+To help beginners learning how to ride a bicycle, one sometimes uses [training wheels](https://en.wikipedia.org/wiki/Training_wheels). After a while, the new cyclists ride
+their bicycles without the training wheels needing to touch the ground to offer
+additional support. This is similar to what AvantPy aims to do for learning Python.
+
+Imagine that I am a French speaker that learns to program using AvantPy.
+My first program might be:
+
+```py
+imprime("Bonjour !")
+```
+
+A while later, I might write a program like the following:
+
+```py
+si commande == 'q'
+ imprime("Au revoir !")
+```
+
+When I would try to execute such a program, I would get the following error message:
+
+```txt
+Il y a une erreur de syntaxe dans ce programme dans la ligne contenant le code suivant:
+
+ si commande == 'q'
+
+Une instruction débutant avec le mot "si" doit terminer par deux points (:).
+[Voir documentation-si.]
+```
+
+The equivalent English version would be
+
+```txt
+There is a syntax error in this program at the line containing the following code:
+
+ if commande == 'q'
+
+A statement beginning with the word "if" must end with a colon (:).
+[Relevant link to the documentation on "if" provided here.]
+```
+
+Eventually, I might want to learn some "true" Python code.
+Along the way, I would make use of a tool provided to show me the
+true Python code corresponding to the code written in my given dialect:
+
+```py
+if commande == 'q': # si commande == 'q':
+ print("Au revoir !") # imprime("Au revoir !")
+```
+
+and feel ready to leave AvantPy and only write Python.
+
+
+## Code of Conduct
+
+We completely support the [Python Community Code of Conduct](https://www.python.org/psf/codeofconduct/)
+Contributors to this project are expected to do the same.
+
+
+
+
+%prep
+%autosetup -n avantpy-0.0.15
+
+%build
+%py3_build
+
+%install
+%py3_install
+install -d -m755 %{buildroot}/%{_pkgdocdir}
+if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
+if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
+if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
+if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
+pushd %{buildroot}
+if [ -d usr/lib ]; then
+ find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
+fi
+if [ -d usr/lib64 ]; then
+ find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
+fi
+if [ -d usr/bin ]; then
+ find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
+fi
+if [ -d usr/sbin ]; then
+ find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
+fi
+touch doclist.lst
+if [ -d usr/share/man ]; then
+ find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
+fi
+popd
+mv %{buildroot}/filelist.lst .
+mv %{buildroot}/doclist.lst .
+
+%files -n python3-avantpy -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Tue Jun 20 2023 Python_Bot <Python_Bot@openeuler.org> - 0.0.15-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..1564992
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+cfa67537e066e2b811d4da7849c9c438 avantpy-0.0.15.tar.gz