shares


Nameshares JSON
Version 3.1.10 PyPI version JSON
download
home_pageNone
SummaryThe best documentation framework every created.
upload_time2024-04-16 06:11:37
maintainerNone
docs_urlNone
authorNone
requires_python<4.0,>=3.10
licenseGPL-3.0-only
keywords documentation
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            
---

## "shares" is no longer the name of this endeavor.    
# The endeavor continues as "sphene".  
[https://pypi.org/project/sphene](https://pypi.org/project/sphene)    

If there are problems with "shares", change requests    
might still be addressed.   

******

Bravo!  You have received a Mercantilism Diploma in "shares" from     
the Orbital Convergence University International Air and Water  
Embassy of the 🍊 Planet (the planet that is one ellipse further from  
the Sun than Earth's ellipse).  

You are now officially certified to include "shares" in your practice.  

******


# shares

---

## description
Started from the shell, "shares" presents files in the current working directory (cwd) that have extension ".s.HTML" (case sensitive).

---		
		
## install
`[ZSH] pip install shares`

---


## start from shell
`[ZSH] shares`

Shares starts on port 2345, or the first avaible port after that.  
 * Running on http://127.0.0.1:2345  

This is the equivalent of:   
`[ZSH] shares start --port 2345`   

--
  
Alternatively you can add `--static-port` and "shares"   
stops if the port specified is unavailable.  
`[ZSH] shares start --port 2345 --static-port`   

--

### This is an example ".s.HTML" file.


```
<pre>
	<h1>This is an example HTML file.</h1>
	<p>
		It really only needs the "pre" tag to    
		look like a reflection of its contents in a browser.   
	</p>   
	<p>
		Tags like "html" and "body" are actually not   
		necessary for rendering HTML in modern browsers.  
	</p>   
	<p>  
		for text to wrap, instead of extending off the page,    
		style "white-space: pre-wrap" can be utilized instead of 
		a "pre" tag like so:
		
		<div style="white-space: pre-wrap"></div>
	</p>
</pre>
```


However, here is the "CSS1Compat" option,   
[https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode](https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode)   

with scaling based on the browser screen "viewport" of the screen,  
[https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag)  

and support for UTF-8 characters.    
[http://www.unicode.org/charts](http://www.unicode.org/charts)    
[https://www.w3.org/International/questions/qa-html-encoding-declarations]([https://www.w3.org/International/questions/qa-html-encoding-declarations])     



```
<!doctype html>
<html>
	<head>	
		<meta charset="utf-8" />
		<meta name="viewport" content="width=device-width, initial-scale=1" />
	</head>
	<body>
		<main>
			<article style="white-space: pre-wrap">
				
			
			</article>
		</main>
	</body>
</html>
```

---

## start programmatically
```
import pathlib
from os.path import dirname, join, normpath
this_folder = pathlib.Path (__file__).parent.resolve ()

import shares
shares.start ({
	"extension": ".s.HTML",
	
	#
	#	This is the node from which the traversal occur.
	#
	"directory": str (this_folder) + "/structures/shares",
	
	#
	#	This path is removed from the absolute path of share files found.
	#
	"relative path": str (this_folder) + "/structures/shares"
})

import time
while True:
	time.sleep (1000)
```

---

## Contacts
bgrace2345@pm.me
            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "shares",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4.0,>=3.10",
    "maintainer_email": null,
    "keywords": "documentation",
    "author": null,
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/9e/b9/548a604bb43e2af47fb5f5faed03982f68d14c11129b41e296855e9dc792/shares-3.1.10.tar.gz",
    "platform": null,
    "description": "\n---\n\n## \"shares\" is no longer the name of this endeavor.    \n# The endeavor continues as \"sphene\".  \n[https://pypi.org/project/sphene](https://pypi.org/project/sphene)    \n\nIf there are problems with \"shares\", change requests    \nmight still be addressed.   \n\n******\n\nBravo!  You have received a Mercantilism Diploma in \"shares\" from     \nthe Orbital Convergence University International Air and Water  \nEmbassy of the \ud83c\udf4a Planet (the planet that is one ellipse further from  \nthe Sun than Earth's ellipse).  \n\nYou are now officially certified to include \"shares\" in your practice.  \n\n******\n\n\n# shares\n\n---\n\n## description\nStarted from the shell, \"shares\" presents files in the current working directory (cwd) that have extension \".s.HTML\" (case sensitive).\n\n---\t\t\n\t\t\n## install\n`[ZSH] pip install shares`\n\n---\n\n\n## start from shell\n`[ZSH] shares`\n\nShares starts on port 2345, or the first avaible port after that.  \n * Running on http://127.0.0.1:2345  \n\nThis is the equivalent of:   \n`[ZSH] shares start --port 2345`   \n\n--\n  \nAlternatively you can add `--static-port` and \"shares\"   \nstops if the port specified is unavailable.  \n`[ZSH] shares start --port 2345 --static-port`   \n\n--\n\n### This is an example \".s.HTML\" file.\n\n\n```\n<pre>\n\t<h1>This is an example HTML file.</h1>\n\t<p>\n\t\tIt really only needs the \"pre\" tag to    \n\t\tlook like a reflection of its contents in a browser.   \n\t</p>   \n\t<p>\n\t\tTags like \"html\" and \"body\" are actually not   \n\t\tnecessary for rendering HTML in modern browsers.  \n\t</p>   \n\t<p>  \n\t\tfor text to wrap, instead of extending off the page,    \n\t\tstyle \"white-space: pre-wrap\" can be utilized instead of \n\t\ta \"pre\" tag like so:\n\t\t\n\t\t<div style=\"white-space: pre-wrap\"></div>\n\t</p>\n</pre>\n```\n\n\nHowever, here is the \"CSS1Compat\" option,   \n[https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode](https://developer.mozilla.org/en-US/docs/Web/HTML/Quirks_Mode_and_Standards_Mode)   \n\nwith scaling based on the browser screen \"viewport\" of the screen,  \n[https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag](https://developer.mozilla.org/en-US/docs/Web/HTML/Viewport_meta_tag)  \n\nand support for UTF-8 characters.    \n[http://www.unicode.org/charts](http://www.unicode.org/charts)    \n[https://www.w3.org/International/questions/qa-html-encoding-declarations]([https://www.w3.org/International/questions/qa-html-encoding-declarations])     \n\n\n\n```\n<!doctype html>\n<html>\n\t<head>\t\n\t\t<meta charset=\"utf-8\" />\n\t\t<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n\t</head>\n\t<body>\n\t\t<main>\n\t\t\t<article style=\"white-space: pre-wrap\">\n\t\t\t\t\n\t\t\t\n\t\t\t</article>\n\t\t</main>\n\t</body>\n</html>\n```\n\n---\n\n## start programmatically\n```\nimport pathlib\nfrom os.path import dirname, join, normpath\nthis_folder = pathlib.Path (__file__).parent.resolve ()\n\nimport shares\nshares.start ({\n\t\"extension\": \".s.HTML\",\n\t\n\t#\n\t#\tThis is the node from which the traversal occur.\n\t#\n\t\"directory\": str (this_folder) + \"/structures/shares\",\n\t\n\t#\n\t#\tThis path is removed from the absolute path of share files found.\n\t#\n\t\"relative path\": str (this_folder) + \"/structures/shares\"\n})\n\nimport time\nwhile True:\n\ttime.sleep (1000)\n```\n\n---\n\n## Contacts\nbgrace2345@pm.me",
    "bugtrack_url": null,
    "license": "GPL-3.0-only",
    "summary": "The best documentation framework every created.",
    "version": "3.1.10",
    "project_urls": {
        "GitLab": "https://gitlab.com/reptilian_climates/modules_series_2/shares"
    },
    "split_keywords": [
        "documentation"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "ccf963868fb26bb8ab1b70a5bb91efa228e5f2d1da484f7e5ef0d897443a9291",
                "md5": "b18e07774641d021ad2d23e6811a9d1a",
                "sha256": "326b8900acac067463255bc230537562e16d10c84f78d1afc57f4f07027791c4"
            },
            "downloads": -1,
            "filename": "shares-3.1.10-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "b18e07774641d021ad2d23e6811a9d1a",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4.0,>=3.10",
            "size": 28665,
            "upload_time": "2024-04-16T06:11:35",
            "upload_time_iso_8601": "2024-04-16T06:11:35.635847Z",
            "url": "https://files.pythonhosted.org/packages/cc/f9/63868fb26bb8ab1b70a5bb91efa228e5f2d1da484f7e5ef0d897443a9291/shares-3.1.10-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "9eb9548a604bb43e2af47fb5f5faed03982f68d14c11129b41e296855e9dc792",
                "md5": "842644fdd507578b239e70568c52dbc4",
                "sha256": "1d416d31cc102ace005ad688c1fa06409291d2956d0829eb0d6a680f4d371d9b"
            },
            "downloads": -1,
            "filename": "shares-3.1.10.tar.gz",
            "has_sig": false,
            "md5_digest": "842644fdd507578b239e70568c52dbc4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4.0,>=3.10",
            "size": 30922,
            "upload_time": "2024-04-16T06:11:37",
            "upload_time_iso_8601": "2024-04-16T06:11:37.473148Z",
            "url": "https://files.pythonhosted.org/packages/9e/b9/548a604bb43e2af47fb5f5faed03982f68d14c11129b41e296855e9dc792/shares-3.1.10.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-04-16 06:11:37",
    "github": false,
    "gitlab": true,
    "bitbucket": false,
    "codeberg": false,
    "gitlab_user": "reptilian_climates",
    "gitlab_project": "modules_series_2",
    "lcname": "shares"
}
        
Elapsed time: 0.24403s