masktunnel 0.1.0__tar.gz

masktunnel-0.1.0/MANIFEST.in

@@ -0,0 +1,18 @@
+# Include Go source files in masktunnel_go directory
+recursive-include masktunnel_go *.go
+include go.mod
+include go.sum
+
+# Include documentation
+include README.md
+
+# Exclude unnecessary files
+global-exclude __pycache__
+global-exclude *.py[co]
+global-exclude .git*
+global-exclude *.so
+global-exclude *.dylib
+global-exclude *.dll
+
+# Exclude existing bindings directory to force rebuild
+prune masktunnellib

masktunnel-0.1.0/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: masktunnel
+Version: 0.1.0
+Summary: Python bindings for MaskTunnel (Go)
+Home-page: https://github.com/cloudflyer-project/masktunnel
+Author: cloudflyer-project
+License: GPL-3.0
+Platform: any
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: setuptools>=40.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: platform
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# masktunnel (Python bindings)
+
+This directory contains the Python package that wraps MaskTunnel's Go implementation via gopy.
+
+- Package name: `masktunnel`
+- Native module directory (generated at build time): `masktunnellib/`
+
+Build notes:
+
+- Building from source requires Go and a C toolchain.
+- Wheels are produced by CI for common platforms.

masktunnel-0.1.0/README.md

@@ -0,0 +1,11 @@
+# masktunnel (Python bindings)
+
+This directory contains the Python package that wraps MaskTunnel's Go implementation via gopy.
+
+- Package name: `masktunnel`
+- Native module directory (generated at build time): `masktunnellib/`
+
+Build notes:
+
+- Building from source requires Go and a C toolchain.
+- Wheels are produced by CI for common platforms.

masktunnel-0.1.0/go.mod

@@ -0,0 +1,46 @@
+module github.com/cloudflyer-project/masktunnel
+
+go 1.24.0
+
+toolchain go1.24.4
+
+require (
+	github.com/Noooste/azuretls-client v1.12.3
+	github.com/Noooste/fhttp v1.0.15
+	github.com/Noooste/utls v1.3.19
+	github.com/Noooste/websocket v1.0.3
+	github.com/andybalholm/brotli v1.2.0
+	github.com/cristalhq/base64 v0.1.2
+	github.com/gorilla/websocket v1.5.3
+	github.com/mileusna/useragent v1.3.4
+	github.com/rs/zerolog v1.34.0
+	github.com/spf13/pflag v1.0.10
+	github.com/valyala/fasthttp v1.65.0
+)
+
+require (
+	github.com/Noooste/go-socks4 v0.0.2 // indirect
+	github.com/Noooste/uquic-go v0.0.31 // indirect
+	github.com/bdandy/go-errors v1.2.2 // indirect
+	github.com/cloudflare/circl v1.6.1 // indirect
+	github.com/fatih/color v1.18.0 // indirect
+	github.com/gaukas/clienthellod v0.4.2 // indirect
+	github.com/gaukas/godicttls v0.0.4 // indirect
+	github.com/go-task/slim-sprig/v3 v3.0.0 // indirect
+	github.com/google/gopacket v1.1.19 // indirect
+	github.com/klauspost/compress v1.18.0 // indirect
+	github.com/mattn/go-colorable v0.1.14 // indirect
+	github.com/mattn/go-isatty v0.0.20 // indirect
+	github.com/quic-go/qpack v0.5.1 // indirect
+	github.com/refraction-networking/utls v1.7.3 // indirect
+	github.com/valyala/bytebufferpool v1.0.0 // indirect
+	go.uber.org/automaxprocs v1.6.0 // indirect
+	go.uber.org/mock v0.5.2 // indirect
+	golang.org/x/crypto v0.41.0 // indirect
+	golang.org/x/mod v0.26.0 // indirect
+	golang.org/x/net v0.43.0 // indirect
+	golang.org/x/sync v0.16.0 // indirect
+	golang.org/x/sys v0.35.0 // indirect
+	golang.org/x/text v0.28.0 // indirect
+	golang.org/x/tools v0.35.0 // indirect
+)

masktunnel-0.1.0/go.sum

@@ -0,0 +1,116 @@
+github.com/Noooste/azuretls-client v1.12.3 h1:4GYXdN7J+WbGkj4oseeBUS+Eng/wm7QnAwz6gpqMjio=
+github.com/Noooste/azuretls-client v1.12.3/go.mod h1:9PYT3hB8DWHyuL5z/iXCEYhy6v3oKazjBO1x4lqvghA=
+github.com/Noooste/fhttp v1.0.15 h1:sYRWOKgr1x4L+wA6REMJCs4Z/lFOSJmuQHSIXMXCcPs=
+github.com/Noooste/fhttp v1.0.15/go.mod h1:YZtq+i2M11Y22UiOR6gjNSLMNLiPhURh6M44oFVQ1TE=
+github.com/Noooste/go-socks4 v0.0.2 h1:DwHCYiCEAdjfNrQOFIid7qgKCll7ubhGS1ji5O8FYng=
+github.com/Noooste/go-socks4 v0.0.2/go.mod h1:+oOgtOFRsU8FoK7NBOhHSjiH5pveY8LgYNF5XcqVgjE=
+github.com/Noooste/uquic-go v0.0.31 h1:gYIyrpcH2Znykw1dj9vsOEu0ArT8RlN46rIAehnaqMU=
+github.com/Noooste/uquic-go v0.0.31/go.mod h1:8UUkSe8ILdcVl0/vutpZDjySNlgajKod+xlS3T3GBnE=
+github.com/Noooste/utls v1.3.19 h1:B4HjzRTXj6T/tMBgp/u8jsbgnlitaRHEz8+0FKgZYH0=
+github.com/Noooste/utls v1.3.19/go.mod h1:XEy+VEbTxmH6krfSG5YT7wDbjHTEi2zUXTG33R0PAAg=
+github.com/Noooste/websocket v1.0.3 h1:drW7tvZ3YqzqI9wApnaH1Q0syFMXO7gbLlsBWjZvMNA=
+github.com/Noooste/websocket v1.0.3/go.mod h1:Qhw0Rtuju/fPPbcb3R5XGq7poa51qPDL462jTltl9nQ=
+github.com/andybalholm/brotli v1.2.0 h1:ukwgCxwYrmACq68yiUqwIWnGY0cTPox/M94sVwToPjQ=
+github.com/andybalholm/brotli v1.2.0/go.mod h1:rzTDkvFWvIrjDXZHkuS16NPggd91W3kUSvPlQ1pLaKY=
+github.com/bdandy/go-errors v1.2.2 h1:WdFv/oukjTJCLa79UfkGmwX7ZxONAihKu4V0mLIs11Q=
+github.com/bdandy/go-errors v1.2.2/go.mod h1:NkYHl4Fey9oRRdbB1CoC6e84tuqQHiqrOcZpqFEkBxM=
+github.com/cloudflare/circl v1.6.1 h1:zqIqSPIndyBh1bjLVVDHMPpVKqp8Su/V+6MeDzzQBQ0=
+github.com/cloudflare/circl v1.6.1/go.mod h1:uddAzsPgqdMAYatqJ0lsjX1oECcQLIlRpzZh3pJrofs=
+github.com/coreos/go-systemd/v22 v22.5.0/go.mod h1:Y58oyj3AT4RCenI/lSvhwexgC+NSVTIJ3seZv2GcEnc=
+github.com/cristalhq/base64 v0.1.2 h1:edsefYyYDiac7Ytdh2xdaiiSSJzcI2f0yIkdGEf1qY0=
+github.com/cristalhq/base64 v0.1.2/go.mod h1:sy4+2Hale2KbtSqkzpdMeYTP/IrB+HCvxVHWsh2VSYk=
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/fatih/color v1.18.0 h1:S8gINlzdQ840/4pfAwic/ZE0djQEH3wM94VfqLTZcOM=
+github.com/fatih/color v1.18.0/go.mod h1:4FelSpRwEGDpQ12mAdzqdOukCy4u8WUtOY6lkT/6HfU=
+github.com/francoispqt/gojay v1.2.13 h1:d2m3sFjloqoIUQU3TsHBgj6qg/BVGlTBeHDUmyJnXKk=
+github.com/francoispqt/gojay v1.2.13/go.mod h1:ehT5mTG4ua4581f1++1WLG0vPdaA9HaiDsoyrBGkyDY=
+github.com/gaukas/clienthellod v0.4.2 h1:LPJ+LSeqt99pqeCV4C0cllk+pyWmERisP7w6qWr7eqE=
+github.com/gaukas/clienthellod v0.4.2/go.mod h1:M57+dsu0ZScvmdnNxaxsDPM46WhSEdPYAOdNgfL7IKA=
+github.com/gaukas/godicttls v0.0.4 h1:NlRaXb3J6hAnTmWdsEKb9bcSBD6BvcIjdGdeb0zfXbk=
+github.com/gaukas/godicttls v0.0.4/go.mod h1:l6EenT4TLWgTdwslVb4sEMOCf7Bv0JAK67deKr9/NCI=
+github.com/go-logr/logr v1.2.4 h1:g01GSCwiDw2xSZfjJ2/T9M+S6pFdcNtFYsp+Y43HYDQ=
+github.com/go-logr/logr v1.2.4/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=
+github.com/go-task/slim-sprig/v3 v3.0.0 h1:sUs3vkvUymDpBKi3qH1YSqBQk9+9D/8M2mN1vB6EwHI=
+github.com/go-task/slim-sprig/v3 v3.0.0/go.mod h1:W848ghGpv3Qj3dhTPRyJypKRiqCdHZiAzKg9hl15HA8=
+github.com/godbus/dbus/v5 v5.0.4/go.mod h1:xhWf0FNVPg57R7Z0UbKHbJfkEywrmjJnf7w5xrFpKfA=
+github.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=
+github.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=
+github.com/google/gopacket v1.1.19 h1:ves8RnFZPGiFnTS0uPQStjwru6uO6h+nlr9j6fL7kF8=
+github.com/google/gopacket v1.1.19/go.mod h1:iJ8V8n6KS+z2U1A8pUwu8bW5SyEMkXJB8Yo/Vo+TKTo=
+github.com/google/pprof v0.0.0-20250607225305-033d6d78b36a h1://KbezygeMJZCSHH+HgUZiTeSoiuFspbMg1ge+eFj18=
+github.com/google/pprof v0.0.0-20250607225305-033d6d78b36a/go.mod h1:5hDyRhoBCxViHszMt12TnOpEI4VVi+U8Gm9iphldiMA=
+github.com/gorilla/websocket v1.5.3 h1:saDtZ6Pbx/0u+bgYQ3q96pZgCzfhKXGPqt7kZ72aNNg=
+github.com/gorilla/websocket v1.5.3/go.mod h1:YR8l580nyteQvAITg2hZ9XVh4b55+EU/adAjf1fMHhE=
+github.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo=
+github.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ=
+github.com/mattn/go-colorable v0.1.13/go.mod h1:7S9/ev0klgBDR4GtXTXX8a3vIGJpMovkB8vQcUbaXHg=
+github.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIE=
+github.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=
+github.com/mattn/go-isatty v0.0.16/go.mod h1:kYGgaQfpe5nmfYZH+SKPsOc2e4SrIfOl2e/yFXSvRLM=
+github.com/mattn/go-isatty v0.0.19/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
+github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
+github.com/mileusna/useragent v1.3.4 h1:MiuRRuvGjEie1+yZHO88UBYg8YBC/ddF6T7F56i3PCk=
+github.com/mileusna/useragent v1.3.4/go.mod h1:3d8TOmwL/5I8pJjyVDteHtgDGcefrFUX4ccGOMKNYYc=
+github.com/onsi/ginkgo/v2 v2.23.4 h1:ktYTpKJAVZnDT4VjxSbiBenUjmlL/5QkBEocaWXiQus=
+github.com/onsi/ginkgo/v2 v2.23.4/go.mod h1:Bt66ApGPBFzHyR+JO10Zbt0Gsp4uWxu5mIOTusL46e8=
+github.com/onsi/gomega v1.37.0 h1:CdEG8g0S133B4OswTDC/5XPSzE1OeP29QOioj2PID2Y=
+github.com/onsi/gomega v1.37.0/go.mod h1:8D9+Txp43QWKhM24yyOBEdpkzN8FvJyAwecBgsU4KU0=
+github.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/quic-go/qpack v0.5.1 h1:giqksBPnT/HDtZ6VhtFKgoLOWmlyo9Ei6u9PqzIMbhI=
+github.com/quic-go/qpack v0.5.1/go.mod h1:+PC4XFrEskIVkcLzpEkbLqq1uCoxPhQuvK5rH1ZgaEg=
+github.com/refraction-networking/utls v1.7.3 h1:L0WRhHY7Oq1T0zkdzVZMR6zWZv+sXbHB9zcuvsAEqCo=
+github.com/refraction-networking/utls v1.7.3/go.mod h1:TUhh27RHMGtQvjQq+RyO11P6ZNQNBb3N0v7wsEjKAIQ=
+github.com/rs/xid v1.6.0/go.mod h1:7XoLgs4eV+QndskICGsho+ADou8ySMSjJKDIan90Nz0=
+github.com/rs/zerolog v1.34.0 h1:k43nTLIwcTVQAncfCw4KZ2VY6ukYoZaBPNOE8txlOeY=
+github.com/rs/zerolog v1.34.0/go.mod h1:bJsvje4Z08ROH4Nhs5iH600c3IkWhwp44iRc54W6wYQ=
+github.com/spf13/pflag v1.0.10 h1:4EBh2KAYBwaONj6b2Ye1GiHfwjqyROoF4RwYO+vPwFk=
+github.com/spf13/pflag v1.0.10/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/stretchr/testify v1.10.0 h1:Xv5erBjTwe/5IxqUQTdXv5kgmIvbHo3QQyRwhJsOfJA=
+github.com/stretchr/testify v1.10.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/valyala/bytebufferpool v1.0.0 h1:GqA5TC/0021Y/b9FG4Oi9Mr3q7XYx6KllzawFIhcdPw=
+github.com/valyala/bytebufferpool v1.0.0/go.mod h1:6bBcMArwyJ5K/AmCkWv1jt77kVWyCJ6HpOuEn7z0Csc=
+github.com/valyala/fasthttp v1.65.0 h1:j/u3uzFEGFfRxw79iYzJN+TteTJwbYkru9uDp3d0Yf8=
+github.com/valyala/fasthttp v1.65.0/go.mod h1:P/93/YkKPMsKSnATEeELUCkG8a7Y+k99uxNHVbKINr4=
+github.com/xyproto/randomstring v1.0.5 h1:YtlWPoRdgMu3NZtP45drfy1GKoojuR7hmRcnhZqKjWU=
+github.com/xyproto/randomstring v1.0.5/go.mod h1:rgmS5DeNXLivK7YprL0pY+lTuhNQW3iGxZ18UQApw/E=
+go.uber.org/automaxprocs v1.6.0 h1:O3y2/QNTOdbF+e/dpXNNW7Rx2hZ4sTIPyybbxyNqTUs=
+go.uber.org/automaxprocs v1.6.0/go.mod h1:ifeIMSnPZuznNm6jmdzmU3/bfk01Fe2fotchwEFJ8r8=
+go.uber.org/mock v0.5.2 h1:LbtPTcP8A5k9WPXj54PPPbjcI4Y6lhyOZXn+VS7wNko=
+go.uber.org/mock v0.5.2/go.mod h1:wLlUxC2vVTPTaE3UD51E0BGOAElKrILxhVSDYQLld5o=
+golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
+golang.org/x/crypto v0.0.0-20191011191535-87dc89f01550/go.mod h1:yigFU9vqHzYiE8UmvKecakEJjdnWj3jj499lnFckfCI=
+golang.org/x/crypto v0.41.0 h1:WKYxWedPGCTVVl5+WHSSrOBT0O8lx32+zxmHxijgXp4=
+golang.org/x/crypto v0.41.0/go.mod h1:pO5AFd7FA68rFak7rOAGVuygIISepHftHnr8dr6+sUc=
+golang.org/x/exp v0.0.0-20250506013437-ce4c2cf36ca6 h1:y5zboxd6LQAqYIhHnB48p0ByQ/GnQx2BE33L8BOHQkI=
+golang.org/x/exp v0.0.0-20250506013437-ce4c2cf36ca6/go.mod h1:U6Lno4MTRCDY+Ba7aCcauB9T60gsv5s4ralQzP72ZoQ=
+golang.org/x/lint v0.0.0-20200302205851-738671d3881b/go.mod h1:3xt1FjdF8hUf6vQPIChWIBhFzV8gjjsPE/fR3IyQdNY=
+golang.org/x/mod v0.1.1-0.20191105210325-c90efee705ee/go.mod h1:QqPTAvyqsEbceGzBzNggFXnrqF1CaUcvgkdR5Ot7KZg=
+golang.org/x/mod v0.26.0 h1:EGMPT//Ezu+ylkCijjPc+f4Aih7sZvaAr+O3EHBxvZg=
+golang.org/x/mod v0.26.0/go.mod h1:/j6NAhSk8iQ723BGAUyoAcn7SlD7s15Dp9Nd/SfeaFQ=
+golang.org/x/net v0.0.0-20190404232315-eb5bcb51f2a3/go.mod h1:t9HGtf8HONx5eT2rtn7q6eTqICYqUVnKs3thJo3Qplg=
+golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
+golang.org/x/net v0.43.0 h1:lat02VYK2j4aLzMzecihNvTlJNQUq316m2Mr9rnM6YE=
+golang.org/x/net v0.43.0/go.mod h1:vhO1fvI4dGsIjh73sWfUVjj3N7CA9WkKJNQm2svM6Jg=
+golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
+golang.org/x/sync v0.16.0 h1:ycBJEhp9p4vXvUZNszeOq0kGTPghopOL8q0fq3vstxw=
+golang.org/x/sync v0.16.0/go.mod h1:1dzgHSNfp02xaA81J2MS99Qcpr2w7fw1gpm99rleRqA=
+golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
+golang.org/x/sys v0.0.0-20190412213103-97732733099d/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
+golang.org/x/sys v0.0.0-20220811171246-fbc7d0a398ab/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.12.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
+golang.org/x/sys v0.35.0 h1:vz1N37gP5bs89s7He8XuIYXpyY0+QlsKmzipCbUtyxI=
+golang.org/x/sys v0.35.0/go.mod h1:BJP2sWEmIv4KK5OTEluFJCKSidICx8ciO85XgH3Ak8k=
+golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
+golang.org/x/text v0.28.0 h1:rhazDwis8INMIwQ4tpjLDzUhx6RlXqZNPEM0huQojng=
+golang.org/x/text v0.28.0/go.mod h1:U8nCwOR8jO/marOQ0QbDiOngZVEBB7MAiitBuMjXiNU=
+golang.org/x/tools v0.0.0-20200130002326-2f3ba24bd6e7/go.mod h1:TB2adYChydJhpapKDTa4BR/hXlZSLoq2Wpct/0txZ28=
+golang.org/x/tools v0.35.0 h1:mBffYraMEf7aa0sB+NuKnuCy8qI/9Bughn8dC2Gu5r0=
+golang.org/x/tools v0.35.0/go.mod h1:NKdj5HkL/73byiZSJjqJgKn3ep7KjFkBOkR/Hps3VPw=
+golang.org/x/xerrors v0.0.0-20191011141410-1b5146add898/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

masktunnel-0.1.0/masktunnel/__init__.py

@@ -0,0 +1,11 @@
+"""masktunnel: Python bindings for MaskTunnel (Go).
+
+This package provides a Python-friendly API on top of the generated native bindings.
+"""
+
+__version__ = "0.1.0"
+
+from ._server import Server
+from ._utils import set_log_level
+
+__all__ = ["Server", "set_log_level"]

masktunnel-0.1.0/masktunnel/_server.py

@@ -0,0 +1,86 @@
+from __future__ import annotations
+
+import asyncio
+import logging
+from dataclasses import dataclass
+from typing import Optional
+
+# Underlying Go bindings module (generated by gopy)
+from masktunnellib import masktunnel as gomasktunnel  # type: ignore
+
+from ._utils import _logger
+
+
+@dataclass
+class ServerOptions:
+    addr: str = ""
+    port: str = "8080"
+    user_agent: str = ""
+    payload: str = ""
+    upstream_proxy: str = ""
+    username: str = ""
+    password: str = ""
+    verbose: int = 0
+
+
+class Server:
+    """MaskTunnel proxy server.
+
+    Notes:
+        - `start()` is blocking, so typical usage is `asyncio.to_thread(server.start)`.
+        - Use `stop()` to shutdown.
+    """
+
+    def __init__(self, *, options: Optional[ServerOptions] = None, logger: Optional[logging.Logger] = None) -> None:
+        if logger is None:
+            logger = _logger
+        self._logger = logger
+
+        if options is None:
+            opt = gomasktunnel.DefaultServerOption()
+        else:
+            opt = gomasktunnel.DefaultServerOption()
+            opt.Addr = options.addr
+            opt.Port = options.port
+            opt.UserAgent = options.user_agent
+            opt.Payload = options.payload
+            opt.UpstreamProxy = options.upstream_proxy
+            opt.Username = options.username
+            opt.Password = options.password
+            opt.Verbose = int(options.verbose)
+
+        self._raw = gomasktunnel.NewServerHandle(opt)
+
+    @property
+    def addr(self) -> str:
+        return self._raw.Addr()
+
+    def start(self) -> None:
+        self._raw.Start()
+
+    async def async_start(self) -> None:
+        await asyncio.to_thread(self._raw.Start)
+
+    def stop(self) -> None:
+        self._raw.Stop()
+
+    async def async_stop(self) -> None:
+        await asyncio.to_thread(self._raw.Stop)
+
+    def reset_sessions(self) -> int:
+        return int(self._raw.ResetSessions())
+
+    def set_upstream_proxy(self, proxy_url: str) -> None:
+        self._raw.SetUpstreamProxy(proxy_url)
+
+    def get_ca_pem(self) -> bytes:
+        return bytes(self._raw.GetCAPEM() or b"")
+
+    def close(self) -> None:
+        try:
+            self._raw.Close()
+        except Exception:
+            pass
+
+    async def async_close(self) -> None:
+        await asyncio.to_thread(self.close)

masktunnel-0.1.0/masktunnel/_utils.py

@@ -0,0 +1,15 @@
+from __future__ import annotations
+
+import logging
+
+
+_logger = logging.getLogger("masktunnel")
+
+
+def set_log_level(level: int) -> None:
+    """Set python-side log level.
+
+    Go-side logging is currently controlled by the Go application.
+    This helper only adjusts the default Python logger used by the wrappers.
+    """
+    _logger.setLevel(level)

masktunnel-0.1.0/masktunnel.egg-info/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: masktunnel
+Version: 0.1.0
+Summary: Python bindings for MaskTunnel (Go)
+Home-page: https://github.com/cloudflyer-project/masktunnel
+Author: cloudflyer-project
+License: GPL-3.0
+Platform: any
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: setuptools>=40.0
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: wheel; extra == "dev"
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: platform
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# masktunnel (Python bindings)
+
+This directory contains the Python package that wraps MaskTunnel's Go implementation via gopy.
+
+- Package name: `masktunnel`
+- Native module directory (generated at build time): `masktunnellib/`
+
+Build notes:
+
+- Building from source requires Go and a C toolchain.
+- Wheels are produced by CI for common platforms.

masktunnel-0.1.0/masktunnel.egg-info/SOURCES.txt

@@ -0,0 +1,27 @@
+MANIFEST.in
+README.md
+go.mod
+go.sum
+setup.py
+masktunnel/__init__.py
+masktunnel/_server.py
+masktunnel/_utils.py
+masktunnel.egg-info/PKG-INFO
+masktunnel.egg-info/SOURCES.txt
+masktunnel.egg-info/dependency_links.txt
+masktunnel.egg-info/not-zip-safe
+masktunnel.egg-info/requires.txt
+masktunnel.egg-info/top_level.txt
+masktunnel_go/_python.go
+masktunnel_go/basic.go
+masktunnel_go/bindings.go
+masktunnel_go/config.go
+masktunnel_go/encoding.go
+masktunnel_go/generator.go
+masktunnel_go/manager.go
+masktunnel_go/mitm.go
+masktunnel_go/payload.go
+masktunnel_go/python.go
+masktunnel_go/server.go
+masktunnel_go/ua_parser.go
+tests/test_server.py

masktunnel-0.1.0/masktunnel.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

masktunnel-0.1.0/masktunnel.egg-info/not-zip-safe

@@ -0,0 +1 @@
+

masktunnel-0.1.0/masktunnel.egg-info/requires.txt

@@ -0,0 +1,7 @@
+setuptools>=40.0
+
+[dev]
+pytest>=6.0
+pytest-xdist
+build
+wheel

masktunnel-0.1.0/masktunnel.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+masktunnel
+masktunnellib

masktunnel-0.1.0/masktunnel_go/_python.go

@@ -0,0 +1,81 @@
+package masktunnel
+
+import (
+	"context"
+	"sync"
+	"time"
+)
+
+// This file provides small, gopy-friendly helpers for Python bindings.
+
+// ========== Context helpers ==========
+
+var (
+	globalCtx    context.Context
+	globalCancel context.CancelFunc
+	globalOnce   sync.Once
+)
+
+// Background returns a process-wide background context.
+func Background() context.Context {
+	globalOnce.Do(func() {
+		globalCtx, globalCancel = context.WithCancel(context.Background())
+	})
+	return globalCtx
+}
+
+// ContextWithCancel wraps a context and its cancel function.
+type ContextWithCancel struct {
+	ctx    context.Context
+	cancel context.CancelFunc
+}
+
+// NewContextWithCancel creates a new cancellable context.
+func NewContextWithCancel() *ContextWithCancel {
+	ctx, cancel := context.WithCancel(context.Background())
+	return &ContextWithCancel{ctx: ctx, cancel: cancel}
+}
+
+// Cancel cancels the underlying context.
+func (c *ContextWithCancel) Cancel() {
+	if c != nil && c.cancel != nil {
+		c.cancel()
+	}
+}
+
+// Context returns the underlying context.
+func (c *ContextWithCancel) Context() context.Context {
+	if c == nil {
+		return context.Background()
+	}
+	return c.ctx
+}
+
+// CancelGlobalContext cancels the global background context.
+func CancelGlobalContext() {
+	if globalCancel != nil {
+		globalCancel()
+	}
+}
+
+// NewContext returns a new background-derived context.
+func NewContext() context.Context {
+	ctx, _ := context.WithCancel(context.Background())
+	return ctx
+}
+
+// ========== Time constants ==========
+
+var (
+	Nanosecond  = time.Nanosecond
+	Microsecond = time.Microsecond
+	Millisecond = time.Millisecond
+	Second      = time.Second
+	Minute      = time.Minute
+	Hour        = time.Hour
+)
+
+// ParseDuration parses a duration string (e.g. "300ms", "2h45m").
+func ParseDuration(s string) (time.Duration, error) {
+	return time.ParseDuration(s)
+}

masktunnel-0.1.0/masktunnel_go/basic.go

@@ -0,0 +1,77 @@
+package masktunnel
+
+import (
+	"encoding/base64"
+	"net/http"
+	"strings"
+)
+
+// BasicAuth handles HTTP Basic Authentication for proxy
+type BasicAuth struct {
+	username string
+	password string
+	enabled  bool
+}
+
+// NewBasicAuth creates a new basic auth handler
+func NewBasicAuth(username, password string) *BasicAuth {
+	return &BasicAuth{
+		username: username,
+		password: password,
+		enabled:  username != "" || password != "",
+	}
+}
+
+// IsEnabled returns true if authentication is enabled
+func (ba *BasicAuth) IsEnabled() bool {
+	return ba.enabled
+}
+
+// Validate validates the proxy authentication from request
+func (ba *BasicAuth) Validate(req *http.Request) bool {
+	if !ba.enabled {
+		return true
+	}
+
+	authHeader := req.Header.Get("Proxy-Authorization")
+	if authHeader == "" {
+		return false
+	}
+
+	if !strings.HasPrefix(authHeader, "Basic ") {
+		return false
+	}
+
+	encoded := authHeader[6:] // Remove "Basic " prefix
+	decoded, err := base64.StdEncoding.DecodeString(encoded)
+	if err != nil {
+		return false
+	}
+
+	credentials := string(decoded)
+	parts := strings.SplitN(credentials, ":", 2)
+	if len(parts) != 2 {
+		return false
+	}
+
+	return parts[0] == ba.username && parts[1] == ba.password
+}
+
+// GetAuthRequiredResponse returns HTTP 407 response for auth required
+func (ba *BasicAuth) GetAuthRequiredResponse() *http.Response {
+	resp := &http.Response{
+		StatusCode:    http.StatusProxyAuthRequired,
+		Status:        "407 Proxy Authentication Required",
+		Proto:         "HTTP/1.1",
+		ProtoMajor:    1,
+		ProtoMinor:    1,
+		Header:        make(http.Header),
+		Body:          http.NoBody,
+		ContentLength: 0,
+	}
+
+	resp.Header.Set("Proxy-Authenticate", "Basic realm=\"MaskTunnel Proxy\"")
+	resp.Header.Set("Content-Type", "text/plain")
+
+	return resp
+}