summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--COPYING661
-rw-r--r--email/base64.scm255
-rw-r--r--email/email.scm804
-rw-r--r--email/quoted-printable.scm57
-rw-r--r--email/utils.scm95
5 files changed, 1872 insertions, 0 deletions
diff --git a/COPYING b/COPYING
new file mode 100644
index 0000000..be3f7b2
--- /dev/null
+++ b/COPYING
@@ -0,0 +1,661 @@
+ GNU AFFERO GENERAL PUBLIC LICENSE
+ Version 3, 19 November 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+ Preamble
+
+ The GNU Affero General Public License is a free, copyleft license for
+software and other kinds of works, specifically designed to ensure
+cooperation with the community in the case of network server software.
+
+ The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works. By contrast,
+our General Public Licenses are intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.
+
+ When we speak of free software, we are referring to freedom, not
+price. Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+ Developers that use our General Public Licenses protect your rights
+with two steps: (1) assert copyright on the software, and (2) offer
+you this License which gives you legal permission to copy, distribute
+and/or modify the software.
+
+ A secondary benefit of defending all users' freedom is that
+improvements made in alternate versions of the program, if they
+receive widespread use, become available for other developers to
+incorporate. Many developers of free software are heartened and
+encouraged by the resulting cooperation. However, in the case of
+software used on network servers, this result may fail to come about.
+The GNU General Public License permits making a modified version and
+letting the public access it on a server without ever releasing its
+source code to the public.
+
+ The GNU Affero General Public License is designed specifically to
+ensure that, in such cases, the modified source code becomes available
+to the community. It requires the operator of a network server to
+provide the source code of the modified version running there to the
+users of that server. Therefore, public use of a modified version, on
+a publicly accessible server, gives the public access to the source
+code of the modified version.
+
+ An older license, called the Affero General Public License and
+published by Affero, was designed to accomplish similar goals. This is
+a different license, not a version of the Affero GPL, but Affero has
+released a new version of the Affero GPL which permits relicensing under
+this license.
+
+ The precise terms and conditions for copying, distribution and
+modification follow.
+
+ TERMS AND CONDITIONS
+
+ 0. Definitions.
+
+ "This License" refers to version 3 of the GNU Affero General Public License.
+
+ "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+ "The Program" refers to any copyrightable work licensed under this
+License. Each licensee is addressed as "you". "Licensees" and
+"recipients" may be individuals or organizations.
+
+ To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy. The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+ A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+ To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy. Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+ To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies. Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+ An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License. If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+ 1. Source Code.
+
+ The "source code" for a work means the preferred form of the work
+for making modifications to it. "Object code" means any non-source
+form of a work.
+
+ A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+ The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form. A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+ The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities. However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work. For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+ The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+ The Corresponding Source for a work in source code form is that
+same work.
+
+ 2. Basic Permissions.
+
+ All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met. This License explicitly affirms your unlimited
+permission to run the unmodified Program. The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work. This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+ You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force. You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright. Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+ Conveying under any other circumstances is permitted solely under
+the conditions stated below. Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+ 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+ No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+ When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+ 4. Conveying Verbatim Copies.
+
+ You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+ You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+ 5. Conveying Modified Source Versions.
+
+ You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+ a) The work must carry prominent notices stating that you modified
+ it, and giving a relevant date.
+
+ b) The work must carry prominent notices stating that it is
+ released under this License and any conditions added under section
+ 7. This requirement modifies the requirement in section 4 to
+ "keep intact all notices".
+
+ c) You must license the entire work, as a whole, under this
+ License to anyone who comes into possession of a copy. This
+ License will therefore apply, along with any applicable section 7
+ additional terms, to the whole of the work, and all its parts,
+ regardless of how they are packaged. This License gives no
+ permission to license the work in any other way, but it does not
+ invalidate such permission if you have separately received it.
+
+ d) If the work has interactive user interfaces, each must display
+ Appropriate Legal Notices; however, if the Program has interactive
+ interfaces that do not display Appropriate Legal Notices, your
+ work need not make them do so.
+
+ A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit. Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+ 6. Conveying Non-Source Forms.
+
+ You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+ a) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by the
+ Corresponding Source fixed on a durable physical medium
+ customarily used for software interchange.
+
+ b) Convey the object code in, or embodied in, a physical product
+ (including a physical distribution medium), accompanied by a
+ written offer, valid for at least three years and valid for as
+ long as you offer spare parts or customer support for that product
+ model, to give anyone who possesses the object code either (1) a
+ copy of the Corresponding Source for all the software in the
+ product that is covered by this License, on a durable physical
+ medium customarily used for software interchange, for a price no
+ more than your reasonable cost of physically performing this
+ conveying of source, or (2) access to copy the
+ Corresponding Source from a network server at no charge.
+
+ c) Convey individual copies of the object code with a copy of the
+ written offer to provide the Corresponding Source. This
+ alternative is allowed only occasionally and noncommercially, and
+ only if you received the object code with such an offer, in accord
+ with subsection 6b.
+
+ d) Convey the object code by offering access from a designated
+ place (gratis or for a charge), and offer equivalent access to the
+ Corresponding Source in the same way through the same place at no
+ further charge. You need not require recipients to copy the
+ Corresponding Source along with the object code. If the place to
+ copy the object code is a network server, the Corresponding Source
+ may be on a different server (operated by you or a third party)
+ that supports equivalent copying facilities, provided you maintain
+ clear directions next to the object code saying where to find the
+ Corresponding Source. Regardless of what server hosts the
+ Corresponding Source, you remain obligated to ensure that it is
+ available for as long as needed to satisfy these requirements.
+
+ e) Convey the object code using peer-to-peer transmission, provided
+ you inform other peers where the object code and Corresponding
+ Source of the work are being offered to the general public at no
+ charge under subsection 6d.
+
+ A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+ A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling. In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage. For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product. A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+ "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source. The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+ If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information. But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+ The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed. Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+ Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+ 7. Additional Terms.
+
+ "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law. If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+ When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it. (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.) You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+ Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+ a) Disclaiming warranty or limiting liability differently from the
+ terms of sections 15 and 16 of this License; or
+
+ b) Requiring preservation of specified reasonable legal notices or
+ author attributions in that material or in the Appropriate Legal
+ Notices displayed by works containing it; or
+
+ c) Prohibiting misrepresentation of the origin of that material, or
+ requiring that modified versions of such material be marked in
+ reasonable ways as different from the original version; or
+
+ d) Limiting the use for publicity purposes of names of licensors or
+ authors of the material; or
+
+ e) Declining to grant rights under trademark law for use of some
+ trade names, trademarks, or service marks; or
+
+ f) Requiring indemnification of licensors and authors of that
+ material by anyone who conveys the material (or modified versions of
+ it) with contractual assumptions of liability to the recipient, for
+ any liability that these contractual assumptions directly impose on
+ those licensors and authors.
+
+ All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10. If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term. If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+ If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+ Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+ 8. Termination.
+
+ You may not propagate or modify a covered work except as expressly
+provided under this License. Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+ However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+ Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+ Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License. If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+ 9. Acceptance Not Required for Having Copies.
+
+ You are not required to accept this License in order to receive or
+run a copy of the Program. Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance. However,
+nothing other than this License grants you permission to propagate or
+modify any covered work. These actions infringe copyright if you do
+not accept this License. Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+ 10. Automatic Licensing of Downstream Recipients.
+
+ Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License. You are not responsible
+for enforcing compliance by third parties with this License.
+
+ An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations. If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+ You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License. For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+ 11. Patents.
+
+ A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based. The
+work thus licensed is called the contributor's "contributor version".
+
+ A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version. For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+ Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+ In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement). To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+ If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients. "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+ If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+ A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License. You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+ Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+ 12. No Surrender of Others' Freedom.
+
+ If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License. If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all. For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+ 13. Remote Network Interaction; Use with the GNU General Public License.
+
+ Notwithstanding any other provision of this License, if you modify the
+Program, your modified version must prominently offer all users
+interacting with it remotely through a computer network (if your version
+supports such interaction) an opportunity to receive the Corresponding
+Source of your version by providing access to the Corresponding Source
+from a network server at no charge, through some standard or customary
+means of facilitating copying of software. This Corresponding Source
+shall include the Corresponding Source for any work covered by version 3
+of the GNU General Public License that is incorporated pursuant to the
+following paragraph.
+
+ Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU General Public License into a single
+combined work, and to convey the resulting work. The terms of this
+License will continue to apply to the part which is the covered work,
+but the work with which it is combined will remain governed by version
+3 of the GNU General Public License.
+
+ 14. Revised Versions of this License.
+
+ The Free Software Foundation may publish revised and/or new versions of
+the GNU Affero General Public License from time to time. Such new versions
+will be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+ Each version is given a distinguishing version number. If the
+Program specifies that a certain numbered version of the GNU Affero General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation. If the Program does not specify a version number of the
+GNU Affero General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+ If the Program specifies that a proxy can decide which future
+versions of the GNU Affero General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+ Later license versions may give you additional or different
+permissions. However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+ 15. Disclaimer of Warranty.
+
+ THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+ 16. Limitation of Liability.
+
+ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+ 17. Interpretation of Sections 15 and 16.
+
+ If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+ END OF TERMS AND CONDITIONS
+
+ How to Apply These Terms to Your New Programs
+
+ If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+ To do so, attach the following notices to the program. It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+ <one line to give the program's name and a brief idea of what it does.>
+ Copyright (C) <year> <name of author>
+
+ This program is free software: you can redistribute it and/or modify
+ it under the terms of the GNU Affero General Public License as published by
+ the Free Software Foundation, either version 3 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU Affero General Public License for more details.
+
+ You should have received a copy of the GNU Affero General Public License
+ along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+ If your software can interact with users remotely through a computer
+network, you should also make sure that it provides a way for users to
+get its source. For example, if your program is a web application, its
+interface could display a "Source" link that leads users to an archive
+of the code. There are many ways you could offer source, and different
+solutions will be better for different programs; see section 13 for the
+specific requirements.
+
+ You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU AGPL, see
+<https://www.gnu.org/licenses/>.
diff --git a/email/base64.scm b/email/base64.scm
new file mode 100644
index 0000000..6b11b3f
--- /dev/null
+++ b/email/base64.scm
@@ -0,0 +1,255 @@
+;; -*- mode: scheme; coding: utf-8 -*-
+;;
+;; This module was renamed from (weinholt text base64 (1 0 20100612)) to
+;; (guix base64) by Nikita Karetnikov <nikita@karetnikov.org> on
+;; February 12, 2014.
+;;
+;; Some optimizations made by Ludovic Courtès <ludo@gnu.org>, 2015.
+;; Turned into a Guile module (instead of R6RS).
+;;
+;; This module was imported into the source tree of guile-email by
+;; Arun Isaac <arunisaac@systemreboot.net> on September 6, 2018.
+;;
+;; This program is free software: you can redistribute it and/or modify
+;; it under the terms of the GNU General Public License as published by
+;; the Free Software Foundation, either version 3 of the License, or
+;; (at your option) any later version.
+;;
+;; This program is distributed in the hope that it will be useful,
+;; but WITHOUT ANY WARRANTY; without even the implied warranty of
+;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+;; GNU General Public License for more details.
+;;
+;; You should have received a copy of the GNU General Public License
+;; along with this program. If not, see <http://www.gnu.org/licenses/>.
+;;
+;; This file incorporates work covered by the following copyright and
+;; permission notice:
+;;
+;; Copyright © 2009, 2010 Göran Weinholt <goran@weinholt.se>
+;;
+;; Permission is hereby granted, free of charge, to any person obtaining a
+;; copy of this software and associated documentation files (the "Software"),
+;; to deal in the Software without restriction, including without limitation
+;; the rights to use, copy, modify, merge, publish, distribute, sublicense,
+;; and/or sell copies of the Software, and to permit persons to whom the
+;; Software is furnished to do so, subject to the following conditions:
+;;
+;; The above copyright notice and this permission notice shall be included in
+;; all copies or substantial portions of the Software.
+;;
+;; THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+;; IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+;; FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+;; THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+;; LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+;; FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+;; DEALINGS IN THE SOFTWARE.
+
+;; RFC 4648 Base-N Encodings
+
+(define-module (email base64)
+ #:export (base64-encode
+ base64-decode
+ base64-alphabet
+ base64url-alphabet
+ get-delimited-base64
+ put-delimited-base64)
+ #:use-module (rnrs)
+ #:use-module ((srfi srfi-13)
+ #:select (string-index
+ string-prefix? string-suffix?
+ string-concatenate string-trim-both)))
+
+(define-syntax define-alias
+ (syntax-rules ()
+ ((_ new old)
+ (define-syntax new (identifier-syntax old)))))
+
+;; Force the use of Guile's own primitives to avoid the overhead of its 'fx'
+;; procedures.
+
+(define-alias fxbit-field bitwise-bit-field)
+(define-alias fxarithmetic-shift ash)
+(define-alias fxarithmetic-shift-left ash)
+(define-alias fxand logand)
+(define-alias fxior logior)
+(define-alias fxxor logxor)
+
+(define base64-alphabet
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/")
+
+(define base64url-alphabet
+ "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_")
+
+(define base64-encode
+ (case-lambda
+ ;; Simple interface. Returns a string containing the canonical
+ ;; base64 representation of the given bytevector.
+ ((bv)
+ (base64-encode bv 0 (bytevector-length bv) #f #f base64-alphabet #f))
+ ((bv start)
+ (base64-encode bv start (bytevector-length bv) #f #f base64-alphabet #f))
+ ((bv start end)
+ (base64-encode bv start end #f #f base64-alphabet #f))
+ ((bv start end line-length)
+ (base64-encode bv start end line-length #f base64-alphabet #f))
+ ((bv start end line-length no-padding)
+ (base64-encode bv start end line-length no-padding base64-alphabet #f))
+ ((bv start end line-length no-padding alphabet)
+ (base64-encode bv start end line-length no-padding alphabet #f))
+ ;; Base64 encodes the bytes [start,end[ in the given bytevector.
+ ;; Lines are limited to line-length characters (unless #f),
+ ;; which must be a multiple of four. To omit the padding
+ ;; characters (#\=) set no-padding to a true value. If port is
+ ;; #f, returns a string.
+ ((bv start end line-length no-padding alphabet port)
+ (assert (or (not line-length) (zero? (mod line-length 4))))
+ (let-values (((p extract) (if port
+ (values port (lambda () (values)))
+ (open-string-output-port))))
+ (letrec ((put (if line-length
+ (let ((chars 0))
+ (lambda (p c)
+ (when (fx=? chars line-length)
+ (set! chars 0)
+ (put-char p #\linefeed))
+ (set! chars (fx+ chars 1))
+ (put-char p c)))
+ put-char)))
+ (let lp ((i start))
+ (cond ((= i end))
+ ((<= (+ i 3) end)
+ (let ((x (bytevector-uint-ref bv i (endianness big) 3)))
+ (put p (string-ref alphabet (fxbit-field x 18 24)))
+ (put p (string-ref alphabet (fxbit-field x 12 18)))
+ (put p (string-ref alphabet (fxbit-field x 6 12)))
+ (put p (string-ref alphabet (fxbit-field x 0 6)))
+ (lp (+ i 3))))
+ ((<= (+ i 2) end)
+ (let ((x (fxarithmetic-shift-left (bytevector-u16-ref bv i (endianness big)) 8)))
+ (put p (string-ref alphabet (fxbit-field x 18 24)))
+ (put p (string-ref alphabet (fxbit-field x 12 18)))
+ (put p (string-ref alphabet (fxbit-field x 6 12)))
+ (unless no-padding
+ (put p #\=))))
+ (else
+ (let ((x (fxarithmetic-shift-left (bytevector-u8-ref bv i) 16)))
+ (put p (string-ref alphabet (fxbit-field x 18 24)))
+ (put p (string-ref alphabet (fxbit-field x 12 18)))
+ (unless no-padding
+ (put p #\=)
+ (put p #\=)))))))
+ (extract)))))
+
+ ;; Decodes a base64 string. The string must contain only pure
+ ;; unpadded base64 data.
+
+(define base64-decode
+ (case-lambda
+ ((str)
+ (base64-decode str base64-alphabet #f))
+ ((str alphabet)
+ (base64-decode str alphabet #f))
+ ((str alphabet port)
+ (unless (zero? (mod (string-length str) 4))
+ (error 'base64-decode
+ "input string must be a multiple of four characters"))
+ (let-values (((p extract) (if port
+ (values port (lambda () (values)))
+ (open-bytevector-output-port))))
+ (do ((i 0 (+ i 4)))
+ ((= i (string-length str))
+ (extract))
+ (let ((c1 (string-ref str i))
+ (c2 (string-ref str (+ i 1)))
+ (c3 (string-ref str (+ i 2)))
+ (c4 (string-ref str (+ i 3))))
+ ;; TODO: be more clever than string-index
+ (let ((i1 (string-index alphabet c1))
+ (i2 (string-index alphabet c2))
+ (i3 (string-index alphabet c3))
+ (i4 (string-index alphabet c4)))
+ (cond ((and i1 i2 i3 i4)
+ (let ((x (fxior (fxarithmetic-shift-left i1 18)
+ (fxarithmetic-shift-left i2 12)
+ (fxarithmetic-shift-left i3 6)
+ i4)))
+ (put-u8 p (fxbit-field x 16 24))
+ (put-u8 p (fxbit-field x 8 16))
+ (put-u8 p (fxbit-field x 0 8))))
+ ((and i1 i2 i3 (char=? c4 #\=)
+ (= i (- (string-length str) 4)))
+ (let ((x (fxior (fxarithmetic-shift-left i1 18)
+ (fxarithmetic-shift-left i2 12)
+ (fxarithmetic-shift-left i3 6))))
+ (put-u8 p (fxbit-field x 16 24))
+ (put-u8 p (fxbit-field x 8 16))))
+ ((and i1 i2 (char=? c3 #\=) (char=? c4 #\=)
+ (= i (- (string-length str) 4)))
+ (let ((x (fxior (fxarithmetic-shift-left i1 18)
+ (fxarithmetic-shift-left i2 12))))
+ (put-u8 p (fxbit-field x 16 24))))
+ (else
+ (error 'base64-decode "invalid input"
+ (list c1 c2 c3 c4)))))))))))
+
+(define (get-line-comp f port)
+ (if (port-eof? port)
+ (eof-object)
+ (f (get-line port))))
+
+ ;; Reads the common -----BEGIN/END type----- delimited format from
+ ;; the given port. Returns two values: a string with the type and a
+ ;; bytevector containing the base64 decoded data. The second value
+ ;; is the eof object if there is an eof before the BEGIN delimiter.
+
+(define (get-delimited-base64 port)
+ (define (get-first-data-line port)
+ ;; Some MIME data has header fields in the same format as mail
+ ;; or http. These are ignored.
+ (let ((line (get-line-comp string-trim-both port)))
+ (cond ((eof-object? line) line)
+ ((string-index line #\:)
+ (let lp () ;read until empty line
+ (let ((line (get-line-comp string-trim-both port)))
+ (if (string=? line "")
+ (get-line-comp string-trim-both port)
+ (lp)))))
+ (else line))))
+ (let ((line (get-line-comp string-trim-both port)))
+ (cond ((eof-object? line)
+ (values "" (eof-object)))
+ ((string=? line "")
+ (get-delimited-base64 port))
+ ((and (string-prefix? "-----BEGIN " line)
+ (string-suffix? "-----" line))
+ (let* ((type (substring line 11 (- (string-length line) 5)))
+ (endline (string-append "-----END " type "-----")))
+ (let-values (((outp extract) (open-bytevector-output-port)))
+ (let lp ((line (get-first-data-line port)))
+ (cond ((eof-object? line)
+ (error 'get-delimited-base64
+ "unexpected end of file"))
+ ((string-prefix? "-" line)
+ (unless (string=? line endline)
+ (error 'get-delimited-base64
+ "bad end delimiter" type line))
+ (values type (extract)))
+ (else
+ (unless (and (= (string-length line) 5)
+ (string-prefix? "=" line)) ;Skip Radix-64 checksum
+ (base64-decode line base64-alphabet outp))
+ (lp (get-line-comp string-trim-both port))))))))
+ (else ;skip garbage (like in openssl x509 -in foo -text output).
+ (get-delimited-base64 port)))))
+
+(define put-delimited-base64
+ (case-lambda
+ ((port type bv line-length)
+ (display (string-append "-----BEGIN " type "-----\n") port)
+ (base64-encode bv 0 (bytevector-length bv)
+ line-length #f base64-alphabet port)
+ (display (string-append "\n-----END " type "-----\n") port))
+ ((port type bv)
+ (put-delimited-base64 port type bv 76))))
diff --git a/email/email.scm b/email/email.scm
new file mode 100644
index 0000000..ccda3ac
--- /dev/null
+++ b/email/email.scm
@@ -0,0 +1,804 @@
+;;; guile-email --- Guile email parser
+;;; Copyright © 2018 Arun Isaac <arunisaac@systemreboot.net>
+;;;
+;;; This file is part of guile-email.
+;;;
+;;; guile-email is free software; you can redistribute it and/or modify
+;;; it under the terms of the GNU Affero General Public License as
+;;; published by the Free Software Foundation; either version 3 of the
+;;; License, or (at your option) any later version.
+;;;
+;;; guile-email is distributed in the hope that it will be useful, but
+;;; WITHOUT ANY WARRANTY; without even the implied warranty of
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+;;; Affero General Public License for more details.
+;;;
+;;; You should have received a copy of the GNU Affero General Public
+;;; License along with guile-email. If not, see
+;;; <http://www.gnu.org/licenses/>.
+
+(define-module (email email)
+ #:use-module (ice-9 iconv)
+ #:use-module (ice-9 match)
+ #:use-module (ice-9 peg)
+ #:use-module (ice-9 regex)
+ #:use-module (rnrs io simple)
+ #:use-module (srfi srfi-1)
+ #:use-module (srfi srfi-2)
+ #:use-module (srfi srfi-9)
+ #:use-module (srfi srfi-11)
+ #:use-module (srfi srfi-19)
+ #:use-module (srfi srfi-26)
+ #:use-module (sxml transform)
+ #:use-module (email base64)
+ #:use-module (email quoted-printable)
+ #:use-module ((email utils)
+ #:select (get-line-with-delimiter
+ read-objects read-while
+ acons* alist-delete*))
+ #:export (<email>
+ make-email
+ email?
+ email-headers
+ email-body
+ <mime-entity>
+ make-mime-entity
+ mime-entity?
+ mime-entity-headers
+ mime-entity-body
+ email->headers+body
+ parse-email
+ parse-email-headers
+ parse-email-body
+ parse-email-address
+ interpret-address
+ mbox->emails))
+
+(define (flatten-and-filter terms tree)
+ (filter list? (keyword-flatten terms tree)))
+
+(define-record-type <email>
+ (make-email headers body)
+ email?
+ (headers email-headers)
+ (body email-body))
+
+(define-record-type <mime-entity>
+ (make-mime-entity headers body)
+ mime-entity?
+ (headers mime-entity-headers)
+ (body mime-entity-body))
+
+(define string->lcase-symbol
+ (compose string->symbol string-downcase))
+
+;;; PEG parser implementing the ABNF grammar specified in RFC5322
+;;; (Internet Message Format), RFC6854 (Update to Internet Message
+;;; Format to Allow Group Syntax in the "From:" and "Sender:" Header
+;;; Fields)
+
+;;; Obsolete syntax has not been implemented.
+
+;;; Core ABNF rules from RFC5234
+
+(define-peg-pattern alpha body
+ (or (range #\A #\Z) (range #\a #\z)))
+
+;; Though line endings should be crlf (\r\n), we also tolerate bare
+;; line feeds (\n)
+(define-peg-pattern crlf none
+ (or "\r\n" "\n"))
+
+(define-peg-pattern digit body
+ (range #\0 #\9))
+
+(define-peg-pattern dquote body
+ "\"")
+
+;; Printable ASCII characters and UTF-8 characters > \x7f (RFC6532)
+(define-peg-pattern vchar body
+ (and (not-followed-by (or (range #\Nul #\Space)
+ "\x7f"))
+ peg-any))
+
+(define-peg-pattern wsp body
+ (or " " "\t"))
+
+(define-peg-pattern lwsp body
+ (* (or wsp (and crlf wsp))))
+
+(define-syntax-rule (define-printable-ascii-character-pattern name . exceptions)
+ (define-peg-pattern name body
+ (and (not-followed-by (or . exceptions))
+ vchar)))
+
+;;; Quoted characters
+
+(define-peg-pattern quoted-pair body
+ (and (ignore "\\") (or vchar wsp)))
+
+;;; Folding white space and comments
+
+(define-peg-pattern fws body
+ (and (? (and (* wsp) crlf)) (+ wsp)))
+
+(define-printable-ascii-character-pattern ctext "(" ")" "\\")
+
+(define-peg-pattern comment none
+ (and "(" (* (and (? fws) ccontent)) ")"))
+
+(define-peg-pattern ccontent body
+ (or ctext quoted-pair comment))
+
+(define-peg-pattern cfws body
+ (or (and (+ (and (? fws) comment)) (? fws)) fws))
+
+;;; Atom
+
+(define-printable-ascii-character-pattern atext
+ "\"" "(" ")" "," "." ":" ";" "<" ">" "@" "[" "\\" "]")
+
+(define-peg-pattern atom body
+ (and (? cfws) (+ atext) (? cfws)))
+
+(define-peg-pattern dot-atom-text body
+ (and (+ atext) (* (and "." (+ atext)))))
+
+(define-peg-pattern dot-atom body
+ (and (? cfws) dot-atom-text (? cfws)))
+
+;;; Quoted strings
+
+(define-printable-ascii-character-pattern qtext "\\" "\"")
+
+(define-peg-pattern qcontent body
+ (or qtext quoted-pair))
+
+;; TODO: Remove workaround guile peg bug for ignore
+(define-peg-pattern quoted-string body
+ (and (? cfws) (ignore (and dquote))
+ (* (and (? fws) qcontent))
+ (? fws)
+ (ignore (and dquote)) (? cfws)))
+
+;;; Miscellaneous tokens
+
+(define-peg-pattern word body
+ (or atom quoted-string))
+
+(define-peg-pattern phrase body
+ (+ word))
+
+;; ABNF modified to ignore leading whitespace
+;; ABNF modified to allow for blank lines in folded field
+(define-peg-pattern unstructured body
+ (and (ignore (? fws))
+ (* (and (? fws) (? vchar)))
+ (ignore (* wsp))))
+
+;;; Date and time specification
+
+(define-peg-pattern day-name body
+ (or "Mon" "Tue" "Wed" "Thu" "Fri" "Sat" "Sun"))
+
+(define-peg-pattern day-of-week all
+ (and (ignore (? fws)) day-name))
+
+;; TODO: Remove workaround guile peg bug for ignore
+(define-peg-pattern day all
+ (and (ignore (? fws)) digit (? digit) (ignore (and fws))))
+
+(define-peg-pattern month all
+ (or "Jan" "Feb" "Mar" "Apr" "May" "Jun"
+ "Jul" "Aug" "Sep" "Oct" "Nov" "Dec"))
+
+;; TODO: Remove workaround guile peg bug for ignore
+(define-peg-pattern year all
+ (and (ignore (and fws)) digit digit digit digit (ignore (and fws))))
+
+(define-peg-pattern date all
+ (and day month year))
+
+(define-peg-pattern hours all
+ (and digit digit))
+
+(define-peg-pattern minutes all
+ (and digit digit))
+
+(define-peg-pattern seconds all
+ (and digit digit))
+
+(define-peg-pattern time-of-day all
+ (and hours (ignore ":") minutes (? (and (ignore ":") seconds))))
+
+;; zone-sign, zone-hours and zone-minutes do not exist in the ABNF
+;; specified in RFC5322. But, we have it here since it eases parsing
+;; the zone and converting it to a number of seconds as required by
+;; the make-date procedure of SRFI-19.
+(define-peg-pattern zone-sign all
+ (or "+" "-"))
+
+(define-peg-pattern zone-hours all
+ (and digit digit))
+
+(define-peg-pattern zone-minutes all
+ (and digit digit))
+
+;; TODO: Remove workaround guile peg bug for ignore
+(define-peg-pattern zone all
+ (and (ignore (and fws)) zone-sign zone-hours zone-minutes))
+
+(define-peg-pattern time all
+ (and time-of-day zone))
+
+(define-peg-pattern date-time all
+ (and (? (and day-of-week (ignore ","))) date time (? cfws)))
+
+;;; Address specification
+
+(define-peg-pattern display-name all
+ phrase)
+
+(define-peg-pattern local-part body
+ (or dot-atom quoted-string))
+
+(define-printable-ascii-character-pattern dtext "[" "]" "\\")
+
+(define-peg-pattern domain-literal body
+ (and (? cfws) "[" (* (and (? fws) dtext)) (? fws) "]" (? cfws)))
+
+(define-peg-pattern domain body
+ (or dot-atom domain-literal))
+
+(define-peg-pattern addr-spec body
+ (and local-part "@" domain))
+
+(define-peg-pattern angle-addr all
+ (and (ignore (? cfws))
+ (ignore"<") addr-spec (ignore">")
+ (ignore (? cfws))))
+
+(define-peg-pattern name-addr body
+ (and (? display-name) angle-addr))
+
+(define-peg-pattern mailbox all
+ (or name-addr addr-spec))
+
+(define-peg-pattern mailbox-list all
+ (and mailbox (* (and (ignore ",") mailbox))))
+
+(define-peg-pattern group all
+ (and display-name (ignore ":")
+ (? group-list) (ignore ";") (? cfws)))
+
+(define-peg-pattern group-list all
+ (or mailbox-list cfws))
+
+(define-peg-pattern address body
+ (or mailbox group))
+
+(define-peg-pattern address-list all
+ (and address (* (and (ignore ",") address))))
+
+;;; Fields
+
+(define-syntax-rule (define-field-pattern name header pattern)
+ (define-peg-pattern name all
+ (and (ignore (string-ci header)) (ignore ":") pattern crlf)))
+
+;;; Origination date field
+
+(define-field-pattern orig-date "Date" date-time)
+
+;;; Originator fields
+
+(define-field-pattern from "From" (or mailbox-list address-list))
+(define-field-pattern sender "Sender" (or mailbox address))
+(define-field-pattern reply-to "Reply-To" address-list)
+
+;; Destination address fields
+
+(define-field-pattern to "To" address-list)
+(define-field-pattern cc "Cc" address-list)
+(define-field-pattern bcc "Bcc" (? (or address-list cfws)))
+
+;;; Identification fields
+
+(define-peg-pattern no-fold-literal body
+ (and "[" (* dtext) "]"))
+
+(define-peg-pattern id-left body
+ dot-atom-text)
+
+(define-peg-pattern id-right body
+ (or dot-atom-text no-fold-literal))
+
+(define-peg-pattern msg-id all
+ (and (ignore (? cfws)) (ignore "<")
+ id-left "@" id-right
+ (ignore ">") (ignore (? cfws))))
+
+(define-field-pattern message-id "Message-ID" msg-id)
+(define-field-pattern in-reply-to "In-Reply-To" (+ msg-id))
+(define-field-pattern references "References" (+ msg-id))
+
+;;; Informational fields
+
+(define-field-pattern subject "Subject" unstructured)
+(define-field-pattern comments "Comments" unstructured)
+(define-field-pattern keywords "Keywords" (and phrase (* (and "," phrase))))
+
+;;; Resent fields
+
+(define-field-pattern resent-date "Resent-Date" date-time)
+(define-field-pattern resent-from "Resent-From" (or mailbox-list address-list))
+(define-field-pattern resent-sender "Resent-Sender" (or mailbox address))
+(define-field-pattern resent-to "Resent-To" address-list)
+(define-field-pattern resent-cc "Resent-Cc" address-list)
+(define-field-pattern resent-bcc "Resent-Bcc" (? (or address-list cfws)))
+(define-field-pattern resent-msg-id "Resent-Message-ID" msg-id)
+
+;;; Trace fields
+
+;; word is given last priority in the ordered choice
+(define-peg-pattern received-token body
+ (or angle-addr addr-spec domain word))
+
+;; TODO: Do not discard the internal structure of received
+(define-field-pattern received "Received"
+ (and (* received-token) (ignore ";") date-time))
+
+(define-peg-pattern path body
+ (or angle-addr (and (? cfws) (ignore "<") (? cfws) (ignore ">") (? cfws))))
+
+(define-field-pattern return "Return-Path" path)
+
+(define-peg-pattern trace all
+ (and (? return) (+ received)))
+
+;;; Optional fields
+
+(define-printable-ascii-character-pattern ftext ":")
+
+(define-peg-pattern field-name all
+ (+ ftext))
+
+(define-peg-pattern optional-field all
+ (and field-name (ignore ":") unstructured crlf))
+
+;;; MIME version
+
+;; I have prepended optional cfws to account for leading whitespace.
+(define-field-pattern mime-version "MIME-Version"
+ (and (ignore (? cfws)) (+ digit) "." (+ digit)))
+
+;;; Content type
+
+;; TODO: What is <"> in RFC2045?
+(define-peg-pattern tspecials body
+ (or "(" ")" "<" ">" "@"
+ "," ";" ":" "\\"
+ "/" "[" "]" "?" "="))
+
+;; TODO: What is a CTL in RFC2045?
+(define-peg-pattern token body
+ (+ (and (not-followed-by (or " " crlf tspecials))
+ peg-any)))
+
+;; TODO: Implement iana-token, ietf-token and x-token
+(define-peg-pattern iana-token body
+ token)
+
+(define-peg-pattern ietf-token body
+ token)
+
+(define-peg-pattern x-token body
+ token)
+
+(define-peg-pattern extension-token body
+ (or ietf-token x-token))
+
+(define-peg-pattern discrete-type body
+ (or "text" "image" "audio" "video"
+ "application" extension-token))
+
+(define-peg-pattern composite-type body
+ (or "message" "multipart" extension-token))
+
+(define-peg-pattern type all
+ (or discrete-type composite-type))
+
+(define-peg-pattern subtype all
+ (or extension-token iana-token))
+
+(define-peg-pattern attribute all
+ token)
+
+;; quoted-string is given higher precedence
+(define-peg-pattern value all
+ (or quoted-string token))
+
+(define-peg-pattern parameter all
+ (and attribute (ignore "=") value))
+
+;; I have prepended optional cfws to account for leading whitespace.
+(define-field-pattern content "Content-Type"
+ (and (ignore (? cfws)) type (ignore "/") subtype
+ (* (and (ignore ";") (ignore (? cfws)) parameter))))
+
+;;; Content Disposition as defined in RFC2183
+
+(define-peg-pattern disposition-type body
+ (or "inline" "attachment" extension-token))
+
+(define-peg-pattern quoted-date-time all
+ quoted-string)
+
+(define-syntax-rule (define-parameter-pattern name header pattern)
+ (define-peg-pattern name all
+ (and (ignore header) (ignore "=") pattern)))
+
+(define-parameter-pattern filename-parm "filename" value)
+(define-parameter-pattern creation-date-parm "creation-date" quoted-date-time)
+(define-parameter-pattern modification-date-parm "modification-date" quoted-date-time)
+(define-parameter-pattern read-date-parm "read-date" quoted-date-time)
+(define-parameter-pattern size-parm "size" (+ digit))
+
+(define-peg-pattern disposition-parm body
+ (or filename-parm creation-date-parm modification-date-parm
+ read-date-parm size-parm parameter))
+
+;; I have prepended optional cfws to account for leading whitespace.
+(define-field-pattern disposition "Content-Disposition"
+ (and (ignore (? cfws)) disposition-type
+ (* (and (ignore ";") (ignore (? cfws)) disposition-parm))))
+
+;;; Content transfer encoding
+
+(define-peg-pattern mechanism body
+ (or "7bit" "8bit" "binary"
+ "quoted-printable" "base64"
+ ietf-token x-token))
+
+(define-field-pattern encoding "Content-Transfer-Encoding"
+ (and (ignore (? cfws)) mechanism))
+
+;;; Fields
+
+;; The ABNF specified for fields in RFC5322 does not make sense. With
+;; it, all headers are eaten up by optional-field. So, as a temporary
+;; workaround, I am going with the following much simpler (but
+;; possibly incorrect) ABNF.
+
+;; TODO: Try to understand and implement the actual ABNF specified by
+;; RFC5322.
+(define-peg-pattern fields all
+ (* (or trace
+ resent-date
+ resent-from
+ resent-sender
+ resent-to
+ resent-cc
+ resent-bcc
+ resent-msg-id
+ orig-date
+ from
+ sender
+ reply-to
+ to
+ cc
+ bcc
+ message-id
+ in-reply-to
+ references
+ subject
+ comments
+ keywords
+ mime-version
+ content
+ disposition
+ encoding
+ optional-field)))
+
+(define-peg-pattern mime-extension-field-name all
+ (and "Content-" (+ ftext)))
+
+(define-peg-pattern mime-extension-field all
+ (and mime-extension-field-name (ignore ":") unstructured crlf))
+
+(define-peg-pattern mime-entity-fields all
+ (* (or content
+ disposition
+ encoding
+ mime-extension-field
+ optional-field)))
+
+(define (decode-mime-encoded-word word)
+ (regexp-substitute/global
+ #f "=\\?([^?]*)\\?([^?]*)\\?([^?]*)\\?=" word
+ 'pre (lambda (match-record)
+ (let ((charset (match:substring match-record 1))
+ (encoding (string->lcase-symbol (match:substring match-record 2)))
+ (encoded-text (match:substring match-record 3)))
+ (bytevector->string
+ ((case encoding
+ ((b) base64-decode)
+ ((q) q-encoding-decode)
+ (else (error "Encoding of MIME word unknown" word)))
+ encoded-text)
+ charset)))
+ 'post))
+
+(define (body->mime-entities body boundary)
+ "Split BODY into a list of mime entities separated by BOUNDARY (as
+explained in RFC2045), and return that list."
+ (define (read-till-boundary port)
+ (read-while port get-line-with-delimiter
+ (negate (cut string-prefix? (string-append "--" boundary) <>))))
+
+ (define (read-mime-entity port)
+ (if (string-prefix? (string-append "--" boundary "--")
+ (get-line-with-delimiter port))
+ (eof-object)
+ (read-till-boundary port)))
+
+ (call-with-input-string body
+ (lambda (port)
+ (read-till-boundary port)
+ (read-objects read-mime-entity port))))
+
+(define (email->headers+body email)
+ "Split EMAIL into headers and body. Return as multiple values."
+ (call-with-input-string email
+ (lambda (port)
+ (let ((headers (read-while port get-line-with-delimiter
+ (lambda (line)
+ (not (or (string= line "\n")
+ (string= line "\r\n")))))))
+ (get-line-with-delimiter port)
+ (values headers
+ (read-while port get-line-with-delimiter identity))))))
+
+(define (post-process-content-transfer-encoding _ value)
+ (list 'content-transfer-encoding (string->lcase-symbol value)))
+
+(define post-process-content-type
+ (match-lambda*
+ (`(content (type ,type)
+ (subtype ,subtype)
+ . ,parameters)
+ (let ((type (string->lcase-symbol type))
+ (subtype (string->lcase-symbol subtype)))
+ `(content-type
+ ,(acons* 'type type
+ 'subtype subtype
+ (let ((parameters
+ (map (match-lambda
+ (`(parameter (attribute ,attribute)
+ (value ,value))
+ (cons (string->lcase-symbol attribute) value)))
+ (flatten-and-filter '(parameter) parameters))))
+ (if (and (eq? type 'text)
+ (not (assoc-ref parameters 'charset)))
+ ;; UTF-8 is specified as the default charset in RFC6657
+ (acons 'charset "utf-8" parameters)
+ parameters))))))))
+
+(define post-process-content-disposition
+ (match-lambda*
+ (`(disposition ,type . ,parameters)
+ `(content-disposition
+ ,(acons 'type (string->lcase-symbol type)
+ (map (match-lambda
+ (('filename-parm ('value filename))
+ (cons 'filename (basename filename)))
+ (((? (lambda (date-parm)
+ (member date-parm '(creation-date-parm modification-date-parm read-date-parm)))
+ date-parm) value)
+ ;; TODO: Convert to SRFI-19 datetime
+ (cons date-parm value))
+ (('size-parm value)
+ (cons 'size (string->number value)))
+ (`(parameter (attribute ,attribute)
+ (value ,value))
+ (cons (string->lcase-symbol attribute) value)))
+ (flatten-and-filter
+ '(filename-parm creation-date-parm modification-date-parm
+ read-date-parm size-parm parameter)
+ parameters)))))))
+
+(define post-process-optional-field
+ (match-lambda*
+ (`(optional-field
+ (field-name ,field-name)
+ ,field-value)
+ (list (string->lcase-symbol field-name)
+ field-value))
+ (`(optional-field (field-name ,field-name))
+ (list field-name ""))))
+
+(define* (macro-process-address-list _ . addresses)
+ (flatten-and-filter '(address mailbox) addresses))
+
+(define (parse-email-address address)
+ "Parse ADDRESS as an email address and return an association list
+with keys being the symbols name and address, and values being the
+display-name and addr-spec respectively. display-name and addr-spec
+are as defined in RFC5322.
+
+For example,
+(parse-email-address \"Foo <foo@example.org>\")
+=> ((name \"Foo\") (address \"foo@example.org\"))
+(parse-email-address \"foo@example.org\")
+=> ((address \"foo@example.org\"))"
+ (cond
+ ((string-match "([^<]*)<([^>]*)>" address)
+ => (lambda (match-record)
+ (let ((name (string-trim-both (match:substring match-record 1)))
+ (address (match:substring match-record 2)))
+ (if (string-null? name)
+ `((address . ,address))
+ `((name . ,name)
+ (address . ,address))))))
+ (else `((address . ,address)))))
+
+(define interpret-address
+ (match-lambda
+ ((('name . name)
+ ('address . address))
+ (format #f "~a <~a>" name address))
+ ((('address . address)) address)))
+
+(define (parse-email-body headers body)
+ "Parse BODY as email body where HEADERS is an association list of
+header keys and values as returned by parse-email-headers. Return a
+list of <mime-entity> records if the body is a multipart
+message. Else, return a single <mime-entity> record."
+ (let ((content-type (assoc-ref headers 'content-type)))
+ (case (assoc-ref content-type 'type)
+ ((multipart)
+ (map parse-mime-entity
+ (body->mime-entities body (assoc-ref content-type 'boundary))))
+ ((text)
+ (string-trim-both
+ (decode-body body (assoc-ref headers 'content-transfer-encoding)
+ (assoc-ref content-type 'charset))))
+ (else (decode-body body (assoc-ref headers 'content-transfer-encoding))))))
+
+(define (add-default-headers headers)
+ ;; Default Content-Type and Content-Transfer-Encoding headers as
+ ;; specified in RFC2045
+ (let ((default-headers
+ (acons* 'content-type '((type . text)
+ (subtype . plain)
+ ;; UTF-8 is specified as the default
+ ;; charset in RFC6657
+ (charset . "utf-8"))
+ 'content-transfer-encoding '#{7bit}#)))
+ (append (alist-delete* (append (if (assoc-ref headers 'content-type)
+ (list 'content-type) (list))
+ (if (assoc-ref headers 'content-transfer-encoding)
+ (list 'content-transfer-encoding) (list)))
+ default-headers)
+ headers)))
+
+(define (parse-mime-entity text)
+ (let-values (((headers body) (email->headers+body text)))
+ (let ((headers
+ (pre-post-order
+ (peg:tree
+ (match-pattern mime-entity-fields text))
+ `((content . ,post-process-content-type)
+ (encoding . ,post-process-content-transfer-encoding)
+ (disposition . ,post-process-content-disposition)
+ (optional-field . ,post-process-optional-field)
+ (mime-entity-fields . ,(lambda (_ . mime-entity-fields)
+ (add-default-headers
+ (map (match-lambda
+ ((mime-entity-field value)
+ (cons mime-entity-field value))
+ ((mime-entity-field . values)
+ (cons mime-entity-field values)))
+ mime-entity-fields))))
+ (*text* . ,(lambda (_ text) text))
+ (*default* . ,(lambda tree tree))))))
+ (make-mime-entity headers (parse-email-body headers body)))))
+
+(define (parse-email email)
+ "Parse string EMAIL and return result as a <email> record."
+ (let-values (((headers body) (email->headers+body email)))
+ (let ((headers-alist (parse-email-headers headers)))
+ (make-email headers-alist (parse-email-body headers-alist body)))))
+
+(define (parse-email-headers headers)
+ "Parse string HEADERS as email headers and return an association
+list of header keys and values."
+ (define (extract-value _ value) value)
+
+ (pre-post-order
+ (peg:tree
+ (match-pattern fields headers))
+ `((date-time . ,(lambda node
+ (match-let
+ ((`((day ,day) (month ,month) (year ,year)
+ (hours ,hours) (minutes ,minutes) (seconds ,seconds)
+ (zone-sign ,zone-sign) (zone-hours ,zone-hours) (zone-minutes ,zone-minutes))
+ (flatten-and-filter
+ '(day month year hours minutes seconds
+ zone-sign zone-hours zone-minutes)
+ node)))
+ (make-date 0
+ (string->number seconds)
+ (string->number minutes)
+ (string->number hours)
+ (string->number day)
+ (1+ (list-index
+ (cut equal? <> month)
+ (list "Jan" "Feb" "Mar" "Apr" "May" "Jun"
+ "Jul" "Aug" "Sep" "Oct" "Nov" "Dec")))
+ (string->number year)
+ (* (case (string->symbol zone-sign)
+ ((+) 1)
+ ((-) -1))
+ (+ (* 60 60 (string->number zone-hours))
+ (* 60 (string->number zone-minutes))))))))
+ (orig-date . ,(lambda (_ date) (list 'date date)))
+ (angle-addr . ,extract-value)
+ (mailbox . ,(match-lambda*
+ (`(mailbox (display-name ,name) ,address)
+ `((name . ,(decode-mime-encoded-word
+ (string-trim-both name)))
+ (address . ,address)))
+ (`(mailbox ,address)
+ `((address . ,(string-trim-both address))))
+ (_ (error "Failed to parse mailbox"))))
+ (address-list *macro* . ,macro-process-address-list)
+ (mailbox-list *macro* . ,macro-process-address-list)
+ (optional-field . ,post-process-optional-field)
+ (msg-id . ,(match-lambda* (`(msg-id ,msg-id) msg-id)))
+ (content . ,post-process-content-type)
+ (encoding . ,post-process-content-transfer-encoding)
+ (disposition . ,post-process-content-disposition)
+ (fields . ,(lambda (_ . fields)
+ (add-default-headers
+ (filter-map (match-lambda
+ (('trace . _) #f)
+ ((field value)
+ (cons field value))
+ ((field . values)
+ (cons field values))
+ (_ #f))
+ fields))))
+ (*text* . ,extract-value)
+ (*default* . ,(lambda tree tree)))))
+
+(define* (decode-body body encoding #:optional charset)
+ (let ((octets
+ (case encoding
+ ((base64)
+ (base64-decode
+ (string-filter
+ (char-set-union
+ (ucs-range->char-set (char->integer #\a) (1+ (char->integer #\z)))
+ (ucs-range->char-set (char->integer #\A) (1+ (char->integer #\Z)))
+ (ucs-range->char-set (char->integer #\0) (1+ (char->integer #\9)))
+ (char-set #\+ #\/ #\=))
+ body)))
+ ((quoted-printable) (quoted-printable-decode body))
+ ((#{7bit}# #{8bit}# binary) body)
+ (else (error "Body decoding failed. Unknown encoding" encoding)))))
+ (if charset
+ (case encoding
+ ((base64 quoted-printable) (bytevector->string octets charset))
+ ((#{7bit}# #{8bit}# binary) octets))
+ octets)))
+
+(define (read-next-email-in-mbox port)
+ ;; Read and discard From_ line
+ (get-line-with-delimiter port)
+ ;; Read the actual email
+ (read-while port get-line-with-delimiter
+ (negate (cut string-prefix? "From " <>))))
+
+(define (mbox->emails port)
+ (read-objects read-next-email-in-mbox port))
diff --git a/email/quoted-printable.scm b/email/quoted-printable.scm
new file mode 100644
index 0000000..f6e3605
--- /dev/null
+++ b/email/quoted-printable.scm
@@ -0,0 +1,57 @@
+;;; guile-email --- Guile email parser
+;;; Copyright © 2018 Arun Isaac <arunisaac@systemreboot.net>
+;;;
+;;; This file is part of guile-email.
+;;;
+;;; guile-email is free software; you can redistribute it and/or modify
+;;; it under the terms of the GNU Affero General Public License as
+;;; published by the Free Software Foundation; either version 3 of the
+;;; License, or (at your option) any later version.
+;;;
+;;; guile-email is distributed in the hope that it will be useful, but
+;;; WITHOUT ANY WARRANTY; without even the implied warranty of
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+;;; Affero General Public License for more details.
+;;;
+;;; You should have received a copy of the GNU Affero General Public
+;;; License along with guile-email. If not, see
+;;; <http://www.gnu.org/licenses/>.
+
+(define-module (email quoted-printable)
+ #:use-module (rnrs)
+ #:use-module (ice-9 match)
+ #:export (quoted-printable-decode
+ q-encoding-decode))
+
+;; TODO: Error out on invalid quoted-printable input
+(define quoted-printable-decode
+ (match-lambda*
+ (((? string? str))
+ (call-with-input-string str quoted-printable-decode))
+ (((? port? in))
+ (let-values (((out get-bytevector)
+ (open-bytevector-output-port)))
+ (quoted-printable-decode in out)
+ (get-bytevector)))
+ (((? port? in) (? port? out))
+ (let ((c (read-char in)))
+ (cond
+ ((eof-object? c)
+ out)
+ ((char=? c #\=)
+ ;; TODO: Support "\r\n" line ending
+ (let ((c1 (read-char in)))
+ (unless (char=? c1 #\Newline)
+ (let ((c2 (read-char in)))
+ (put-u8 out (string->number (string c1 c2) 16)))))
+ (quoted-printable-decode in out))
+ (#t
+ (put-u8 out (char->integer c))
+ (quoted-printable-decode in out)))))))
+
+(define (q-encoding-decode str)
+ (quoted-printable-decode
+ (string-map
+ (lambda (c)
+ (if (char=? c #\_) #\Space c))
+ str)))
diff --git a/email/utils.scm b/email/utils.scm
new file mode 100644
index 0000000..7d51ebb
--- /dev/null
+++ b/email/utils.scm
@@ -0,0 +1,95 @@
+;;; guile-email --- Guile email parser
+;;; Copyright © 2018 Arun Isaac <arunisaac@systemreboot.net>
+;;;
+;;; This file is part of guile-email.
+;;;
+;;; guile-email is free software; you can redistribute it and/or modify
+;;; it under the terms of the GNU Affero General Public License as
+;;; published by the Free Software Foundation; either version 3 of the
+;;; License, or (at your option) any later version.
+;;;
+;;; guile-email is distributed in the hope that it will be useful, but
+;;; WITHOUT ANY WARRANTY; without even the implied warranty of
+;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+;;; Affero General Public License for more details.
+;;;
+;;; You should have received a copy of the GNU Affero General Public
+;;; License along with guile-email. If not, see
+;;; <http://www.gnu.org/licenses/>.
+
+(define-module (email utils)
+ #:use-module (ice-9 match)
+ #:use-module (ice-9 peg codegen)
+ #:use-module (ice-9 textual-ports)
+ #:use-module (rnrs io simple)
+ #:export (get-line-with-delimiter
+ read-objects
+ read-while
+ acons*
+ alist-delete*))
+
+(define (read-objects read-proc port)
+ "Read all objects using READ-PROC from PORT and return them as a
+list."
+ (let ((x (read-proc port)))
+ (if (eof-object? x)
+ (list)
+ (cons x (read-objects read-proc port)))))
+
+(define* (read-while port read-proc pred)
+ "Read from PORT using READ-PROC while PRED returns #t. READ-PROC is
+invoked with the input port as argument. PRED is invoked with each
+string returned by READ-PROC as argument."
+ (define (read-while-loop output)
+ (let ((x (read-proc port)))
+ (cond
+ ((eof-object? x) x)
+ ((pred x)
+ (put-string output x)
+ (read-while-loop output))
+ (#t (unget-string port x)))))
+
+ (let ((str (call-with-output-string read-while-loop)))
+ (if (string-null? str) (eof-object) str)))
+
+(define (get-line-with-delimiter port)
+ "Read a line from PORT and return it as a string including the
+delimiting linefeed character."
+ (let ((line (get-line port)))
+ (if (eof-object? line)
+ line
+ (string-append line "\n"))))
+
+(define acons*
+ (match-lambda*
+ ((key value)
+ (acons key value (list)))
+ ((key value . rest)
+ (acons key value (apply acons* rest)))
+ ((alist) alist)))
+
+(define (alist-delete* keys alist)
+ "Return a list containing all elements of ALIST whose keys are not a
+member of KEYS."
+ (filter (match-lambda
+ ((key . _)
+ (not (member key keys))))
+ alist))
+
+(define (cg-string-ci pat accum)
+ (syntax-case pat ()
+ ((pat-str-syntax) (string? (syntax->datum #'pat-str-syntax))
+ (let ((pat-str (syntax->datum #'pat-str-syntax)))
+ (let ((plen (string-length pat-str)))
+ #`(lambda (str len pos)
+ (let ((end (+ pos #,plen)))
+ (and (<= end len)
+ (string-ci= str #,pat-str pos end)
+ #,(case accum
+ ((all) #`(list end (list 'cg-string #,pat-str)))
+ ((name) #`(list end 'cg-string))
+ ((body) #`(list end #,pat-str))
+ ((none) #`(list end '()))
+ (else (error "bad accum" accum)))))))))))
+
+(add-peg-compiler! 'string-ci cg-string-ci)