18.xhtml 6.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115
  1. <?xml version="1.0" encoding="utf-8"?>
  2. <!--
  3. h t t :: / / t /
  4. h t t :: // // t //
  5. h ttttt ttttt ppppp sssss // // y y sssss ttttt //
  6. hhhh t t p p s // // y y s t //
  7. h hh t t ppppp sssss // // yyyyy sssss t //
  8. h h t t p s :: / / y .. s t .. /
  9. h h t t p sssss :: / / yyyyy .. sssss t .. /
  10. <https://y.st./>
  11. Copyright © 2016 Alex Yst <mailto:copyright@y.st>
  12. This program is free software: you can redistribute it and/or modify
  13. it under the terms of the GNU General Public License as published by
  14. the Free Software Foundation, either version 3 of the License, or
  15. (at your option) any later version.
  16. This program is distributed in the hope that it will be useful,
  17. but WITHOUT ANY WARRANTY; without even the implied warranty of
  18. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  19. GNU General Public License for more details.
  20. You should have received a copy of the GNU General Public License
  21. along with this program. If not, see <https://www.gnu.org./licenses/>.
  22. -->
  23. <!DOCTYPE html>
  24. <html xmlns="http://www.w3.org/1999/xhtml">
  25. <head>
  26. <base href="https://y.st./en/weblog/2016/01-January/18.xhtml" />
  27. <title>Removing wrapper classes &lt;https://y.st./en/weblog/2016/01-January/18.xhtml&gt;</title>
  28. <link rel="icon" type="image/png" href="/link/CC_BY-SA_4.0/y.st./icon.png" />
  29. <link rel="stylesheet" type="text/css" href="/link/basic.css" />
  30. <link rel="stylesheet" type="text/css" href="/link/site-specific.css" />
  31. <script type="text/javascript" src="/script/javascript.js" />
  32. <meta name="viewport" content="width=device-width" />
  33. </head>
  34. <body>
  35. <nav>
  36. <p>
  37. <a href="/en/">Home</a> |
  38. <a href="/en/a/about.xhtml">About</a> |
  39. <a href="/en/a/contact.xhtml">Contact</a> |
  40. <a href="/a/canary.txt">Canary</a> |
  41. <a href="/en/URI_research/"><abbr title="Uniform Resource Identifier">URI</abbr> research</a> |
  42. <a href="/en/opinion/">Opinions</a> |
  43. <a href="/en/coursework/">Coursework</a> |
  44. <a href="/en/law/">Law</a> |
  45. <a href="/en/a/links.xhtml">Links</a> |
  46. <a href="/en/weblog/2016/01-January/18.xhtml.asc">{this page}.asc</a>
  47. </p>
  48. <hr/>
  49. <p>
  50. Weblog index:
  51. <a href="/en/weblog/"><abbr title="American Standard Code for Information Interchange">ASCII</abbr> calendars</a> |
  52. <a href="/en/weblog/index_ol_ascending.xhtml">Ascending list</a> |
  53. <a href="/en/weblog/index_ol_descending.xhtml">Descending list</a>
  54. </p>
  55. <hr/>
  56. <p>
  57. Jump to entry:
  58. <a href="/en/weblog/2015/03-March/07.xhtml">&lt;&lt;First</a>
  59. <a rel="prev" href="/en/weblog/2016/01-January/17.xhtml">&lt;Previous</a>
  60. <a rel="next" href="/en/weblog/2016/01-January/19.xhtml">Next&gt;</a>
  61. <a href="/en/weblog/latest.xhtml">Latest&gt;&gt;</a>
  62. </p>
  63. <hr/>
  64. </nav>
  65. <header>
  66. <h1>Removing wrapper classes</h1>
  67. <p>Day 00317: Monday, 2016 January 18</p>
  68. </header>
  69. <p>
  70. I have decided to not only halt progress on my wrapper classes, but to backtrack.
  71. Simply put, I do not know which functions are worth wrapping in many cases, as I do not know which functions are even worth using.
  72. I do not need include.d to be cluttered with junk code.
  73. With that in mind, I am removing any wrapper class that I have never actually used, ass well as my dir wrapper class, which I feel is made obsolete by the built-in <code>\scandir()</code> function.
  74. </p>
  75. <p>
  76. I did not have much time this morning before leaving for Springfield, but I did start putting together a function to help me debug include.d.
  77. All the function really did was load all of include.d&apos;s functions, classes, and constants, which meant that any syntax errors would become immediately visible.
  78. However, on the way to Springfield, I decided to put together a battery of tests for the actual output of these functions and classes.
  79. Soon after, I decided that my initial function was kind of arbitrary as a function, and really belonged as part of the test code, so I downgraded my plans for the function itself.
  80. It would instead be just a set of loops in the test code and it would rely on a constant within include.d to know where include.d was so it could be recursed.
  81. By adding <code>const _DIR_ = __DIR__;</code> to include.d&apos;s constants file, I would have a way to tell the test suite where include.d&apos;s files were.
  82. By the end of the day though, I had realized that the test suite did not need include.d to be modified in any way.
  83. <code>stream_resolve_include_path(&apos;st/y&apos;)</code> would tell my test suite exactly where to find my functions and classes so that they all can be loaded.
  84. I feel that this is the cleanest way to make it work, as it does not rely on adding stupid hacks to include.d.
  85. I will of course still add individual test cases for each function and class, but this will mean that I will not have to remember to individually <code>require()</code> each of my functions.
  86. </p>
  87. <p>
  88. We did not get as much work done in Springfield as we wanted to, nor are we ready to rent that storage unit.
  89. Still, the planning that i was able to make for my test suite while working made the day worthwhile for me.
  90. </p>
  91. <p>
  92. My <a href="/a/canary.txt">canary</a> still sings the tune of freedom and transparency.
  93. </p>
  94. <hr/>
  95. <p>
  96. Copyright © 2016 Alex Yst;
  97. You may modify and/or redistribute this document under the terms of the <a rel="license" href="/license/gpl-3.0-standalone.xhtml"><abbr title="GNU&apos;s Not Unix">GNU</abbr> <abbr title="General Public License version Three or later">GPLv3+</abbr></a>.
  98. If for some reason you would prefer to modify and/or distribute this document under other free copyleft terms, please ask me via email.
  99. My address is in the source comments near the top of this document.
  100. This license also applies to embedded content such as images.
  101. For more information on that, see <a href="/en/a/licensing.xhtml">licensing</a>.
  102. </p>
  103. <p>
  104. <abbr title="World Wide Web Consortium">W3C</abbr> standards are important.
  105. This document conforms to the <a href="https://validator.w3.org./nu/?doc=https%3A%2F%2Fy.st.%2Fen%2Fweblog%2F2016%2F01-January%2F18.xhtml"><abbr title="Extensible Hypertext Markup Language">XHTML</abbr> 5.1</a> specification and uses style sheets that conform to the <a href="http://jigsaw.w3.org./css-validator/validator?uri=https%3A%2F%2Fy.st.%2Fen%2Fweblog%2F2016%2F01-January%2F18.xhtml"><abbr title="Cascading Style Sheets">CSS</abbr>3</a> specification.
  106. </p>
  107. </body>
  108. </html>