id,page,ref,title,content,breadcrumbs,references
internals:internals-tilde-encoding,internals,internals-tilde-encoding,Tilde encoding,"Datasette uses a custom encoding scheme in some places, called  tilde encoding . This is primarily used for table names and row primary keys, to avoid any confusion between  /  characters in those values and the Datasette URLs that reference them. 
                 Tilde encoding uses the same algorithm as  URL percent-encoding , but with the  ~  tilde character used in place of  % . 
                 Any character other than  ABCDEFGHIJKLMNOPQRSTUVWXYZ abcdefghijklmnopqrstuvwxyz0123456789_-  will be replaced by the numeric equivalent preceded by a tilde. For example: 
                 
                     
                         /  becomes  ~2F 
                     
                     
                         .  becomes  ~2E 
                     
                     
                         %  becomes  ~25 
                     
                     
                         ~  becomes  ~7E 
                     
                     
                         Space becomes  + 
                     
                     
                         polls/2022.primary  becomes  polls~2F2022~2Eprimary 
                     
                 
                 Note that the space character is a special case: it will be replaced with a  +  symbol. 
                 
                 
                 
                     datasette.utils. tilde_encode s :   str str 
                     
                         Returns tilde-encoded string - for example  /foo/bar  ->  ~2Ffoo~2Fbar 
                     
                 
                 
                 
                 
                     datasette.utils. tilde_decode s :   str str 
                     
                         Decodes a tilde-encoded string, so  ~2Ffoo~2Fbar  ->  /foo/bar","[""Internals for plugins"", ""The datasette.utils module""]","[{""href"": ""https://developer.mozilla.org/en-US/docs/Glossary/percent-encoding"", ""label"": ""URL percent-encoding""}]"