X Tutup
Skip to content

Commit 5a9ceba

Browse files
SaadBazazSaadBazaz
committed
docs: update readme with live demo
1 parent 1502e6d commit 5a9ceba

12 files changed

+440
-130
lines changed

‎.vscode/settings.json‎

Lines changed: 33 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,35 @@
11
{
2-
"latex-workshop.latex.build.forceRecipeUsage": false
2+
"latex-workshop.latex.build.forceRecipeUsage": false,
3+
"latex-workshop.latex.recipes": [
4+
{
5+
"name": "xelatex -> bibtex -> xelatex * 2",
6+
"tools": [
7+
"xelatex",
8+
"bibtex",
9+
"xelatex",
10+
"xelatex",
11+
]
12+
}
13+
],
14+
"latex-workshop.latex.tools": [
15+
{
16+
"name": "xelatex",
17+
"command": "xelatex",
18+
"args": [
19+
"-xelatex",
20+
"-synctex=1",
21+
"-interaction=nonstopmode",
22+
"-file-line-error",
23+
"%DOC%"
24+
]
25+
},
26+
{
27+
"name": "bibtex",
28+
"command": "bibtex",
29+
"args": [
30+
"%DOCFILE%"
31+
],
32+
"env": {}
33+
}
34+
]
335
}

‎CITATION.cff‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,5 @@ authors:
66
orcid: "https://orcid.org/0009-0000-1038-3410"
77
title: "UniversalPython - A Multilingual, Pythonic Programming Language"
88
version: 0.0.1
9-
doi: 10.5281/zenodo.1234
109
date-released: 2024-12-06
1110
url: "https://github.com/UniversalPython/UniversalPython"

‎README.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55

66
<div align="center">
77

8-
📖 [Documentation](https://universalpython.github.io/) | 🎯 [Examples](./urdupython/samples/) | 📄 [Research Paper](./paper/conference_101719.pdf)
8+
📖 [Documentation](https://universalpython.github.io/) | 🎯 [Examples](./urdupython/samples/) | 📄 [Research Paper](./paper/conference_101719.pdf) | 🔥 [Live demo (online)](https://universalpython.github.io/)
99

1010
**UniversalPython** is a transpiler that lets you write Python code in your own language. It translates your code into Python while keeping the syntax familiar.
1111

@@ -43,9 +43,13 @@ Install UniversalPython with pip:
4343
pip install -i urdupython
4444
```
4545

46+
### Online Playground
47+
48+
You can also try out UniversalPython in our [live online demo](https://universalpython.github.io/). It runs in your browser.
49+
4650
### Learn More
4751

48-
Check out the [documentation](https://universalpython.github.io/docs/).
52+
Check out the [documentation](https://universalpython.github.io/docs/intro).
4953

5054
## Join Us!
5155

‎paper/UniversalPython-flowchart.png‎

29.6 KB
Loading

‎paper/bibtex/IEEEexample.bib‎

Lines changed: 100 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -55,17 +55,108 @@
5555
full names. IEEEtran.bst will automatically abbreviate when it encounters
5656
full names.
5757
58-
59-
60-
58+
59+
60+
UniversalPython references
61+
@software{Hermans_Hedy_A_Gradual,
62+
author = {Hermans, Felienne},
63+
doi = {https://dl.acm.org/doi/10.1145/3372782.3406262},
64+
title = {{Hedy: A Gradual Language for Programming Education}}
65+
}
66+
67+
@software{Memon_UrduScript_2019,
68+
author = {Memon, Asad},
69+
month = aug,
70+
title = {{UrduScript}},
71+
url = "https://www.github.com/asadm/urduscript",
72+
version = {1.0.0},
73+
year = {2019}
74+
}
75+
76+
@software{Kalam_Programming_Language,
77+
author = {Kadam, Swanand},
78+
title = {Kalaam},
79+
version = {1.1.0},
80+
url = {https://github.com/Kalaam-Programming-Language/Kalaam},
81+
}
82+
83+
@book{buhmann2008mother,
84+
title={Mother tongue matters: Local language as a key to effective learning},
85+
author={B{\"u}hmann, D{\"o}rthe},
86+
year={2008},
87+
publisher={Unesco}
88+
}
89+
90+
@inproceedings{swidan2023framework,
91+
title={A Framework for the Localization of Programming Languages},
92+
author={Swidan, Alaaeddin and Hermans, Felienne},
93+
booktitle={Proceedings of the 2023 ACM SIGPLAN International Symposium on SPLASH-E},
94+
pages={13--25},
95+
year={2023}
96+
}
97+
98+
@article{taylor2015finding,
99+
title={Finding space for non-dominant languages in education: Language policy and medium of instruction in Timor-Leste 2000--2012},
100+
author={Taylor-Leech, Kerry},
101+
journal={Language Planning for Medium of Instruction in Asia},
102+
pages={119--136},
103+
year={2015},
104+
publisher={Routledge}
105+
}
106+
107+
@inproceedings{dasgupta2017learning,
108+
title={Learning to code in localized programming languages},
109+
author={Dasgupta, Sayamindu and Hill, Benjamin Mako},
110+
booktitle={Proceedings of the fourth (2017) ACM conference on learning@ scale},
111+
pages={33--39},
112+
year={2017}
113+
}
114+
115+
@inproceedings{otten2023towards,
116+
title={Towards a Universal Python: Translating the Natural Modality of Python into Other Human Languages},
117+
author={Otten, Joshua and Anastasopoulos, Antonios and Moran, Kevin},
118+
booktitle={2023 IEEE International Conference on Software Maintenance and Evolution (ICSME)},
119+
pages={352--357},
120+
year={2023},
121+
organization={IEEE}
122+
}
123+
124+
@techreport{zuse1963ansaetze,
125+
title = {Ansätze einer Theorie des allgemeinen Rechnens unter besonderer Berücksichtigung des Aussagenkalküls und dessen Anwendung auf Relaisschaltungen},
126+
author = {Zuse, Konrad},
127+
year = {1963},
128+
month = {12},
129+
institution = {Deutsches Museum},
130+
url = {https://digital.deutsches-museum.de/item/NL-207-0281/},
131+
note = {Typoskript. Vgl. NL 207/0211, NL 207/0219 u. NL 207/0222},
132+
}
133+
134+
@article{bauer1972plankalkul,
135+
title={The “Plankalk{\"u}l” of Konrad Zuse: a forerunner of today's programming languages},
136+
author={Bauer, Friedrich L. and W{\"o}ssner, Hans},
137+
journal={Communications of the ACM},
138+
volume={15},
139+
number={7},
140+
pages={678--685},
141+
year={1972},
142+
publisher={ACM New York, NY, USA}
143+
}
144+
145+
@article{backus1978history,
146+
title={The history of Fortran I, II, and III},
147+
author={Backus, John},
148+
journal={ACM Sigplan Notices},
149+
volume={13},
150+
number={8},
151+
pages={165--180},
152+
year={1978},
153+
publisher={ACM New York, NY, USA}
154+
}
155+
156+
/////////
157+
61158
references for the IEEEtran.bst documentation
62159
IEEEtran homepage
63-
@electronic{IEEEhowto:IEEEtranpage,
64-
author = "Michael Shell",
65-
title = "{IEEE}tran Homepage",
66-
url = "http://www.michaelshell.org/tex/ieeetran/",
67-
year = "2015"
68-
}
69160
70161
71162
the distribution site for IEEEtran.bst

‎paper/conference_101719.aux‎

Lines changed: 40 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,50 @@
11
\relax
22
\providecommand\zref@newlabel[2]{}
33
\ProvideDocumentCommand \selectlanguage {sO{}m}{}
4+
\citation{backus1978history}
5+
\citation{zuse1963ansaetze}
6+
\citation{bauer1972plankalkul}
7+
\citation{buhmann2008mother}
8+
\citation{taylor2015finding}
9+
\citation{dasgupta2017learning}
10+
\citation{swidan2023framework}
11+
\citation{otten2023towards}
12+
\citation{Kalam_Programming_Language}
13+
\citation{Hermans_Hedy_A_Gradual}
14+
\citation{Memon_UrduScript_2019}
15+
\citation{IEEEexample:tamethebeast}
416
\@writefile{toc}{\selectlanguage *[]{english}}
517
\@writefile{toc}{\contentsline {section}{\numberline {I}Introduction}{1}{}\protected@file@percent }
618
\@writefile{toc}{\contentsline {section}{\numberline {II}Related Work}{1}{}\protected@file@percent }
7-
\@writefile{toc}{\contentsline {subsection}{\numberline {\mbox {II-A}}Multilingual/Localized Programming Languages}{1}{}\protected@file@percent }
8-
\@writefile{toc}{\contentsline {subsection}{\numberline {\mbox {II-B}}Multilingual Programming Environments}{1}{}\protected@file@percent }
19+
\@writefile{toc}{\contentsline {subsection}{\numberline {\mbox {II-A}}Learning in your own language}{1}{}\protected@file@percent }
20+
\@writefile{toc}{\contentsline {subsection}{\numberline {\mbox {II-B}}Multilingual/Localized Programming Languages}{1}{}\protected@file@percent }
21+
\@writefile{toc}{\contentsline {subsection}{\numberline {\mbox {II-C}}Multilingual Programming Environments}{1}{}\protected@file@percent }
922
\@writefile{toc}{\contentsline {section}{\numberline {III}Design of UniversalPython}{1}{}\protected@file@percent }
23+
\@writefile{lof}{\setforeignlanguage {english}}
24+
\@writefile{lot}{\setforeignlanguage {english}}
25+
\@writefile{lof}{\contentsline {figure}{\numberline {1}{\ignorespaces A high-level abstraction of how the UniversalPython transpiler works.}}{2}{}\protected@file@percent }
26+
\newlabel{fig}{{1}{2}{}{}{}}
1027
\@writefile{toc}{\contentsline {section}{\numberline {IV}Experimentation}{2}{}\protected@file@percent }
11-
\@writefile{toc}{\contentsline {subsection}{\numberline {\mbox {IV-A}}Benchmarks with Python}{2}{}\protected@file@percent }
28+
\@writefile{toc}{\contentsline {subsection}{\numberline {\mbox {IV-A}}Evaluation metrics}{2}{}\protected@file@percent }
1229
\newlabel{AA}{{\mbox {IV-A}}{2}{}{}{}}
13-
\@writefile{toc}{\contentsline {section}{\numberline {V}Results}{2}{}\protected@file@percent }
14-
\bibcite{b1}{1}
15-
\bibcite{b2}{2}
16-
\bibcite{b3}{3}
17-
\bibcite{b4}{4}
18-
\bibcite{b5}{5}
19-
\bibcite{b6}{6}
20-
\bibcite{b7}{7}
21-
\@writefile{toc}{\contentsline {section}{\numberline {VI}Discussion and Future Work}{3}{}\protected@file@percent }
30+
\@writefile{toc}{\contentsline {subsection}{\numberline {\mbox {IV-B}}Benchmarks with Python}{2}{}\protected@file@percent }
31+
\newlabel{BB}{{\mbox {IV-B}}{2}{}{}{}}
32+
\bibstyle{bibtex/IEEEtran}
33+
\bibdata{bibtex/IEEEexample}
34+
\bibcite{backus1978history}{1}
35+
\bibcite{zuse1963ansaetze}{2}
36+
\@writefile{toc}{\contentsline {section}{\numberline {V}Results}{3}{}\protected@file@percent }
37+
\@writefile{toc}{\contentsline {section}{\numberline {VI}Limitations}{3}{}\protected@file@percent }
38+
\@writefile{toc}{\contentsline {section}{\numberline {VII}Future Work}{3}{}\protected@file@percent }
2239
\@writefile{toc}{\contentsline {section}{References}{3}{}\protected@file@percent }
23-
\gdef \@abspage@last{3}
40+
\bibcite{bauer1972plankalkul}{3}
41+
\bibcite{buhmann2008mother}{4}
42+
\bibcite{taylor2015finding}{5}
43+
\bibcite{dasgupta2017learning}{6}
44+
\bibcite{swidan2023framework}{7}
45+
\bibcite{otten2023towards}{8}
46+
\bibcite{Kalam_Programming_Language}{9}
47+
\bibcite{Hermans_Hedy_A_Gradual}{10}
48+
\bibcite{Memon_UrduScript_2019}{11}
49+
\bibcite{IEEEexample:tamethebeast}{12}
50+
\gdef \@abspage@last{4}

‎paper/conference_101719.bbl‎

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
% Generated by IEEEtran.bst, version: 1.14 (2015/08/26)
2+
\begin{thebibliography}{10}
3+
\providecommand{\url}[1]{#1}
4+
\csname url@samestyle\endcsname
5+
\providecommand{\newblock}{\relax}
6+
\providecommand{\bibinfo}[2]{#2}
7+
\providecommand{\BIBentrySTDinterwordspacing}{\spaceskip=0pt\relax}
8+
\providecommand{\BIBentryALTinterwordstretchfactor}{4}
9+
\providecommand{\BIBentryALTinterwordspacing}{\spaceskip=\fontdimen2\font plus
10+
\BIBentryALTinterwordstretchfactor\fontdimen3\font minus \fontdimen4\font\relax}
11+
\providecommand{\BIBforeignlanguage}[2]{{%
12+
\expandafter\ifx\csname l@#1\endcsname\relax
13+
\typeout{** WARNING: IEEEtran.bst: No hyphenation pattern has been}%
14+
\typeout{** loaded for the language `#1'. Using the pattern for}%
15+
\typeout{** the default language instead.}%
16+
\else
17+
\language=\csname l@#1\endcsname
18+
\fi
19+
#2}}
20+
\providecommand{\BIBdecl}{\relax}
21+
\BIBdecl
22+
23+
\bibitem{backus1978history}
24+
J.~Backus, ``The history of fortran i, ii, and iii,'' \emph{ACM Sigplan Notices}, vol.~13, no.~8, pp. 165--180, 1978.
25+
26+
\bibitem{zuse1963ansaetze}
27+
\BIBentryALTinterwordspacing
28+
K.~Zuse, ``Ansätze einer theorie des allgemeinen rechnens unter besonderer berücksichtigung des aussagenkalküls und dessen anwendung auf relaisschaltungen,'' Deutsches Museum, Tech. Rep., 12 1963, typoskript. Vgl. NL 207/0211, NL 207/0219 u. NL 207/0222. [Online]. Available: \url{https://digital.deutsches-museum.de/item/NL-207-0281/}
29+
\BIBentrySTDinterwordspacing
30+
31+
\bibitem{bauer1972plankalkul}
32+
F.~L. Bauer and H.~W{\"o}ssner, ``The “plankalk{\"u}l” of konrad zuse: a forerunner of today's programming languages,'' \emph{Communications of the ACM}, vol.~15, no.~7, pp. 678--685, 1972.
33+
34+
\bibitem{buhmann2008mother}
35+
D.~B{\"u}hmann, \emph{Mother tongue matters: Local language as a key to effective learning}.\hskip 1em plus 0.5em minus 0.4em\relax Unesco, 2008.
36+
37+
\bibitem{taylor2015finding}
38+
K.~Taylor-Leech, ``Finding space for non-dominant languages in education: Language policy and medium of instruction in timor-leste 2000--2012,'' \emph{Language Planning for Medium of Instruction in Asia}, pp. 119--136, 2015.
39+
40+
\bibitem{dasgupta2017learning}
41+
S.~Dasgupta and B.~M. Hill, ``Learning to code in localized programming languages,'' in \emph{Proceedings of the fourth (2017) ACM conference on learning@ scale}, 2017, pp. 33--39.
42+
43+
\bibitem{swidan2023framework}
44+
A.~Swidan and F.~Hermans, ``A framework for the localization of programming languages,'' in \emph{Proceedings of the 2023 ACM SIGPLAN International Symposium on SPLASH-E}, 2023, pp. 13--25.
45+
46+
\bibitem{otten2023towards}
47+
J.~Otten, A.~Anastasopoulos, and K.~Moran, ``Towards a universal python: Translating the natural modality of python into other human languages,'' in \emph{2023 IEEE International Conference on Software Maintenance and Evolution (ICSME)}.\hskip 1em plus 0.5em minus 0.4em\relax IEEE, 2023, pp. 352--357.
48+
49+
\bibitem{Kalam_Programming_Language}
50+
\BIBentryALTinterwordspacing
51+
S.~Kadam, ``Kalaam.'' [Online]. Available: \url{https://github.com/Kalaam-Programming-Language/Kalaam}
52+
\BIBentrySTDinterwordspacing
53+
54+
\bibitem{Hermans_Hedy_A_Gradual}
55+
F.~Hermans, ``{Hedy: A Gradual Language for Programming Education}.''
56+
57+
\bibitem{Memon_UrduScript_2019}
58+
\BIBentryALTinterwordspacing
59+
A.~Memon, ``{UrduScript},'' Aug. 2019. [Online]. Available: \url{https://www.github.com/asadm/urduscript}
60+
\BIBentrySTDinterwordspacing
61+
62+
\bibitem{IEEEexample:tamethebeast}
63+
\BIBentryALTinterwordspacing
64+
N.~Markey. (2009, Oct.) Tame the beast --- the b to x of {{\BibTeX}}. [Online]. Available: \url{http://www.ctan.org/pkg/tamethebeast}
65+
\BIBentrySTDinterwordspacing
66+
67+
\end{thebibliography}

‎paper/conference_101719.blg‎

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
1+
This is BibTeX, Version 0.99d (TeX Live 2024)
2+
Capacity: max_strings=200000, hash_size=200000, hash_prime=170003
3+
The top-level auxiliary file: conference_101719.aux
4+
The style file: bibtex/IEEEtran.bst
5+
Reallocated singl_function (elt_size=4) to 100 items from 50.
6+
Reallocated singl_function (elt_size=4) to 100 items from 50.
7+
Reallocated singl_function (elt_size=4) to 100 items from 50.
8+
Reallocated wiz_functions (elt_size=4) to 6000 items from 3000.
9+
Reallocated singl_function (elt_size=4) to 100 items from 50.
10+
Database file #1: bibtex/IEEEexample.bib
11+
Warning--entry type for "Hermans_Hedy_A_Gradual" isn't style-file defined
12+
--line 61 of file bibtex/IEEEexample.bib
13+
Warning--entry type for "Memon_UrduScript_2019" isn't style-file defined
14+
--line 67 of file bibtex/IEEEexample.bib
15+
Warning--entry type for "Kalam_Programming_Language" isn't style-file defined
16+
--line 76 of file bibtex/IEEEexample.bib
17+
-- IEEEtran.bst version 1.14 (2015/08/26) by Michael Shell.
18+
-- http://www.michaelshell.org/tex/ieeetran/bibtex/
19+
-- See the "IEEEtran_bst_HOWTO.pdf" manual for usage information.
20+
21+
Done.
22+
You've used 12 entries,
23+
4087 wiz_defined-function locations,
24+
895 strings with 9428 characters,
25+
and the built_in function-call counts, 7286 in all, are:
26+
= -- 585
27+
> -- 116
28+
< -- 54
29+
+ -- 66
30+
- -- 17
31+
* -- 320
32+
:= -- 1161
33+
add.period$ -- 25
34+
call.type$ -- 12
35+
change.case$ -- 12
36+
chr.to.int$ -- 132
37+
cite$ -- 12
38+
duplicate$ -- 531
39+
empty$ -- 633
40+
format.name$ -- 21
41+
if$ -- 1669
42+
int.to.chr$ -- 0
43+
int.to.str$ -- 12
44+
missing$ -- 94
45+
newline$ -- 67
46+
num.names$ -- 12
47+
pop$ -- 229
48+
preamble$ -- 1
49+
purify$ -- 0
50+
quote$ -- 2
51+
skip$ -- 569
52+
stack$ -- 0
53+
substring$ -- 320
54+
swap$ -- 402
55+
text.length$ -- 10
56+
text.prefix$ -- 0
57+
top$ -- 5
58+
type$ -- 12
59+
warning$ -- 0
60+
while$ -- 36
61+
width$ -- 14
62+
write$ -- 135
63+
(There were 3 warnings)

0 commit comments

Comments
 (0)
X Tutup